Audience NetworkレポートAPI V2とFacebookログインの統合

Facebookログインは、Audience NetworkレポートAPIデータへのアクセスを許可するための新しい手段です。これは、収益化マネージャインターフェイスからシステムユーザートークンをコピーペーストする従来の方法を置き換えるアプローチです。収益化マネージャトークンの場合はビジネスの部外者への漏洩リスクがありますが、このアプローチではより安全にユーザーのデータにアクセスできます。

このドキュメントの主な目的は、パブリッシャーに代わってレポートAPIデータにアクセスするダイレクトレポートAPI統合パートナー、モバイル測定パートナー、メディエーションパートナーといったFacebookパートナーを対象に、ガイダンスを提供することです。

レポートAPIデータの取得にサードパーティを使用している場合

すでにパートナー(モバイル測定パートナーまたはメディエーションパートナー)を利用している場合、追加のコーディング作業を行う必要はありません。パートナーがFacebookログインフローを統合していることを確認してください。「FBでログイン」オプションをクリックし、生成するトークンでアクセスできるようにするプロパティを選択する必要があります。

すべてのプロパティを選択した場合、トークンは、トークンを作成したユーザーがビジネスマネージャのプロパティにアクセスできる限り、ビジネスのすべてのプロパティへのアクセスを提供します。

アクセス許可

レポートAPIを直接使用する必要がある場合は、まずFacebookアプリを作成し、必要なアクセス許可を取得する必要があります。アプリがAudience NetworkレポートAPIデータにアクセスするには、read_audience_network_insightsアクセス許可が必要になります。アプリのためにこのアクセス許可を取得するには、ビジネスがAudience Networkにオンボーディングする必要があります。

• 収益化マネージャにオンボーディングしたら、Facebook開発者ページに移動し新しいビジネスアプリの作成を開始します

• ビジネスアカウントのフィールドで、新たに作成したビジネスを選択します

これでアプリがAudience Networkにオンボーディングされ、read_audience_network_insightsアクセス許可を使用できるようになります。read_audience_network_insightsが表示されない場合は、アプリが収益化マネージャビジネスアカウントにアクセスできるビジネスにリンクされていることを確認してください。

Facebookログインですでにread_insights permissionを取得している場合はそれを利用することもできますが、read_audience_network_insightsアクセス許可を使用することをおすすめします。

レポートAPIへのアクセス方法は、統合の種類によって異なります。以下のうち、自分のケースに該当する指示に従ってください。

• UIインターフェイスなしの直接API統合
• UIインターフェイスありの直接API統合

UIインターフェイスなしの直接API統合

フロントエンド/UIインターフェイスなしのカスタム(直接)レポートAPI統合があり、それを使用して自分のビジネスのデータのみをクエリする場合、以下の指示に従ってレポートAPIにアクセスできます。

グラフAPIエクスプローラでユーザートークンを作成する

1. アプリですでに「マーケティングAPI」を使っている場合は、このステップをスキップします。それ以外の場合は、read_audience_network_insightsアクセス許可の取得に関する手順に従ってください。
2. グラフAPIエクスプローラを開きます。
3. アプリを選択する
4. read_audience_network_insightsアクセス許可([許可] > [イベントグループページ]と選択すると見つかります)を選択し、[アクセストークンを生成]をクリックします。
1. このトークンを収益化マネージャから得たトークンの代わりに使用することで、Audience NetworkレポートAPIデータに短時間アクセスできるようになります。
2. 免責事項: このトークンは2時間で期限切れになります。以下の手順に従って長期アクセストークンに切り替える必要があります。

作成したトークンを長期アクセストークンに切り替える

1. アクセストークンデバッガに移動します。
2. トークンを挿入し、[デバッグ]を押します。
3. すべてのトークン情報を掲載した表の一番下までスクロールして、[アクセストークンを延長]ボタンをクリックします。

4. 生成されたトークンをコピーします。

このトークンでAudience NetworkレポートAPIデータにアクセスできるようになりました。

UIインターフェイスありの直接API統合

以下のガイドは、Facebookログインボタンを配置できる独自のUIインターフェイスを持つパブリッシャーやパートナーを対象としています。このガイドは、独自のデータにアクセスするパブリッシャーや、他のパブリッシャーの収益化データにそのアクセス許可を使ってアクセスするパートナーにご活用いただけます。

以下のガイドのエンドツーエンドデモビデオ(上記のアクセス許可のステップを含む)も参照できます。

何らかのエラーが発生しました

エラーが発生し、この動画を再生できませんでした。

詳しくはこちら

• 開発者ポータルで、前のステップで新規作成したビジネスアプリを選択します。
• このアプリに新しい「Facebookログイン」製品を追加します。

• [ウェブ]オプションを選択し、統合の手順に従います。

• Facebookログインエクスペリエンスを表示するウェブサイトURLを挿入してください。このURLは、HTTPS プロトコルをサポートするものでなければなりません。

• 統合ステップの終わりに、自身のサイトにFacebookログインを統合するためのサンプルコードが提供されます。このコードをコピーできますが、提案されているpublic_profile,emailアクセス許可ではなく、新たにアクセスされたread_audience_network_insightsアクセス許可を利用してください。この新しいアクセス許可を使うと、ボタンコードは次のようになります。

<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>

• アプリのFacebookログインの製品設定ページで、JavaScript SDKが有効になっていることを確認してください

• これでユーザーは、対象のページでFacebookログインフローを実施して、アクセストークンを生成できるようになります。
• アクセストークンは、前のステップのstatusChangeCallback JavaScriptメソッドに渡された引数の一部として返されます。

• デフォルトでは、このトークンは約2時間で期限切れになります。
• 開発者は、このトークンをユーザーインタラクションの追加なしの長期アクセストークンに拡張するリクエストを出すことができます。

  • 長期トークンは、FacebookのサーバーへのレポートAPIリクエストが行われるタイミングで、1日1回更新されます。リクエストがまったく行われないと、トークンは約60日後に有効期限切れになり、利用者は新しいトークンを生成する必要があります。
• このトークンを通じて入手可能なデータは、このFacebookログインフローを行った人や、どのようなデータを共有することに同意されたかによって大きく左右されることに注意してください。そのため、ビジネス従業員がこのフローを実行している場合、結果として得られるアクセストークンはその従業員と同じ権限を持つことになります。

トラブルシューティング