Google Ads

Google Ads はコネクタです。MeDo アプリを 1 つの Google Ads アカウントに接続し、アクセス可能な顧客の一覧、パフォーマンスレポートの参照、キャンペーンの検索、確認後の一時停止下書き作成、キャンペーンの一時停止／有効化を可能にします。アプリが見られるのは、接続したアカウントが見られる範囲だけです。

#作れるもの

• パフォーマンスダッシュボード。 オーナーがアクセスできる顧客を一覧し、明示した期間の顧客／キャンペーン／広告／キーワード指標を表示します。
• マネージャーアカウントの選択画面。 マネージャー（MCC）配下の子アカウントを一覧し、マネージャー自身ではなく 1 つのクライアントアカウントでレポートを開きます。
• キャンペーン確認ページ。 ID または正確な名前で 1 件を検索し、確認後に一時停止または有効化します。
• ローンチ用ワークスペース。 日次予算、広告グループ、広告文、地域、コンバージョンアクション付きの一時停止 Search キャンペーンをプレビューし、確認後にだけ作成します。

オーナーの実際の広告アカウントが必要なアプリに向いています。口座開設ツールでも入札エンジンでもなく、訪問者ごとの Ads ログインにもなりません。詳しくは制限をご覧ください。

#ビルド例

次のいずれかをプロンプト欄に貼り付けてください。最初の例が最小の出発点です。

Use @Google Ads to build a private website console that lists my accessible customers, then shows an account report for a selected customer and date range.

Use @Google Ads to build a private manager console that lists sub-accounts under my MCC and shows a campaign report for one client account.

Use @Google Ads to build a private campaign review page where I look up one campaign by ID or name and pause or enable it only after I confirm.

Use @Google Ads to build a private launch workspace that creates a paused Search campaign with a daily budget on my client account after I confirm the name and amount.

書き方で結果が変わります。「アカウントオーナー向けの非公開広告コンソール」と「キャンペーンを一覧するページ」では、まったく別のアプリが生成されます。

#準備と接続

アプリが使う Ads アカウントをすでに開ける Google アカウントが必要です。API キー、Google Cloud プロジェクト、課金設定は不要です。MeDo は新しい Ads アカウントの作成、支払いの紐付け、広告主確認の代行はできません。

1. サイドバーの Skills & Connectors（スキルとコネクタ） を開き、Google Ads を検索します。
2. Google Ads のカードを開き、Connect（接続） をクリックします。
3. Google アカウントにサインインし、MeDo が求めるアクセスを許可します。Customer ID を求められることもあります。マネージャーがあれば MCC、なければクライアントアカウント ID を使います。
4. ボタンが Connected（接続済み） に変われば成功です。アプリ側に何かを貼り付ける必要はありません。

接続前にビルドを始めると、MeDo が気づいて返信の下に Google Ads の接続ボタンを出します。そちらでも接続できます。ボタンが出ない場合は、上記のコネクタカードを使ってください。

#アプリでの使い方

• アプリは作成者が接続した Google Ads アカウントを使い、訪問者ごとの Ads アカウントではありません。 アカウントやレポートを見られる訪問者は、同じ接続を見ます。これらのページはアプリ自身のサインインの後ろに置き、権限のある人だけに制限してください。「private」というタイトルだけではアクセス制御になりません。
• レポートと書き込みはクライアントアカウントに対して行います。 マネージャー（MCC）ID は子アカウントの一覧用です。マネージャー ID に支出、クリック、キャンペーン変更を送ると失敗します。コネクタが返す customer ID をコピーし、ID を捏造しないでください。
• アクセス可能な顧客一覧は MCC ツリー全体ではありません。 Google ユーザーが直接開けるアカウントだけです。マネージャー配下の子を選ぶときは、先にサブアカウントを一覧します。
• レポートには明示した期間が必要です。 キーワードや広告の行が空なのは、その期間に対象がないことがほとんどで、接続失敗ではありません。
• 書き込みは先に確認し、自動再実行しません。 MeDo は顧客、名前、予算、ステータス、広告文、地域をプレビューし、明示確認を待ちます。結果が不明なら、先にアカウントを読み直してください。再実行すると、キャンペーン、予算、広告、コンバージョンアクションが二重に増えます。
• 新しい Search キャンペーン、広告グループ、レスポンシブ検索広告は一時停止で作られます。 有効化は別の確認手順です。
• アプリ固有のメモはアプリに残します。 ローンチチェックリスト、レビュー状態、コメントは、実際の顧客、キャンペーン、予算、広告グループ ID をキーにしてアプリのテーブルに保存します。Google Ads のフィールドではありません。

#制限とトラブルシューティング

アプリに「Connection required」と出る。 Google Ads 接続はアプリオーナーのものです。オーナーにコネクタカードを開いて Connect を押してもらい、再読み込みしてください。

レポートや書き込みがマネージャー向けだと返る。 サブアカウント一覧のクライアント customer ID に切り替えてください。MCC にレポートやキャンペーン変更を送らないでください。

書き込み結果が不明。 もう一度押さないでください。先に名前または ID でキャンペーンやコンバージョンを検索します。

訪問者に見せたくない広告データが見えている。 接続は共有です。アプリにサインインとサーバー側の制限を追加してください。アクセスとロールの管理をご覧ください。

#関連ページ

• コネクタカタログ — 他のコネクタと用途。
• スキルとコネクタ — スキルの呼び出し、料金、制限。
• サインインとユーザーの管理 — 接続データを出す前に、アプリ自身のアカウントを用意する。