Meta Business拡張機能に関するよくある質問

Meta Business拡張機能(MBE)連携に関するよくある質問への回答。

インストール

Commerce/Shops onboarding flows are currently only available to select partners in a closed beta. If you are interested in receiving access in the future, please contact your Facebook representative and review this document for reference.

Ensure that the merchant has MBE currently installed and has selected all applicable business assets during onboarding.

アプリダッシュボードのFBE開発者パネル > [設定]タブの下で[カタログを有効にする]チェックボックスがオンになっていることを確認してください。

ビジネス/販売店は管理ビューでさまざまなビジネス機能を構成できますが、ビジネスマネージャ、広告アカウント、ページ、ピクセル、カタログなど、FBEに接続されているFacebookアセットをアップデートすることはできません。その代わりビジネス/販売店は、さまざまなアセットと接続するためのFBE設定フローの中で設定を編集することができます。

ビジネスのニーズに応じて、[設定] > [チャネル]の下で該当する値を設定することにより、以下のフローのうちの1つ以上を設定できます:

  • デフォルトフロー (チャネルにパラメーターは不要) - 販売店がダイナミック広告のためのFacebookピクセル、Facebookページ、広告アカウント、カタログを設定できるできるようにします。
  • COMMERCE — オンサイトチェックアウトにより、FacebookショップおよびInstagramショッピングチャネルを使用して、コマースアカウントを販売店が作成できるようにするフロー。また、フロー内のオフサイトショップを選択するオプションを試します。
  • COMMERCE_OFFSITE - 販売者が、オフサイトFacebookショップおよびオフサイトInstagramショッピングを使用するコマースアカウントを作成できるようにするフロー。
  • FEED - 小売店がそれぞれのカタログアップデートの同期を実行するためのフロー。フィード/カタログ機能があり、ウェブサイトホスティングのないパートナーの場合にのみ推奨。
  • MARKETPLACE - FBEと統合するMarketplaceに固有のフロー。FBE設定フローのうちページとビジネスマネージャの手順のみを必要とし、FBE管理ビューを利用してコラボレーション広告を設定するパートナーの場合に推奨。
  • SIGNALS - ユーザーがFacebookピクセルとコンバージョンAPIのイベントを発行するためのフロー。このフローでは、アセットとしてFacebookカタログはサポートされていません。ウェブサイトホスティング機能があり、カタログ機能のないパートナーの場合にのみ推奨。

FBEビジネスログインでページを選択する際のよくあるシナリオを、以下にいくつか示します。アセットを選択できない正確な理由については、FBEフローのヒントの中に説明があることに注意してください - 理由はシナリオごとに異なる場合があります。

ページが選択可能になる状況:

  • 選択されたページがどのBMによっても所有されていない場合、そのページは選択されたBMによって取得されます
  • 選択されたページが別のBMによって所有されておりそのBMの主要ページではない場合、そのページは選択されたBMに転送されます

ページが選択可能ではなくなる状況:

  • ページが別のBMによって所有されており、かつその主要ページでもある場合
  • ページが、ポリシー違反などのため無効にされているBMによって所有されている場合

パートナーはそれぞれのアプリのためにPage Public Metadata Access機能をリクエストして、アプリからページの公開フィールドをクエリできます。この機能については、こちらのドキュメント、およびこちらもご覧ください。

instagram_profilesフィールドが含まれていない場合、Instagram関連のアクセス許可(instagram_basic)などがアクセストークンに含まれていないか、ビジネスがFBEによりどのInstagramビジネスプロフィールにも接続していないか、もしくはその両方であることを意味します。FBEインストールAPIについて詳しくは、このドキュメントをご覧ください

これは、アプリに何らかのアクセス許可が欠落していることを意味します。ビジネスマネージャ関連アクションに必要な主なアクセス許可は、business_managementです。

このリストにある通貨のほとんどがサポートされています。ただし、JMD、BGN、BYN、UAH、KIP、LKRを除きます。

警告: ログインURL構成設定の中で、サポートされていない通貨が指定されると、FBEインストールが失敗します。パートナーは販売店が使用する通貨がサポート対象であることを確認してから、FBEを起動できるようにするようおすすめします。

Facebookビジネスマネージャの中で、FacebookビジネスページやInstagramビジネスプロフィールへの管理アクセス許可に加えて、現時点のFBE接続に関連した管理アクセス許可が付与されていることを確認します。Facebookビジネスマネージャに管理アクセスを追加する方法については、こちらで説明されている手順に従ってください。

