広告キャンペーンの作成と実施

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

はじめに

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

必要なアクセス許可

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

販売者のビジネス管理者

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

欧州連合(EU)やその関連地域をターゲットとする広告キャンペーンの場合、dsa_payorフィールドとdsa_beneficiaryフィールドが必須になります。これらの2つのフィールドで提供された情報は、その広告のスポンサーと受益者を示すために、エンドユーザーに表示されます。

EUとそれに関連する区域をターゲットとするすべてのキャンペーンで、受益者およびスポンサーの情報が必須です。これらのフィールドが指定されていない場合、広告主はMPAキャンペーンを作成できず、APIから以下に示されているエラーコードと共に失敗した場合の応答が返されます。

販売者広告作成API呼び出し

リクエスト

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "lifetime_budget=10000&start_time=1598286074&end_time=1598286074&override_targeting_countries=['US','UK']&use_marketplace_template=true&product_set_id=<PRODUCT_SET_ID>" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

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

パラメーター

名前	説明
`conversion_domain` 文字列	必須。広告作成フローのコンバージョンドメインを設定します。 `conversion_domain`フィールドが、Metaピクセルの設定と一致していなければなりません。このフィールドに含めるのは第1レベルと第2レベルのドメインだけにし、URL全体は含めないようにしてください。例えば、facebook.comのようにします。
`custom_event_type` 列挙型	任意。潜在顧客発見広告とリターゲティング広告の両方について最適化するためのアプリイベント。値:`CONTENT_VIEW`、`ADD_TO_CART`、`PURCHASE` 条件: このフィールドを指定できるのは、`use_marketplace_template`が`true`、かつ`use_seller_template`が`false`の場合だけです。
`dsa_payor` 文字列(最大512文字)	任意。キャンペーンのスポンサー。注: このフィールドは、EUやその関連地域をターゲットとするキャンペーンでは必須です。
`dsa_beneficiary` 文字列(最大512文字)	任意。キャンペーンの受益者。注: このフィールドは、EUやその関連地域をターゲットとするキャンペーンでは必須です。
`end_time` 日時	必須。広告キャンペーンの終了時間(UTC UNIXタイムスタンプ)。
`lifetime_budget` 数値文字列	必須。広告アカウントの通貨によるキャンペーンの予算。広告の場合、1か100のオフセットが可能です(セントの概念のある通貨の場合)。例えば、USD (オフセット100)での`lifetime_budget = 1`は、1/100 (オフセット) = $0.01 (1セント)を意味します。JPY (オフセット1)での`lifetime_budget = 1`は、1/1 (オフセット) = ¥1 (1円)を意味します。
`override_creative_text` 文字列	必須。クリエイティブの本体。
`override_targeting_countries` list<strings>	任意。キャンペーンでターゲット設定する国。潜在顧客発見広告とリターゲティング広告の両方について販売者ビジネスを作成している際に設定された国は、この値によって上書きされます。
`product_set_id` 数値文字列	任意。このキャンペーンにより、そのすべての広告を通じて宣伝する販売者商品カタログ内での商品セットのID。
`start_time` 日時	必須。広告キャンペーンの開始時間(UTC UNIXタイムスタンプ)。
`use_marketplace_template` bool	任意。すべての販売者がグローバルに利用可能なデフォルトのテンプレートを使ってキャンペーンを作成するために、このフィールドを指定します。条件:`use_marketplace_template`か`use_seller_template`のどちらか一方を使う必要があります。両方使うことはできません。
`use_seller_template` bool	任意。販売者に適用されるカスタムテンプレートを使ってキャンペーンを作成するために、このフィールドを指定します。条件:`use_marketplace_template`か`use_seller_template`のどちらか一方を使う必要があります。両方使うことはできません。

応答

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

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

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

成功した場合の応答

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

{
  "result": "{\"id\":\"<NEWLY_CREATED_CAMPAIGN_ID>\"}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

失敗した場合の応答

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

エラーコード

エラーコード	エラーサブコード	説明
1800011	2310154	広告クリエイティブ投稿は、開発モードのアプリによって作成されたものでした。この広告を作成するには、それが公開されていなければなりません。
1800103	2310155	ビジネスマネージャ {seller_business_id} に、共有カタログセグメントが欠落しています。オンボーディングが部分的にしか行われていないことが原因である可能性があります。コラボレーションセンターを使ってアセットを共有したりカタログセグメントを追加したりすることができます。または、販売者削除APIを使って販売者を削除し、非同期販売者オンボーディングAPIを使って再オンボーディングすることもできます。また、Metaパートナーにヘルプを求めることもできます。
1800104	2310156	入力したID {product_set_id}は、商品セットIDではありません。カタログID {catalog_id}に関連する商品セットIDを入力してください。
1800105	2310157	入力したID {product_set_id}は、ビジネスのカタログセグメントの商品セットIDではありません。カタログID {catalog_id}に関連する商品セットIDを入力してください。
1800208	2310152	Metaの広告ポリシーやその他の規定に違反したため、このビジネスの広告アカウントは無効にされています。詳しくは、コラボレーションセンターの [パートナーシップ] に移動し、[マネージドパートナー]と[品質の問題]のタブを選択してください。また、Metaパートナーにヘルプを求めたり異議申し立てしたりすることもできます。
1800209	2310153	入力された広告アカウント{account_id} は、マネージドパートナー広告で作成されたものではありませんでした。このビジネスがマネージドパートナー広告にオンボーディングされた際に、このビジネス用に作成されたアカウントIDを入力してください。
1800308	2310137	このビジネスのビジネスマネージャ {seller_business_id} に、販売者のページが欠落しています。オンボーディングが部分的にしか行われていないことが原因である可能性があります。販売者削除APIを使って販売者を削除し、非同期販売者オンボーディングAPIを使って再度オンボーディングすることができます。また、Metaパートナーにヘルプを求めることもできます。
1800309	2310159	このビジネスの販売者ページは無効にされており、このページを使って広告を掲載することはできません。Metaの広告ポリシーまたはその他の規定に違反していることが原因と推測されます。詳しくは、コラボレーションセンターの [パートナーシップ] に移動し、[マネージドパートナー]と[品質の問題]のタブを選択してください。また、Metaパートナーにヘルプを求めたり異議申し立てしたりすることもできます。
1800400	2310161	入力されたキャンペーン予算が少なすぎます。使われているテンプレートによると、予算は{minimum_budget}以上でなければなりません。
1800402	2310160	入力された潜在顧客発見予算とリターゲティング予算が100 %に等しくなっていません。潜在顧客発見キャンペーンのための予算割合とリターゲティングキャンペーンのための予算割合の合計が100 %になるように入力してください。さらに、テンプレートにおいて、潜在顧客発見キャンペーンとターゲット設定キャンペーンの両方が識別されていることを確認してください。
1800500	2310166	マネージドパートナー広告(MPA) APIを使って、MPAキャンペーンではないキャンペーンを更新しようとしています。入力したキャンペーン({campaign_id})を確認するか、別のAPIを使ってください。
1800501	2310168	入力されたキャンペーンID ({campaign_id})は、この広告アカウントに属していません。IDを確認して再試行してください。
1800700	2310172	この広告セットの費用を負担している人または組織を入力してください。
1800701	2310171	この広告セットから利益を得ている人または組織を入力してください。