MBE予約ツールのオンボーディング

Meta Business拡張機能(MBE)予約ツールフローにより、販売者はプラットフォームで幅広いビジネスツール(「予約する」CTAボタンなど)を、Facebookページ、Instagramアカウント、顧客とのMessengerチャットで使用できるようになります。

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

開始する前に

Meta開発者として登録します。これにより、Facebookの開発者ツールにアクセスして、Facebookアプリを作成できるようになります。
まだMetaアプリを作成していない場合は作成し、ビジネスアプリタイプを選択します。
ライブ/本番アプリからテストアプリを作成し、それを使用してすべての新しい開発とテストを実施します。
アプリ(ライブ/製品版およびテスト版)は、ビジネスアプリタイプでなければならず、かつ、認証済みビジネスであるビジネスマネージャが所有するアプリでなければなりません。ビジネスを認証する方法と、アプリを追加する方法の詳細をご確認ください。
アプリにMBE開発者パネルを追加します。
おすすめサービスのページカード機能を有効にする場合、承認されたカタログアクセス許可(catalog_management)をアプリレビューで取得してからでなければアプリをライブにすることはできません。catalog_managementを取得すると、アプリはビジネス所有のカタログ(サービスインベントリー)の作成、読み取り、アップデート、削除を行えます。次の手順のスクリーンキャストを行うための動作デモを作成したら、すぐにアプリレビューリクエストを申請してください。
- オンボーディングフローでカタログアクセス許可をリクエストする
- 接続されているカタログにサービスインベントリーをプッシュする
- 最終的に、接続されたページでサービスカードが有効になる

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

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

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

接続を有効にするには、ユーザー(ビジネスオーナー)が接続を開始する場所に応じて、次の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に設定します。

設定

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

フィールド	説明
`external_business_id` 文字列	必須。クライアントのビジネスを表す一意のビジネスID。Metaはこれを一意の識別情報として使います。例えば、販売者の会社名が「Fubar」である場合、「fubar-123」が`external_business_id`になります。
`timezone` 型: 文字列	必須。ビジネスの所在地のタイムゾーン。使用可能なタイムゾーン値をご覧ください。
`currency` 型: 文字列	必須。ビジネスのカタログアイテムに使われるデフォルト通貨の3文字ISO通貨コード。サポートされる通貨コードをご覧ください。
`business_vertical` 型: 列挙{`APPOINTMENTS`}	必須。ビジネスに関連付けられたバーティカル。 `APPOINTMENTS`をビジネスに関連付けたバーティカルとして使用します。

business_config

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

フィールド	説明
`business` タイプ: FBEBusinessPropertiesConfigData	必須。エンドユーザーのビジネスに関する情報。
`ig_cta` タイプ: FBEIGCtaConfigData	必須。 InstagramのCTAボタンのための機能(`enabled`、`cta_button_text`、`cta_button_url`など)。サポートされるCTAテキスト: `Book Now`
`page_cta` タイプ: FBEPageCtaConfigData	必須。 FacebookページのCTAボタンのための機能(`cta_button_text`、`cta_button_url`など)。サポートされるCTAテキスト: `Book Now`
`page_card` タイプ: FBEPageCardConfigData	任意。ビジネスのおすすめのサービスのカード(最大3枚)をFacebookページで有効にします。カタログの実装が必須です。
`messenger_menu` タイプ: FBEMessengerMenuConfigData	任意。ユーザーがビジネスにメッセージを送信している場合のMessenger CTAボタンの機能(`cta_button_text`、`cta_button_url`など)。サポートされるCTAテキスト: `Book Now`
`thread_intent` タイプ: FBEThreadIntentConfigData	任意。ビジネス管理者がチャットで簡単に予約可能日時をユーザーに通知するための、Messengerによる提案。

予約ツールextrasのサンプル

{
    "setup": {
        "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>",
        "timezone": "<BUSINESS_TIMEZONE>",
        "currency": "<BUSINESS_CURRENCY>",
        "business_vertical": "APPOINTMENTS"
    },
    "business_config": {
        "business": {
            "name": "<BUSINESS_NAME>"
        },
        "page_cta": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>",
            "below_button_text": "Powered by <YOU>"
        },
        "page_card": {
            "enabled": true,
            "see_all_text": "See All",
            "see_all_url": "<BUSINESS_URL_FOR_CTA>",
            "cta_button_text": "Book"
        },
        "ig_cta": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "messenger_menu": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "thread_intent": {
            "enabled": true,
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        }
    },
    "repeat": false
}

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

次のステップ

ビジネスによるFBEのインストールとアンインストールを知らせるWebhook通知を受け取ります。
プラットフォーム上のすべてのFBE連携ビジネスでピクセルイベントを起動します。
サーフェスから機能管理ビューへのエントリポイントを追加します。
ビジネスのすべてのインベントリーをMetaに送信し、カタログを最新の状態に保ちます(任意)。
ビジネスがFBEをアンインストールすることを許可します。
FBE連携レビューを申請する。統合が承認されたら、アプリを立ち上げて一般ユーザーがアプリを利用できるようにすることができます。