FBEカスタムオーディエンスオンボーディング

Facebook Business Extension (FBE)のカスタムオーディエンスを使用すると、ビジネスは、顧客、ウェブサイト訪問者、モバイルアプリ訪問者、または類似した利用者のオーディエンスを構築して、広告のターゲット設定を最適化できるようになります。FBEカスタムオーディエンスのオンボーディングフローにより、ビジネスは次のものをセットアップまたは統合できます:

ビジネスマネージャ
Facebookページ
広告アカウント

このドキュメントでは、FBEカスタムオーディエンスフローの主要な前提条件と、プロセスを完了するために必要な手順の概要について説明します。統合全体の詳細については、Facebook Business拡張機能ガイドをご覧ください。

例: パートナーサーフェス(ビジネスログイン)からのオンボーディングフロー

開始する前に

アプリは、認証済みビジネスであるビジネスマネージャが所有するアプリでなければなりません。ビジネスの認証方法の詳細をご確認ください。
Facebookアプリには、以下のアクセスレベル、機能、アクセス許可が必要です:
- アクセスレベル: アドバンスアクセス
- 機能: 広告管理スタンダードアクセス
- 公開アクセス許可: ads_management
- 非公開アクセス許可: manage_business_extension — これは、Facebook担当者がアプリを許可リストに追加する必要がある非公開のアクセス許可です。
ビジネスログイン(パートナープラットフォームの場合)またはビジネスアプリ(Facebookの場合)を使用して、必須の構成で認証をセットアップし、FBEオンボーディングフローを開始します。

必須の構成

Extras

フィールド型説明

フィールド	型	説明
`setup`	setup	必須販売者のFacebookセットアップ。一意の識別情報(`external_business_id`)やカタログの通貨(`currency`)など。setupオブジェクトの詳細をご覧ください。
`business_config`	business_config	必須 Facebook Business ExtensionがFacebook Business Extensionワークフローを構成するために使用する構成オブジェクト。`business_config`オブジェクトの詳細をご覧ください。
`repeat`	ブーリアン	必須この値は`false`に設定します。

setup

setup

必須

販売者のFacebookセットアップ。一意の識別情報(external_business_id)やカタログの通貨(currency)など。setupオブジェクトの詳細をご覧ください。

business_config

business_config

必須

Facebook Business ExtensionがFacebook Business Extensionワークフローを構成するために使用する構成オブジェクト。business_configオブジェクトの詳細をご覧ください。

repeat

ブーリアン

必須

この値はfalseに設定します。

Setup

このオブジェクトを使用して、エンドユーザーのFacebookプレゼンスの設定を定義します

フィールド	説明
`external_business_id` 型: 文字列	必須。クライアントのビジネスを表す一意のビジネスID。Facebookはこれを一意の識別情報として使用します。例えば、販売者の会社名が「Fubar」である場合、「fubar-123」が`external_business_id`になります。
`timezone` 型: 文字列	必須。ビジネスの所在地のタイムゾーン。使用可能なタイムゾーン値をご覧ください。
`currency` 型: 文字列	必須。ビジネスのカタログアイテムに使われるデフォルト通貨の3文字のISO通貨コード。サポートされる通貨コードをご覧ください。
`business_vertical` 型: 列挙値	必須。ビジネスに関連付けられている業種値:`CUSTOM_AUDIENCE`
`channel` 型: 列挙値	必須。パートナーがFBEのフローを構成する手段を提供します。カスタムオーディエンスフローの場合、この値は`CUSTOM_AUDIENCE`にする必要があります。 `CUSTOM_AUDIENCE` — エンドユーザーがビジネスマネージャ、広告アカウント、Facebookページを作成または選択できるようにするフロー。これらのアセットを設定すると、エンドユーザーはサードパーティのプラットフォームを介してFacebookにカスタムオーディエンスを作成できます。
`business_manager_id` 型: 文字列	任意。ユーザーの既存のビジネスマネージャのビジネスマネージャID。パートナーがこのIDを入力すれば、セットアップフローでユーザーが事前選択されます。
`ad_account_id` 型: 文字列	任意。ユーザーの既存の広告アカウントの広告アカウントID。パートナーがこのIDを入力すれば、セットアップフローでユーザーが事前選択されます。
`page_id` 型: 文字列	任意。ユーザーの既存のFacebookページのページID。パートナーがこのIDを入力すれば、セットアップフローでユーザーが事前選択されます。

ビジネス設定

このオブジェクトを使用して、エンドユーザーのビジネス設定を構成します。これにはCTAやサービスカードなどが含まれます。各フィールドに含まれる「タイプ」は、下記のそれぞれの表にリンクしています。

フィールド	説明
`business` タイプ: FBEBusinessPropertiesConfigData	必須。エンドユーザーのビジネスに関する情報

次のステップ

ビジネスによるFBEのインストールとアンインストールに関するWebhook通知を受け取ります。
プラットフォーム上のすべてのFBE連携ビジネスでピクセルイベントを発行する。
サーフェスからFacebookの機能管理ビューへのエントリポイントを追加する。
ビジネスがFBEをアンインストールできるようにする。
FBE連携レビューを申請します。統合が承認されると、一般ユーザーがアプリを利用できるようになります。