テスト

No, system user access tokens can't be generated for test users.

Merchants can remove assets in the management view of MBE after installation.

Ensure that your app has been approved for "advanced access" for any permission you're using in the scopes of your business login URL, and that the permissions are “active” for your app.

There are two types of test accounts available via the developer panel.

  1. Testers: Tester role can be assigned to a user-generated Facebook profile. Reference

  2. Test User: Test users are simulated Facebook user accounts. They cannot interact with real Facebook users. Reference

Review each to decide which is better for your testing use case.

トラブルシューティング

For troubleshooting, it's best to uninstall (with a DELETE request) and then re-install MBE for a particular merchant.

A good first step is uninstalling and then re-installing MBE. If they're still experiencing issues, they can reach out in the "Contact Us" link of MBE onboarding or the "Help Center" form on the MBE management view UI.

一般

Your app must be whitelisted to have approval to use the Meta Business Extension. If you aren't approved for MBE, you'll encounter errors while trying to set up your MBE assets. Contact your partner manager to confirm that your app has been whitelisted for MBE.

This is a closed beta. Please reach out to your Meta partner manager for more information.

カタログ

Facebook Business Extension (FBE) v2では、ビジネスのインベントリーを取り入れるために、カタログが使用されます。それは、ダイナミック広告、ショップ、ページサービスカードなど、さまざまな機能を強化するのに使用されます。これは統合の中では任意ですが、それらの機能には必須です。

実装の詳細とサポートされるフィールドについては、FBEのカタログAPIのドキュメントをご覧ください。

アプリがライブになるには、その前にアプリレビューによりアプリがカタログアクセス許可(catalog_management)の承認を得る必要があります。

ビジネスログインの実装の中のスコープパラメーターにcatalog_managementアクセス許可を追加します。それによりアプリは、ビジネス所有のカタログの作成、読み取り、アップデート、削除を実行できるようになります。

次のことを実行する方法を示すスクリーンキャストを使用した操作デモの用意ができたら、すぐにアプリレビューのリクエストを送信します:

  • オンボーディングフローでカタログアクセス許可をリクエストする
  • 接続されているカタログにインベントリーをプッシュする
  • カタログの同期後にカタログによって強化される機能が有効になる

Facebookのアプリレビューチームは、提出された手順情報とスクリーンキャストを使用することによって、カタログに関するアプリのFacebook統合をテストおよび検証します。却下された場合は、受け取ったフィードバックをよく読んで、その理由を理解してください。レビュー担当者に対してより多くの詳細情報を提供するためにアップデートされた情報を付して、レビューを再申請してください。

アプリレビューを成功させる方法、またFacebookパートナーマネージャに却下について知らせて助けを求める方法に関するさまざまなヒントについては、Facebookの「アプリレビュー却下結果ガイド」をご覧ください

アセットの選択は相互に関連しており、複数の理由で対象外になります。理由としては次のことが考えられます:

  • 選択されたページがすでに別のカタログとリンクされている
  • 該当カタログが別のコマースアカウントに関連付けられている
  • カタログがテストアプリで使用されている場合、同じカタログを本番用に使用することはできません

マイグレーション

FBE 2.0では、FacebookページまたはInstagramビジネスプロフィールを複数のパートナープラットフォームに接続できます(アプリIDに基づいて)。しかし、同じプロフィールは特定のパートナープラットフォームに1度しか接続できません。

いいえ。Messengerチャットについては、パートナープラットフォームが、ビジネスログインでbusiness_configmessenger_chatを設定することにより、それを有効にすることができます。ページショップについては、移行後にビジネス/販売店が管理ビューでそれを有効にする必要があります。

There is a guide to migrate from MBE 2.0 to 3.0 in our documentation, but you can reach out to your Meta partner manager or engineering contact with specific questions.

プラグイン

いいえ。現在それらの2つのプラグインはFBE管理ビューから廃止されています。2021年の時点でサポートされているプラグインは、メッセンジャーチャットのみです。

Messenger許可リストのドメインにはHTTPSが必要です。パートナーは、domainsフィールドのURLのプロトコルIDがhttps://になっていることを検証する必要があります

FBEMessengerChatConfigDataオブジェクトの設定方法について、詳細をご確認ください。

パートナーのほうがMessengerドメインの有効性を確認するのに有利な立場にあるので、ビジネス/販売店がドメインを設定しないようにした方が良いでしょう。パートナーはFBEビジネスログインのbusiness_configの中にmessenger_chat.domainsを設定したり、messenger_chat.enabled=falseを設定したりできます

