広告キャンペーンのアップデート

このページでは、マネージドパートナー広告にオンボーディングしたマネージドパートナー(販売者)の広告キャンペーンをアップデートする際の手順を紹介しています。

始める前に

パートナーの広告キャンペーンをアップデートする前に、必ず以下の手順を完了してください。

1. 管理者システムユーザーを作成する
2. 管理システムユーザーにアクセス許可を割り当てる
3. 管理システムユーザーのアクセストークンを生成する
4. 販売者の要件を確認する
5. 販売者をオンボーディングする

必要なアクセス許可

販売者広告アップデートAPIを呼び出すには、以下のアクセス許可が必要です。

• 販売者のビジネス管理者

ターゲットとするDSA規制地域(欧州連合)

欧州連合(EU)やその関連地域をターゲットとする広告キャンペーンの場合、dsa_payorフィールドとdsa_beneficiaryフィールドが必須になります。これらの2つのフィールドで提供された情報は、その広告のスポンサーと受益者を示すために、エンドユーザーに表示されます。これらのフィールドが指定されていない場合、広告主はMPAキャンペーンを編集できず、APIから以下にリストするエラーコードと共に失敗した場合の応答が返されます。

販売者広告アップデートAPI呼び出し

リクエスト

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "campaign_group_id=123456789&lifetime_budget=100000" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

このAPI呼び出しに対する応答は、ASYNC_SESSION_IDと共に直ちに返されます。引き続きリクエストが処理される間、[COMPLETED|FAILED]ターミナル状態に達するまで、ASYNC_SESSION_IDがポーリングされます。

パラメーター

応答

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

ASYNC_SESSION_IDを使って、マネージドパートナー広告にオンボーディングされた販売者の対応するIDを取得します。

詳しくは、非同期セッションをポーリングして応答を得る方法をご覧ください。

成功した場合の応答

ステータスがCOMPLETEDの場合、非同期セッションをポーリングした結果得られるデータは次のようになります。

{
  "result": "{\"id\":\"<NEWLY_UPDATED_CAMPAIGN_ID>\",\"success\":true}",
  "id": "<ASYNC_SESSION_ID>"
}

失敗した場合の応答

ステータスがFAILEDの場合、非同期セッションをポーリングした結果得られるデータは次のようになります。

エラーコード

参考情報

• 非同期セッションをポーリングして応答を得る方法