FBE予約のオンボーディング

Facebook Business Extension (FBE)予約フローにより、販売者はプラットフォームで幅広いビジネスツール(「予約」コールトゥアクションボタンなど)を、Facebookページ、Instagramアカウント、顧客とのMessengerチャットで使用できるようになります。このフローにカタログ機能はありません。

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

開始する前に

Facebook開発者として登録します。これにより、Facebookの開発者ツールにアクセスして、Metaアプリを作成できるようになります。
Metaアプリを作成します(まだ作成していない場合)。
テストアプリを作成します。
アプリ(ライブ/本番およびテスト)は、認証済みビジネスであるMetaビジネスマネージャが所有するアプリでなければなりません。ビジネスを認証する方法と、アプリを追加する方法の詳細をご確認ください。
MetaアプリにFBE開発者パネルを追加します。

オンボーディングの手順とエントリポイント

ビジネスオーナー(クライアント)は、パートナープラットフォーム上でビジネスをFacebookまたはInstagramのプロフィールに接続する(およびその逆を行う)メカニズムを必要とします。これは、FBEオンボーディングフローを使用して実現できます。予約フローには次のことが含まれます:

アセットの作成/選択
- ビジネスマネージャ
- 広告アカウント
- Instagramプロフィール
- Facebookページ
- Facebookピクセル
アクセス許可の付与
- ビジネス拡張機能の管理
ビジネスのセットアップと機能

接続を有効にするには、ユーザー(ビジネスオーナー)が接続を開始する場所に応じて、次の2つの認証フローをサポートする必要があります。

パートナーサーフェス(一般的にはビジネスログインと呼ばれます): ビジネスは、サイトに配置されたボタンを使用して、パートナーのプラットフォームから接続を開始できます。
ビジネスアプリ: ビジネスはFacebook/Instagramから接続を開始できます。このフローを有効にしてアプリをビジネスアプリに表示するには、サイトでユーザーがビジネスを選択した後にFacebookまたはInstagramのフローに戻れるよう、カスタム認証UIを用意する必要があります。

必須の構成

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` 型: 列挙。enum {`RESERVATIONS`}	必須。ビジネスに関連したバーティカル。ビジネスに関連したバーティカルとして、`RESERVATIONS`を使用します。

business_config

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

フィールド	説明
`business` タイプ: FBEBusinessPropertiesConfigData	必須。エンドユーザーのビジネスに関する情報。
`ig_cta` タイプ: FBEIGCtaConfigData	必須。 Instagramのコールトゥアクション(CTA)ボタンのための機能(`enabled`、`cta_button_text`、`cta_button_url`など)。サポートされるCTAテキスト: `Reserve`
`page_cta` タイプ: FBEPageCtaConfigData	必須。 Facebookページのコールトゥアクション(CTA)ボタンのための機能(`cta_button_text`、`cta_button_url`など)。サポートされるCTAテキスト: `Reserve`
`messenger_menu` タイプ: FBEMessengerMenuConfigData	任意ユーザーがビジネスにメッセージを送信する際のMessengerのコールトゥアクション(CTA)ボタンのための機能(`cta_button_text`、`cta_button_url`など) サポートされるCTAテキスト: `Reserve`

予約extrasのサンプル

{
    "setup": {
        "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>",
        "timezone": "<BUSINESS_TIMEZONE>",
        "currency": "<BUSINESS_CURRENCY>",
        "business_vertical": "RESERVATIONS"
    },
    "business_config": {
        "business": {
            "name": "<BUSINESS_NAME>"
        },
        "page_cta": {
            "enabled": true,
            "cta_button_text": "Reserve",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>",
            "below_button_text": "Powered by <YOU>"
        },
        "ig_cta": {
            "enabled": true,
            "cta_button_text": "Reserve",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "messenger_menu": {
            "enabled": true,
            "cta_button_text": "Reserve",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        }
    },
    "repeat": false
}

ビジネス設定について、詳細をご確認ください。

次のステップ

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