MBEコマースのオンボーディング

このガイドでは、MBEコマースフローの主要な前提条件と、プロセスを完了するために必要な手順の概要について説明します。

Meta Business拡張機能(MBE)を使用すると、ビジネスはFacebook広告を管理するツールを簡単に設定して、InstagramとFacebookのショップをセットアップできるようになります。MBEコマースのオンボーディングフローは、コマースのオフサイトショップとオンサイトショップの両方で使用できます。

オフサイトショップとオンサイトショップの主な違いは、オフサイトショップのチェックアウトは販売者のウェブサイトにリダイレクトされ、オンサイトショップのチェックアウトはFacebookまたはInstagramアプリ内で行われる点です。

コマースのオンボーディングフローにより、ビジネスは次のものをセットアップまたは統合できます。

Metaピクセル
カタログ
広告アカウント
Facebookページショップ
Instagramショップ
Messengerチャット(任意)
ビジネスマネージャ
コマースマネージャ

オフサイトまたはオンサイトのフローでInstagramショッピングを使用するには、Instagramビジネスアカウントが必要です。アカウントは利用要件を満たしている必要があります。

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

開始する前に

現在、ショップのオンボーディングフローは、一部のパートナー様のみがクローズドベータ版で利用できます。ご利用に関心をお持ちの場合は、Facebook担当者にお問い合わせください。

Meta開発者として登録します。これにより、Facebookの開発者ツールにアクセスして、Facebookアプリを作成できるようになります。
Facebookアプリを作成します(まだ作成していない場合)。
Facebookアプリは、認証済みビジネスであるビジネスマネージャが所有するアプリでなければなりません。詳しくは、ビジネスの認証方法をご覧ください。
ライブ/製品版アプリからテストアプリを作成し、それを使用してすべての新しい開発とテストを実施します。
非公開アクセス許可: manage_business_extension — これは、Facebook担当者がアプリを許可リストに追加する必要がある非公開のアクセス許可です。この機能がアプリに対して発行されると、[製品]の下にFBE開発者パネルが表示されます。
Facebookアプリのアプリレビューを通じて、以下の権限をリクエストします。
- catalog_management — 管理者権限を持つユーザーが、ビジネスが所有する商品カタログの作成、読み取り、更新、削除を行えるようにします。または、アプリを使用する販売者に代わって広告を管理する場合は、ads_managementアクセス許可をリクエストできます。
- business_management — ビジネスマネージャAPIを使用してビジネスアセットを管理するために必要です。
- Instagram_basic — Instagramショッピングを使用する場合に必要です。instagram_basicアクセス許可を使用すると、アプリがInstagramアカウントプロフィールの情報およびメディアを読み取ることが可能になります。
- pages_read_engagement — 後でページアクセストークンを生成するために必要です。
- (オンサイト) commerce_manage_accounts (読み取り/書き込み)またはcommerce_account_read_settings (読み取り専用) — コマースアカウントを管理するには、アプリレビューでこれらの詳細なアクセス許可が必要です。
- (オンサイト) commerce_account_manage_orders (読み取り/書き込み)またはcommerce_account_read_orders (読み取り専用) — コマースアカウントを使用して注文の一覧作成、表示、更新を行うには、これらの詳細なアクセス許可が必要です。
- (オンサイト) commerce_account_read_reports — アプリが財務レポートデータを読み取って、コマースアカウントの関税レポート、現金照合レポート、返金レポートを作成できるようにします。
販売者のドメインがまだ認証されていない場合、Instagramショッピングでドメイン認証が必要になることがあります。ドメインの認証方法をご覧ください。
ビジネスログインまたはFacebook App Storeを使用して、必須の構成で認証をセットアップし、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に設定します。

設定

