Apple Ads と Google Drive を Hermoso に接続すると、どちらも同じエージェントから呼び出せるようになります。apple_ads_report がパフォーマンスの行を取得し、create_sheet と append_to_sheet がそれをご自身のスプレッドシートに入れます。書き出しファイルも、データウェアハウスも、認証情報を預かる3つ目のツールも必要ありません。
実際の使い方
「先週の Apple Search Ads の費用をキーワード別に取得して、私の Apple Ads シートに追加して。」 エージェントがレポートを呼び出し、行を整えて追加します。翌週も同じように頼めば、シートは1週間分ずつ伸びていきます。
Hermoso が要求する Drive のスコープは drive.file で、Hermoso が作成したファイルと、ご自身が選んだファイルにだけ届きます。Drive 全体には届きません。
Apple Search Ads を Google スプレッドシートに接続する方法
- 両方のアカウントを接続します。 アプリでコネクターを開き、Apple Ads、次に Google Drive を接続します。Sheets と Docs は同じ Google の認証を使うため、同意画面は3つではなく1つです。Apple Ads は、ボタンを押すだけの接続ではなく鍵の受け渡しです。Apple Search Ads のセットアップガイドに、Claude または ChatGPT への接続も含めて手順があります。依頼を入力するのはそちらです。
- 最初の取得を頼みます。 「過去30日間の Apple Search Ads のパフォーマンスをキャンペーン別に取得して、『Apple Ads』という名前の新しいシートに入れて。」 エージェントが
apple_ads_reportを呼び出し、次にcreate_sheetを呼び出して、シートのリンクを返します。 - 定期実行にします。 同じ依頼を「新しいシート」ではなく「追加して」にし、お使いのクライアント (Claude や ChatGPT のスケジュールされたタスク、または Hermoso CLI を呼び出す cron ジョブ) から定期的に実行します。実行のたびに行が追加されます。頼まない限り、何も上書きされません。
- ダッシュボードをシートに向けます。 Looker Studio、Power BI、Tableau はいずれも、それぞれのコネクターで Google スプレッドシートを読み込めます。
シートの見た目
1行が、エンティティ1つと期間1つに対応します。列はお求めのレベル (キャンペーン、広告グループ、広告、キーワード、検索語句) に従い、Apple が報告する指標 (インプレッション、タップ、インストール、費用、タップ率、タップ単価、CPA) が加わります。日単位の粒度を指定すると、エンティティごとに1日1行になります。合計を指定すると、1行になります。エージェントは総計の行を追加できます。App Store のレポートでは、配信のないエンティティも残せるため、一時停止中のキーワードは消えずにゼロとして表示されます。
エージェントは書き込む前に行を整えるため、必要なシートをそのまま指定できます。たとえば、費用が一定額を超えるキーワードだけ、キャンペーン名とその ID を並べて、週ごとの変化を書き込む前に計算しておく、といった依頼ができます。CSV の書き出しでは、それらの作業はすべてご自身で行う必要があります。
追加、置き換え、書式設定
Sheets のツールで、編集の全体をカバーできます。append_to_sheet は行を追加し、update_sheet は範囲をその場で書き込み、clear_sheet_range は、追加ではなく置き換えたいときに先にその範囲を空にします。format_sheet はヘッダー、列幅、数値の形式を扱い、manage_sheet_tabs は、キャンペーンごとや月ごとに別のタブを用意します。「ダッシュボード用のシートを更新して」という依頼は、指定されたタブの内容を消去してから書き込む、という操作になります。
シートから Apple Search Ads を Looker Studio に書き出す
Hermoso には Looker Studio のネイティブ コネクターがありません。シートが橋渡し役になります。Looker Studio でデータソースを作成し、Google スプレッドシートを選んで、エージェントが追加先にしているスプレッドシートとタブを指定します。レポートは一度作れば、そのまま使えます。追加されるたびに、ダッシュボードの次回のデータ更新で反映されます。ただし、列のヘッダーが実行ごとに同じであることが条件です。同じパターンは Power BI と Tableau でも使えます。
シートではなく JSON が必要ですか？
同じレポートは、Hermoso API (POST /v1/tools/apple_ads_report) または CLI から、生の JSON として取得できます。Apple Search Ads を JSON に書き出すと、Apple Search Ads のデータをエクスポートするには、そのほかのすべての送り先が載っています。
よくある質問
Apple Search Ads を Google スプレッドシートに接続するにはどうすればよいですか？
Hermoso で Apple Ads と Google Drive を接続してから、レポートをシートに入れるようエージェントに頼んでください。エージェントは apple_ads_report で行を取得し、create_sheet または append_to_sheet で書き込み、リンクを返します。
Hermoso は、Google ドライブ全体へのアクセスが必要ですか？
いいえ。要求するのは drive.file で、これは Hermoso が作成したファイルと、ご自身が明示的に選んだファイルをカバーします。
どのレベルと指標をシートに入れられますか？
キャンペーン、広告グループ、広告、キーワード、検索語句のレベルで、インプレッション、タップ、インストール、費用、タップ率、タップ単価、CPA を含められます。合計として、または時間、日、週、月ごとの系列として取得できます。
定期レポートが私のシートを上書きしますか？
ご自身が頼まない限り、上書きはしません。追加は行を加えるだけです。置き換えは、指定したタブの内容を消去してから書き込むことで、依頼に置き換えと書かれている場合だけエージェントが行います。
Looker Studio や Power BI で結果を読み込めますか？
はい。Hermoso には両方のネイティブ コネクターはありませんが、どちらも Google スプレッドシートを独自のコネクターで読み込めます。そのため、そのシートをもとにしたダッシュボードは、エージェントがシートに追加するたびに更新されます。
レポートをスケジュールで実行できますか？
はい。エージェントを動かしているクライアントでスケジュールできます。Claude や ChatGPT のスケジュールされたタスク、または Hermoso CLI や API を呼び出す cron ジョブです。実行のたびに、新しい期間を取得して追加します。