広告アカウント

ビジネス管理者は、ビジネスに属する広告アカウントを取得できます。取得することで、利用者をアクセスする必要のある広告アカウントに簡単に割り当てられます。また、共有された支払い方法を広告アカウントに割り当てることもできます。

広告アカウントグループを、ビジネスが取得することはできません。特定の広告アカウントグループへのアクセス権が付与されているユーザーについては、ビジネスマネージャに追加された後も、そのアクセス権が引き続き付与されています。

アカウントを取得する

ビジネスマネージャ以外の広告アカウントを管理者の役割で管理している場合、そのアカウントをビジネスのために取得することができます。これは一度限りの手続きです。取得すると、その広告アカウントを管理できるのは、そのビジネスマネージャでのみとなります。

クリエイティブアカウントは取得できません。

ビジネス用に広告アカウントを取得するには、広告アカウントIDをact_###の形式で指定します。POSTを送信します: \リクエストの送信者は広告アカウントを取得するビジネスの管理者である必要があります

curl \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

広告アカウントの管理者の場合、この取得リクエストはすぐに承認されます。CONFIRMEDに設定されたaccess_statusが返されます。

広告アカウントの適切なアクセス許可を所有していない場合は、所有権に関するリクエストが広告アカウントの管理者に送信されます。リクエストが送信されると、access_statusがPENDINGに設定された応答が返されます。

所有権に関するリクエストを承認するには、広告アカウントの管理者である必要があります。リクエストを承認する際は、広告マネージャにログインしてください。

アカウントへのアクセスをリクエスト

マーケティング会社の大多数は、クライアントから広告アカウントを取得する必要がありません。他のビジネスマネージャが所有するアセットへのアクセス権をリクエストするには、企業間(B2B)機能をご覧ください。

広告アカウントを作成する

新しい広告アカウントを作成できるのは、ビジネスの管理者だけです。ビジネス管理者の共有ログインを使って、新しい広告アカウントを作成したり、その他のアクションを実行したりすることはできません。

このAPIを使うには、有効なビジネスとページを設定しておく必要があります。不完全な広告アカウントやFacebookで未公開のページがある場合は、新しい広告アカウントを作成することはできません。

APIを使って広告アカウントを作成する場合、広告アカウントは5個までという制限があります。作成する広告アカウントが5個を超える場合は、手動で作成する必要があります。

利用できるフィールドは次のとおりです。

名前	説明
`name` 型: 文字列	広告アカウントの名前
`timezone_id` 型: 整数	タイムゾーンのID
`currency` 型: 文字列	広告アカウントで使う通貨の略語
`partner` 型: longまたは文字列	Facebookビジネスパートナー(FBP)。Facebookページのエイリアス、FacebookページID、FacebookアプリIDのいずれかでなければなりません。それらが利用可能でない場合は、`NONE`または`UNFOUND`を使ってください。
`end_advertiser` 型: longまたは文字列	広告がターゲットにする企業。ビジネスIDでなければなりません。それらが利用可能でない場合は、`NONE`または`UNFOUND`を使ってください。
`media_agency` 型: longまたは文字列	広告会社(自分のビジネスも可能)。Facebookページのエイリアス、FacebookページID、FacebookアプリIDのいずれかでなければなりません。それらが利用可能でない場合は、`NONE`または`UNFOUND`を使ってください。
`invoice` 型: ブーリアン	Facebookでビジネスマネージャが所有する通常のクレジットラインをビジネスが設定している場合、そのクレジットラインに広告アカウントが紐づけられます。

ビジネスのための新しい広告アカウントを作成するには、name、currency、timezone_id、end_advertiser、media_agency、partnerを指定します。次の条件をご覧ください。

media_agencyとpartnerは、Facebookページの別名、FacebookページID、またはFacebookアプリIDでなければなりません。
end_advertiserはビジネスIDでなければなりません。

