MetaAds

MetaAds コネクタを使用すると、Meta / Facebook 広告データに接続し、データに対して作成、読み取り、更新、削除のオペレーションを実行できます。

始める前に

Meta Ads コネクタを使用する前に、次の作業を行います。

  • Google Cloud プロジェクトで次の操作を行います。
    • ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、Network Connectivity をご覧ください。
    • コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
    • コネクタに使用するサービス アカウントに、次の IAM ロールを付与します。
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      サービス アカウントは特別なタイプの Google アカウントで、Google API のデータにアクセスするのに認証を受ける必要がある人間以外のユーザーを表します。サービス アカウントがない場合は、サービス アカウントを作成する必要があります。詳細については、サービス アカウントを作成するをご覧ください。

    • 次のサービスを有効にします。
      • secretmanager.googleapis.com(Secret Manager API)
      • connectors.googleapis.com(Connectors API)

      サービスを有効にする方法については、サービスを有効にするをご覧ください。

    以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。

コネクタを構成する

コネクタを構成するには、データソース(バックエンド システム)への接続を作成する必要があります。接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

  1. Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。

    [接続] ページに移動

  2. [+ 新規作成] をクリックして [接続の作成] ページを開きます。
  3. [ロケーション] セクションで、接続のロケーションを選択します。
    1. リージョン: プルダウン リストからロケーションを選択します

      コネクタをサポートしているリージョンは次のとおりです。

      サポートされているすべてのリージョンの一覧については、ロケーションをご覧ください。

    2. [次へ] をクリックします。
  4. [接続の詳細] セクションで、次の操作を行います。
    1. コネクタ: 使用可能なコネクタのプルダウン リストから [Meta Ads] を選択します。
    2. コネクタのバージョン: 使用可能なバージョンのプルダウン リストからコネクタのバージョンを選択します。
    3. [接続名] フィールドに、接続インスタンスの名前を入力します。

      接続名は次の条件を満たす必要があります。

      • 接続名には英字、数字、ハイフンを使用できます。
      • 文字は小文字のみを使用できます。
      • 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
      • 接続名は 49 文字以内で指定してください。
    4. 必要に応じて、接続インスタンスの [説明] を入力します。
    5. サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
    6. 必要に応じて、接続ノードの設定を構成します。

      • ノードの最小数: 接続ノードの最小数を入力します。
      • ノードの最大数: 接続ノードの最大数を入力します。

      ノードは、トランザクションを処理する接続の単位(またはレプリカ)です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され(可用性を高めるため)、最大ノード数は 50 に設定されます。

    7. アカウント ID: 広告アカウントの ID。指定しない場合、Facebook 広告から返された最初の広告アカウント ID が使用されます。
    8. 集計形式: 集計列またはコレクション列が返される形式。
    9. ページとして認証: Facebook へのリクエスト時に認証するページの名前または ID。
    10. 再試行レベル: ドライバが再試行時に結果の取得を試みる、最も詳細な広告オブジェクト レベル。
    11. ターゲット: ターゲットが指定されていない場合のデフォルトのターゲット。ターゲットを指定できるテーブル(コメントなど)に使用されます。
    12. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
    13. [次へ] をクリックします。
  5. [認証] セクションで、認証の詳細を入力します。
    1. [認証タイプ] を選択し、関連する詳細を入力します。

      Meta Ads 接続でサポートされる認証タイプは次のとおりです。

      • OAuth 2.0 認証コード付与
    2. これらの認証タイプの構成方法については、認証を構成するをご覧ください。

    3. [次へ] をクリックします。
  6. Review: 接続と認証の詳細を確認します。
  7. [作成] をクリックします。

認証を構成する

使用する認証に基づいて詳細を入力します。

  • OAuth 2.0 認証コード付与
    • アクセス トークン: auth-code-flow-based 接続でリクエストを認証するために使用されるアクセス トークン。
    • クライアント ID: 作成したアプリに対してコネクタから提供されたクライアント ID。
    • クライアント シークレット: 作成した接続されているアプリのクライアント シークレットを含む Secret Manager のシークレットです。

Meta 広告の設定

Meta 広告と統合するアプリを作成するには、次のタスクを完了します。

  • Meta アプリ アカウントを設定、作成する
  • OAuth2.0 クライアント認証を設定する
  • スコープの詳細を設定する
  • リダイレクト URL を設定する

