ビジネス間のMetaピクセルの共有

ビジネス(通常は広告会社)が別のビジネスのピクセルデータセットにアクセスするには、広告の管理、パフォーマンスの分析、イベントのアップロードなど、複数の事例が考えられます。

ピクセルと広告会社との関係を確立するために必要なAPI統合について以下に説明します。受け取り側(広告会社)のビジネスがクライアントの広告を管理しており、広告アカウントにそのピクセルを使用する必要がある場合は、ステップ3をご覧ください。

前提条件: アプリの要件

アプリには広告管理スタンダードアクセス(アドバンスアクセス)機能が必要です。また、アプリは以下の権限を有している必要があります。

• business_management
• ads_managementまたはads_read とmanage_pages

ステップ1: 広告会社とのピクセル共有を開始する

開始するには、ピクセルを所有するビジネスの管理者から、上記のアプリ権限を持つユーザーアクセストークンを受け取る必要があります。

POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]

このリクエストのオプションとパラメーターを以下に示します。

リクエストの処理方法は、相手のビジネスとの関係がどのような状況にあるかに応じて変わります。

• 既に承認された関係を有するビジネス。直接そのビジネスとピクセルを共有します。
• 進行中の関係を有するビジネス。ピクセルをリクエストに追加し、受け取り側のビジネスがこのリクエストを承認すると、ピクセルを共有します。
• 関係が一切ないビジネス。ピクセルが添付された共有同意書を作成し、受け取り側のビジネスがこのリクエストを承認した後で、そのビジネスとピクセルを共有します。

ピクセルが正常にビジネスと共有された場合、以下の応答が返されます。

{  
    success: true,
}
    

リクエストが共有同意書の承認待ちの場合、APIリクエストは、pending_request_idで以下の応答を返します。相手がリクエストを承認すると、ピクセルは自動的に受け取り側のビジネスと共有されます。リクエストを承認または却下するにはステップ2をご覧ください。

{
  "success": true,
  "pending_request_id": "{request_id}"
}
      

ステップ2: 処理待ちのリクエストを承認する(必要な場合)

ピクセル共有のリクエストを開始した後、ピクセルを所有するビジネスと広告会社との間に既存関係がない場合は、広告会社が処理待ちの共有同意書リクエストを受け取ることになります。受け取り側のビジネスの管理者は、ビジネスマネージャでこのリクエストを確認し承認することができます。

APIを通じてこの関係リクエストを承認または却下するには、ステップ1のエラー応答からrequest_idを取得します。

APIは、アプリのbusiness_mangementまたはads_management permissionを有するユーザーアクセストークンを、受け取り側のビジネスの管理者から取得する必要があります。

POST <request_id>?request_status="approve"

正常に行われると、APIはこの応答を返します。

{  
    success: bool
}

このリクエストのオプションとパラメーターを以下に示します。

ステップ3: 広告会社の広告アカウントとピクセルを共有する

広告会社がクライアントの広告を管理し、クライアント専用の広告アカウントでピクセルデータセットを使用できるようにする必要がある場合は、このAPIを使用します。

広告掲載/分析の権限を持つビジネスにピクセルが共有されると、そのビジネス内で、広告アカウントがピクセルデータセットを広告に使用することを許可することができます。

APIは、business_management、ads_managementまたはads_readのアクセス許可のあるユーザーアクセストークンをビジネスの管理者から取得する必要があります。

Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>

ステップ4: ピクセル共有を削除する

ピクセルと広告会社との連携が不要になった場合、以下のAPIを使って連携を削除します。

Delete <adspixel>/agencies?business=<agency_business_id>

APIは、ピクセルを所有するビジネスから管理者ユーザーアクセストークンを取得する必要があります。

正常に行われると、APIはこの応答を返します。

{  
    success: true
}

詳しくはこちら

• 新規イベントマネージャのエクスペリエンス(ビジネスヘルプセンター)
• データセットの概要(ビジネスヘルプセンター)
• アプリをデータセットにリンクする方法(ビジネスヘルプセンター)