広告アカウントに広告主、メディアエージェンシー、パートナーが存在しない場合、NONEを指定します。広告アカウントに広告主、メディアエージェンシー、パートナーが存在するが、ページまたはアプリとしてFacebookに公開されていない場合、UNFOUNDを指定します。

広告アカウントを作成するには、次のようにします。

curl \
  -F "name=MyAdAccount" \
  -F "currency=USD" \
  -F "timezone_id=1" \
  -F "end_advertiser=<END_ADVERTISER_ID>" \
  -F "media_agency=<MEDIA_AGENCY_ID>" \
  -F "partner=NONE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

Facebookで増額クレジットラインを設定している場合、invoiceをtrueに設定できます。これにより、新しい広告アカウントに増額クレジットラインが紐づけされます。

応答は次のようになります。

{
  "id": "act_<ADACCOUNT_ID>",
  "account_id": "<ADACCOUNT_ID>",
  "business_id": "<BUSINESS_ID>",
  "end_advertiser_id": "<END_ADVERTISER_ID>",
  "media_agency_id": "<MEDIA_AGENCY_ID>",
  "partner_id": "NONE"
}

所有するアカウントを確認する

自分のビジネスにアクセス権が付与されているすべての広告アカウントを確認するには、GET呼び出しを実行します。

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

ビジネスが所有するすべての広告アカウントが返されます。フィールドの一部は、ビジネスと広告アカウントの関連性に関するものです。

permitted_tasksは、その特定の広告アカウントに割り当てることが可能なタスクの配列です。
access_typeは、ビジネスが広告アカウントのOWNERであるか、それともAGENCYであるかを示します。

次のGET呼び出しを実行すると、アクセス権承認待ちの広告アカウントを確認できます。

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"

アカウントを削除する

あなたがOWNERであり、アカウントがCONFIRMEDの場合、ビジネスから広告アカウントを削除することはできません。PENDINGのアクセスリクエストがある場合、または広告アカウントへのAGENCYアクセス権が付与されている場合、次のDELETE呼び出しを実行できます。

curl \
  -X DELETE \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"

アカウントアクセス権を確認する

第三者にアクセス許可が付与されている広告アカウントを確認するには、次のGET呼び出しを実行します。

curl -G \
  -d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"

広告アカウントに対して第三者に付与されているアクセス許可を確認するには、次のGET呼び出しを実行します。

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

アカウントにユーザーを追加する

ビジネスマネージャが広告アカウントに関連付けられたら、他のビジネスユーザーにタスクを割り当てることができます。可能なタスクには以下が含まれます。

名前	APIの定数	説明
レポートのみ	`['ANALYZE']`	広告のパフォーマンスに関するデータを確認できます
一般ユーザー	`['ADVERTISE', 'ANALYZE']`	広告を表示して編集したり、広告アカウントに関連付けられた支払い方法を使って広告を作成したりできます。広告アカウントレベルで何か(支払い方法自体など)を設定することはできません。
管理者	`['MANAGE', 'ADVERTISE', 'ANALYZE']`	キャンペーン、レポート、請求、広告アカウントアクセス許可のすべての側面を管理できます。

以下が必要です。

adaccount_id — act_123という形式の広告アカウントID
user_id — 追加するユーザーID
割り当てるタスク

タスク['MANAGE', 'ADVERTISE', 'ANALYZE']が割り当てられた新しいユーザーを追加するには、次のPOST呼び出しを発行します。

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

アカウントのアクセス許可を変更する

既存のユーザーのタスクを変更するには、新しいユーザーを追加するのと同じPOST呼び出しを発行します。

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

広告アカウントからユーザーを削除する

アカウントからユーザーを削除するには、次のものが必要です。

adaccount_id — act_123という形式の広告アカウントID
user_id — 削除するユーザーID

DELETE呼び出しは次のようになります。

curl \
  -X DELETE \
  -F "user=<BUSINESS_SCOPED_USER_ID>" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"