Meta アプリ アカウントを設定、作成する

  1. Facebook ビジネス マネージャーに移動します。
  2. [アカウントを作成] をクリックし、ビジネスの詳細を入力してアカウントを作成します。
  3. 設定プロセス中に本人確認とビジネス情報の確認を行います。
  4. ビジネス マネージャー アカウントを設定したら、ビジネス設定に移動し、メニューの [ページ] をクリックします。
  5. [追加] をクリックし、[ページを追加] を選択します。表示される手順に沿って、Facebook ページをビジネス マネージャー アカウントに追加します。
  6. ビジネス設定のメニューで [アカウントを追加] をクリックします。[追加] をクリックし、[広告アカウントを追加] を選択します。
  7. 既存の広告アカウントを使用することも、新しいアカウントを作成することもできます。

  8. ビジネス設定で [お支払い方法] をクリックします。
  9. [追加] をクリックして、クレジット カードや PayPal アカウントなどのお支払い方法を追加します。その他の画面の指示に沿ってお支払い情報を入力します。
  10. [ユーザーを追加] をクリックし、ビジネス マネージャー アカウントへのアクセス権を付与するユーザーのメールアドレスを入力します。各ユーザーの責任に基づいて、適切なロールと権限を割り当てます。
  11. 広告管理ツールに移動し、ビジネス マネージャーのメニューアイコンをクリックして [広告管理ツール] を選択します。[作成] をクリックして広告キャンペーンを作成します。
  12. 画面の指示に沿って、キャンペーン目標、ターゲット オーディエンス、広告フォーマット、予算、スケジュールを定義します。
  13. 作成した広告をアップロードし、詳細を確認してから、広告キャンペーンを審査に送信します。
  14. 広告キャンペーンを公開したら、Google 広告マネージャーでキャンペーンとそのパフォーマンスをモニタリングします。リーチ、エンゲージメント、コンバージョン率などの主な指標を分析します。必要に応じてキャンペーンを調整し、パフォーマンスを最適化して広告掲載の目標を達成します。
  15. 個人の Facebook アカウントでログインするか、アカウントをお持ちでない場合は新規に登録します。Facebook デベロッパーにログインします。
  16. [マイアプリ] プルダウン メニューをクリックし、[アプリを作成] を選択します。
  17. アプリのプラットフォーム(iOS、Android、ウェブなど)を選択します。
  18. アプリの名前、メールアドレス、カテゴリなどの基本情報を入力します。
  19. [Create App ID] をクリックして、必要な情報を入力した後、アプリの一意の ID を生成します。
  20. アプリの追加設定を構成します。たとえば、iOS バンドル ID、Android パッケージ名などのプラットフォーム固有の詳細情報を追加したり、アプリのドメインとプライバシー ポリシーの URL を設定したりします。
  21. アプリに統合する Facebook プロダクト(Facebook ログイン、アナリティクス、広告など)を選択します。
  22. 手順に沿って開発環境を設定し、Facebook SDK をアプリコードに統合します。
  23. アプリの設定が完了したら、Facebook のデベロッパー ツールとリソースを使用して、機能の構築とテストを開始します。
  24. アプリの作成については、アプリを作成するをご覧ください。

OAuth2.0 クライアント認証の詳細を設定する

  1. Facebook の認証情報を使用して Meta for developers に移動します。
  2. [マイアプリ] をクリックし、[アプリ] タブを選択して、前に作成したメタアプリを選択します。
  3. [アプリの設定] > [基本] をクリックします。
  4. クライアント シークレットであるアプリ シークレットを表示します。[表示] をクリックし、アカウント パスワードを入力して、コピーして保存します。
  5. [アプリの設定] > [詳細] をクリックします。クライアント トークン(クライアント ID)を見つけます。必要に応じてリセットできます。

スコープの詳細を設定する

Meta 広告コネクタのスコープは ads_management です。

リダイレクト URL の詳細を設定する

  1. Facebook の認証情報を使用して Meta for developers に移動します。
  2. [アプリ] タブをクリックし、前に作成したメタアプリを選択します。
  3. Facebook の [ログイン > 設定] をクリックします。
  4. 生成されたリダイレクト URL を [Valid OAuth Redirect URIs] に貼り付け、その他の必須項目に詳細を入力します。

接続構成のサンプル

このセクションでは、Meta 広告接続を作成するときに構成するさまざまなフィールドのサンプル値を示します。

Meta 広告のウェブ接続のタイプ

