パートナープレミアムオプション

プレミアムオプションが提供する独自のターゲット設定とインサイト発見機能により、Metaのコラボレーション広告ソリューションを利用する小売店とブランド間で、より強力なパートナーシップが構築されます。小売店は、プレミアムオプションを通じて、ブランドパートナーに対してコラボレーション広告のアドオンを提供できます。

利用可能な設定

カテゴリのターゲット設定

拡大オーディエンスのリターゲティングを使用することで、ブランドと広告主はカテゴリレベルのオーディエンスを広告のターゲットに設定できます。カテゴリレベルのオーディエンスは、ブランドの商品と同じカテゴリに属する商品を閲覧した人やカートに追加した人で構成されます。

バスケットのインサイト

バスケットのインサイトは、ブランドまたは広告主の広告で紹介されている商品と一緒に購入された商品について、そのカテゴリに関する情報を提供します。

小売店カスタムオーディエンス

小売店カスタムオーディエンスは、小売店が、内蔵されたドメイン保護機能を使いながらオーディエンスをコラボレーション相手のブランドと広告主に共有できる機能です。ドメイン保護機能により、そのオーディエンスを利用できるのはブランドパートナーのみとなり、キャンペーンのトラフィックは小売店のウェブサイトにのみ誘導されます。

プレミアムオプションを取得する

カタログセグメントのプレミアムオプション設定を取得するには、GET API呼び出しを使用します。catalog_segment_idとpartner_business_id、またはvendor_idのみを指定できます。両方を使用する場合は、catalog_segment_idが指定されたベンダーによって所有されていることを確認してください。

リクエスト

catalog_segment_idとpartner_business_idを使用して設定を取得するには、以下を実行します。

curl -i -X GET \
  "https://graph.facebook.com/v21.0/BUSINESS_ID?fields= \
  collaborative_ads_partner_premium_options \
  .catalog_segment_id(CATALOG_SEGMENT_ID) \
  .partner_business_id(PARTNER_BUSINESS_ID) \
  .vendor_id(VENDOR_ID) \
  &access_token=ACCESS_TOKEN"

vendor_idのみで設定を取得するには、以下を実行します。

curl -i -X GET \
  "https://graph.facebook.com/v21.0/BUSINESS_ID?fields= \
  collaborative_ads_partner_premium_options \
  .vendor_id(VENDOR_ID) \
  .partner_business_id(PARTNER_BUSINESS_ID) \
  &access_token=ACCESS_TOKEN"

パラメーター

名前	説明
`business_id` 数値文字列または整数	必須。カタログまたはベンダーが属するビジネスのID。
`catalog_segment_id` 数値文字列または整数	任意。更新するカタログセグメントのID。このフィールドまたは`vendor_id`フィールドのいずれかが必須です。
`vendor_id` 文字列	任意。更新するベンダーのID。このフィールドまたは`catalog_segment_id`フィールドのいずれかが必須です。
`partner_business_id` 数値文字列または整数	必須。取得するパートナーのビジネスのID。

応答

成功すると、以下のようにプレミアムオプションの現在の設定が取得されます。

{
  "collaborative_ads_partner_premium_options": {
    "enable_extended_audience_retargeting": bool,
    "enable_basket_insight": bool,
    "retailer_custom_audience_config": {
      "audience_id": [
        AUDIENCE_ID_1,
        AUDIENCE_ID_2,
        AUDIENCE_ID_3
      ]
    }
  }
}

プレミアムオプションを更新する

プレミアムオプション情報を更新するには、/{business_id}/partner_premium_optionsエンドポイントへのPOST API呼び出しを使用します。

リクエスト

catalog_segment_idとpartner_business_idを使用して設定を更新するには、以下を実行します。

curl -i -X POST \
  "https://graph.facebook.com/v21.0/BUSINESS_ID/partner_premium_options \
  ?catalog_segment_id=CATALOG_SEGMENT_ID \
  &partner_business_id=PARTNER_BUSINESS_ID \
  &enable_extended_audience_retargeting=BOOL \
  &enable_basket_insight=BOOL \
  &retailer_custom_audience_config=JSON_OBJECT \
  &access_token=ACCESS_TOKEN"

vendor_idのみで設定を更新するには、以下を実行します。

curl -i -X POST \
"https://graph.facebook.com/v21.0/BUSINESS_ID/partner_premium_options \
  ?vendor_id=VENDOR_ID \
  &enable_extended_audience_retargeting=BOOL \
  &enable_basket_insight=BOOL \
  &retailer_custom_audience_config=JSON_OBJECT \
  &access_token=ACCESS_TOKEN"

パラメーター

名前	説明
`business_id` 数値文字列または整数	必須。カタログまたはベンダーが属するビジネスのID。
`catalog_segment_id` 数値文字列または整数	任意。更新するカタログセグメントのID。このフィールドまたは`vendor_id`フィールドのいずれかが必須です。
`vendor_id` 文字列	任意。更新するベンダーのID。このフィールドまたは`catalog_segment_id`フィールドのいずれかが必須です。
`partner_business_id` 数値文字列または整数	必須。取得するパートナーのビジネスのID。
`enable_extended_audience_retargeting` ブーリアン	必須。拡大オーディエンスのリターゲティングを有効または無効にします。
`enable_basket_insight` ブーリアン	必須。バスケットのインサイトを有効または無効にします。
`retailer_custom_audience_config` JSONオブジェクト {`audience_id`: array of strings}	必須。このカタログセグメントを共有する`audience_ids`のリストが含まれます。共有を無効にするには、空の配列を入力します。例:`{'audience_id':[AUDIENCE_IDs]}`

応答

{
  "status": "success"
}

コラボレーションセンターからオーディエンスIDを取得する

コラボレーションセンターのオーディエンスツールからオーディエンスIDを取得できます。オーディエンスID列が表示されない場合は、ページの右上隅にある列ドロップダウンメニューをクリックし、オーディエンスIDチェックボックスをオンにします。

詳しくはこちら

コラボレーション広告