フィールド	説明
`external_business_id` 文字列	必須クライアントのビジネスを表す一意のビジネスID。Facebookはこれを一意の識別情報として使用します。例えば、販売者の会社の名前が「Fubar」である場合、「fubar-123」を`external_business_id`として指定します。
`timezone` 文字列	必須ビジネスの所在地のタイムゾーン。使用可能なタイムゾーン値をご覧ください。
`currency` 文字列	必須ビジネスのカタログアイテムで使用されるデフォルト通貨の3文字のISO通貨コード。サポートされる通貨コードをご覧ください。
`business_vertical` 列挙型	必須ビジネスに関連付けられている業種値:`ECOMMERCE`
`merchant_settings_id` 文字列	任意 Facebook Business Extension, v1からアップグレードする際に使用します。v1からv2に移行する場合は、Facebook担当者にお問い合わせください。
`domain` 文字列	必須(COMMERCEおよびCOMMERCE_OFFSITEチャネルの場合) Instagramの手動承認に使用されるドメイン。例: `https://exampleshop.partnersite.com`。
`channel` 列挙型	必須追加の手順または制約が必要となる機能に関して、パートナーがユーザーに意図を伝える手段を提供します: `COMMERCE`および`COMMERCE_OFFSITE`。 `COMMERCE` — 販売者が、オンサイトチェックアウトでページショップおよびInstagramショッピングチャネルを使用するコマースアカウントを作成できるようにするフロー。このフローでは、オフサイトチェックアウトを選択するオプションも利用できます。 `COMMERCE_OFFSITE` — 販売者が、オフサイトFacebookショップおよびオフサイトInstagramショッピングを使用するコマースアカウントを作成できるようにするフロー。注: パートナーは、すべてのコマースフロー(`COMMERCE`および`COMMERCE_OFFSITE`)で`instagram_basic`アクセス許可をリクエストする必要があります。Instagramのオンボーディング/販売者アクセスポリシーに対応するには、アプリに`instagram_basic`アクセス許可が必要です。このアクセス許可は、アプリレビューが必要です。
`business_manager_id` 文字列	任意セットアップフローでパートナーがユーザーへの事前選択のために入力できる、ユーザーの既存のビジネスマネージャのビジネスマネージャID。
`ad_account_id` 文字列	任意セットアップフローでパートナーがユーザーへの事前選択のために入力できる、ユーザーの既存の広告アカウントの広告アカウントID。
`page_id` 文字列	任意セットアップフローでパートナーがユーザーに関する事前選択のために入力できる、ユーザーの既存のFacebookページのページID。
`ig_profile_id` 文字列	任意セットアップフローでパートナーがユーザーに関する事前選択のために入力できる、ユーザーの既存のInstagramビジネスプロフィールのInstagramビジネスプロフィールID。
`pixel_id` 文字列	任意セットアップフローでパートナーがユーザーに関する事前選択のために入力できる、ユーザーの既存のピクセルのピクセルID。
`catalog_id` 文字列	任意セットアップフローでパートナーがユーザーへの事前選択のために入力できる、ユーザーの既存のカタログのカタログID。

ビジネス構成

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

フィールド	説明
`business` FBEBusinessPropertiesConfigData	必須エンドユーザーのビジネスに関する情報
`messenger_chat` FBEMessengerChatConfigData	任意エンドユーザーのFacebookページ上のMessengerチャット機能(`enabled`、`domains`など)
`catalog_feed_scheduled` FBECatalogFeedConfigData	任意 Facebook Business Extensionが、`feed_url`からカタログアイテムを取得するフィードアプローチを使用するかどうかを決定します
`page_cta` FBEPageCtaConfigData	任意エンドユーザーのページ上のコールトゥアクション(CTA)ボタン(`cta_button_text`、`cta_button_url`など)
`ig_cta` FBEIGCtaConfigData	任意 Instagramのコールトゥアクション機能のための機能(`enabled`、`cta_button_text`、`cta_button_url`など)
`messenger_menu` FBEMessengerMenuConfigData	任意ユーザーがビジネスにメッセージを送信している場合のMessenger CTAボタンの機能(`cta_button_text`、`cta_button_url`など)。

インストール後

アセットIDを取得し、Webhook通知とピクセルイベントを確認します。
コマースアカウント管理ビューで、オンサイトショップの税金および配送情報を設定します。
コマースAPIに対するアクセス権を検証します。