フィールド名 詳細
場所 us-central1
コネクタ facebookads
コネクタのバージョン 1
接続名 google-cloud-meta-ads-conn
サービス アカウント SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
ノードの最小数 2
ノードの最大数 50
クライアント ID CLIENT_ID
スコープ ads_management
クライアント シークレット CLIENT_SECRET
シークレットのバージョン 2

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

  • エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベース コネクタでは、テーブルがエンティティであり、ファイル サーバー コネクタでは、フォルダがエンティティです。また、メッセージング システム コネクタでは、キューがエンティティです。

    ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。

  • オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。

    使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティ オペレーションをご覧ください。ただし、コネクタがいずれかのエンティティ オペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。

  • アクション: コネクタ インターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

システムの上限

MetaAds コネクタは、ノードごとに 1 秒あたり 6 件のトランザクションを処理することができ、この上限を超えるトランザクションはすべてスロットルされます。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます(可用性を高めるため)。

Integration Connectors に適用される上限の詳細については、上限をご覧ください。

アクション

このセクションには、コネクタでサポートされているアクションが一覧表示されます。アクションの構成方法については、アクションの例をご覧ください。

CreateAdPreview アクション

アプリ分析情報のスキーマ ファイルを作成します。

CreateAdPreview アクションの入力パラメータ

パラメータ名 データ型 必須 説明
AdFormat 文字列 True 使用する広告のフォーマット。使用できる値は、AUDIENCE_NETWORK_INSTREAM_VIDEO、AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE、AUDIENCE_NETWORK_OUTSTREAM_VIDEO、AUDIENCE_NETWORK_REWARDED_VIDEO、DESKTOP_FEED_STANDARD、FACEBOOK_STORY_MOBILE、INSTAGRAM_STANDARD, INSTAGRAM_STORY、INSTANT_ARTICLE_STANDARD、INSTREAM_VIDEO_DESKTOP、INSTREAM_VIDEO_MOBILE、MARKETPLACE_MOBILE、MESSENGER_MOBILE_INBOX_MEDIA、MOBILE_BANNER, MOBILE_FEED_BASIC、MOBILE_FEED_STANDARD、MOBILE_FULLWIDTH、MOBILE_INTERSTITIAL、MOBILE_MEDIUM_RECTANGLE, MOBILE_NATIVE、RIGHT_COLUMN_STANDARD、SUGGESTED_VIDEO_DESKTOP、SUGGESTED_VIDEO_MOBILE、WATCH_FEED_MOBILE。
AdCreativeId 文字列 True プレビューの作成に使用する広告クリエイティブの ID。

CreateAdPreview アクションの構成方法の例については、アクションの例をご覧ください。

アクションの例

このセクションでは、このコネクタでいくつかのアクションを実行する方法について説明します。

例 - 広告プレビューを作成する

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CreateAdPreview] アクションを選択してから、[完了] をクリックします。
  3. [データ マッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
    {
    "AdCreativeId": "120208552947120478",
    "AdFormat": "AUDIENCE_NETWORK_INSTREAM_VIDEO"
    }
  4. アクションが成功すると、CreateAdPreview タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
      "Url": "https://business.facebook.com/ads/api/preview_iframe.php?d=AQL_quk8kLm_6z2oZ14q9A0led9llzr981NPv-zUHhwZ5IXjO07s7ngrI2y0qI0VZCRH2w9hgCwy5xrbFQlWCy0g-uRpRHvFS0dS0erj2Lg4HI7ZfIRm8h3nZLhJygM",
      "@affectedrows": null
    }, {
      "Url": null,
      "@affectedrows": null
    }]

エンティティ オペレーションの例

このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。

例 - すべての広告アカウントを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から AdAccounts を選択します。
  3. [List] オペレーションを選択してから、[完了] をクリックします。

例 - すべてのキャンペーンを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Campaigns を選択します。
  3. [List] オペレーションを選択してから、[完了] をクリックします。
  4. 必要に応じて、コネクタタスクの [タスク入力] セクションでフィルタ句を指定して、結果セットをフィルタリングできます。 フィルタ句の値は、常に単一引用符(')内で指定します。

例 - 広告セットを取得する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Adsets を選択します。
  3. [Get] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで [EntityId] をクリックし、[デフォルト値] フィールドに 120206747969710053 を入力します。

    ここで、120206747969710053User エンティティ内の一意のレコード ID です。

統合で MetaAds 接続を使用する

接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。

  • Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
  • Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

次のステップ