後でビジネス/販売店は、管理ビューでMessengerプラグインを有効にすることができます。または、パートナーは、ビジネス/販売店が自分のプラットフォーム上で機能設定APIを通じてそれを行うための手段を用意することができます。

統合レビュー

統合レビューは、FBE連携がFacebookにより検証される処理です。アプリの統合レビューに合格した場合、一般のユーザー(つまりビジネスユーザーと販売店)がアプリを利用できるようになります。

統合レビューは、すべての要件実装の後、アプリのFBEの[開発者パネル] > [概要]タブでリクエストできます。レビュー処理が円滑に進むようにするため、実装したすべてのFBE機能のエンドツーエンド作業のデモ動画を、Facebookのレビュー担当者またはFacebook担当者と共有するようにしてください。

アプリのレビューが正常に完了するまで、FBEフローを開始できるのは、アプリの管理者と開発者のみです。

  • FBE開発者パネルの制限について詳しくは、こちらをご覧ください

Please reach out to your Meta partner manager, or submit a new integration review.

SDK / API / Webhooks / モバイル

はい、FBEはモバイルブラウザーでサポートされており、ネイティブAndroid/iOSアプリによりウェブビューを使用して起動できます。モバイルにおけるFBEの起動について詳細をご確認ください

グラフAPIの呼び出しを実行するには、アクセストークンが必要です。さまざまなタイプのアクセストークンの説明については、こちらをご覧ください。

管理ビューを起動する前にaccess_tokenを取得するためにFacebookログインを呼び出してから、そのaccess_tokenを使用して機能設定APIを呼び出すことができます。

サンプルコード:

  function launchFBEManagementView(access_token) {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: <EXTERNAL_BUSINESS_ID>,
    }, function(response){
      // call Feature Configuration API with access_token here
    });
  }

    FB.getLoginStatus(function(response) {
    if (response.status === 'connected') {
      // returns a User Access Token with scopes requested
      access_token = response.authResponse.accessToken;

      // launch Management View
      launchFBEManagementView(access_token);
    } else {
      FB.login(function (response) {
        if (response.authResponse) {
          // returns a User Access Token with scopes requested
          access_token = response.authResponse.accessToken;

          // launch Management View
          launchFBEManagementView(access_token);
        } else {
          console.log('User cancelled login or did not fully authorize.');
        }
      }, {});
    }
  });

ショップ

オフサイトまたはオンサイトのフローでInstagramショッピングを使用するには、Instagramビジネスアカウントが必要です。個人のInstagramアカウントは対象外です。Instagramビジネスアカウントでプレゼンスを確立していない場合、または対象となる商品を販売していない場合、そのアカウントは対象外となる可能性があり、6か月以内に再認証をリクエストできます。利用要件をご覧ください。

1つのコマースアカウントでは、オフサイトショップかオンサイトショップのいずれかが可能です。オンサイトショップとオフサイトショップを相互に変換することもできます。ビジネスでオフサイトショップとオンサイトの両方が必要な場合、アセットの異なる2つのオンボーディングフローが必要になります。

アセットの選択は相互に関連しており、複数の理由で対象外になります。理由としては次のものがあります:

  • ユーザーがそのページを所有するビジネスの管理者ではない
  • ページが別のビジネスマネージャに関連付けられている

お問い合わせ

Facebookチームから直接支援を受けるには、ビジネスマネージャのダイレクトサポートツールを使用してください:

  • アポイントメント、予約、料理注文パートナー: さまざまなサービスのFacebook Business Extensionのトピックを使用してください
  • コマースパートナー: マーケティングパートナー: 技術サポートのトピックを使用するか、またはFacebookパートナーマネージャに直接お問い合わせください。

[ダイレクトサポート]ドロップダウンメニューの中に該当するトピックがない場合は、アクセス方法についてメールでFacebookパートナーマネージャの担当者までお問い合わせください。

ダイレクトサポートには、ビジネスマネージャとの強力な統合機能があります。それで、質問やバグ情報を提出するためにダイレクトサポートツールを使用する可能性のあるすべてのチームメンバーを、自分の会社のビジネスマネージャのユーザーとして追加してください。その方法について詳しくは、こちらにある手順をご覧ください。

Throughout the FBE onboarding UI there is a “Having an Issue? Contact Us” link at the bottom of the page. Merchants should use this link to get FBE support.