アドネットワーク連携ガイドとそのテスト

最初のステップは、AppsFlyerにおけるクリック計測URLを定義することです。ユーザーが広告をクリックした時に、アドネットワークの計測リンクからAppsFlyerの計測リンクへのリダイレクトが行われます。

エンドユーザーのクリックから最終遷移先（アップストア）へのリダイレクトフローは以下の通りとなります。

今後の全てのキャンペーンに於いては計測URLを同じ形式にすることを推奨します。

以下のAppsFlyerの基本的な計測リンクと、各マクロの詳細な雪面を参照してください。

https://app.appsflyer.com/app_id?pid=mediaName_int&c={campaign}

AppsFlyerベースURL	説明
https://app.appsflyer.com	AppsFlyerエンドポイント
app_id	アプリのユニークID - アプリ毎に変更されるダイナミックな値 (AppsFlyerによって自動的に付与されます)  例 Android - com.appsflyer.sample iOS - id1234123412
pid=	各アドネットワークを識別するために 〇〇_int で指定しています (AppsFlyer側で付与されます)

上記に加えて、各アドネットワークで利用可能なマクロを指定してURLにパラメーターを追加することができます。例：クリックID、パブリッシャーID、キャンペーンID、広告タイプ、コスト、等。これらのマクロはアドネットワークにポストバックを送信する時にAppsFlyer側で使用されます。

マクロを使用することによってAppsFlyerがポストバックに返すデータをアドネットワーク側で指定することができます。

以下に最も使用されているマクロの一覧になります:

名称	説明	パラメータ名	フィールドタイプと文字数
キャンペーン名	キャンペーン名	c	String型 - 最大100文字まで
IDFA (iOSのみ)	クリック / インプレッションから受信したのiOS端末のIDFA	idfa	String型 - 最大40文字まで
GAID (Androidのみ)	クリック / インプレッションから受信したのAndroid端末のGAID	advertising_id	String 40
Click ID	アドネットワークの固有となるクリックID	clickid
パブリッシャーID/配信面	アドネットワークのパブリッシャーID。複数のパブリッシャーと連携している場合、site IDを使用して識別できます。	af_siteid	String型 - 最大24文字まで
サブパブリッシャーID	アドネットワークのサブパブリッシャーIDアドネットワークの発行元に追加のサブパブリッシャーまたはサイトIDがある場合、サブサイトIDを使用してそれらを識別することができます。	af_sub_siteid	String型 - 最大50文字まで
コスト 1. コストモデル (例 CPI, CPC, CPA) 2.コスト値（数字で表した実際のコスト– 1.99、など） 3.コスト通貨（例:USD)	キャンペーン / 広告セット / 広告の費用。広告主がROI及びeCPIを確認できるように必要なメトリックになります。	コスト af_cost_model af_cost_value af_cost_currency	String型 - 最大20文字まで String型 - 最大20文字まで Enum 3
Ad Type	以下の項目のいずれかを使用して、値を返してください： search_text banner interstitial video rewarded_video playable sponsored_content audio	af_ad_type	String型 - 最大24文字まで
インセンティブまたは非インセンティブキャンペーン	true/false	is_incentivized
サーバー側のクリックまたはAppsFlyerリダイレクト	true/false	is_s2s

利用可能なマクロの一覧については こちらをご参照ください。

例:

基盤となる計測リンクのテンプレート：

https://app.appsflyer.com/com.appsflyer.sample?pid=mediaName_int

Androidの計測リンクのパラメータ例：

https://app.appsflyer.com/com.appsflyer.sample?pid=mediaName_int&clickid={clickid}
	  &c={campaign}&advertising_id={advertising_id}
	  

最終的な計測リンクは、以下のような形になります。

https://app.appsflyer.com/com.appsflyer.sample?pid=mediaName_int&clickid=123456
&c=test_campaign&advertising_id=1a11a11a-2b2b-3c3c-4d4d-111a1a11a111

iOSの計測リンクのパラメータ例：

https://app.appsflyer.com/id123412312?pid=mediaName_int&clickid={clickid}&c={campaign}&idfa={idfa}
	  

最終的な計測リンクは、以下のような形になります。

https://app.appsflyer.com/id123412312?pid=mediaName_int&clickid=123456
	  &c=test_campaign&idfa=AAA11AA-B2BB-333C-D4444444444
	  

インプレッション計測

AppsFlyerではインプレッション経由の計測も取得することができます。

AppsFlyerにインプレッションデータを送信するには、上記の計測リンクと同じ構造を使用します。原則、クリックURLと同じパラメータがインプレッション計測にも使用されますが、以下の点が異なります。

1. URL ベース - http://app. から http://impression に差し替える。

2. ルックバックパラメータ - af_click_lookback を af_viewthrough_lookback に置き換えてください。

正しくインプレッション経由のインストールを計測するにはアドネットワーク側より端末IDを含める必要があります。

詳細についてはこちらをご参照ください。

次に、インストールポストバックを指定する必要があります。インストールポストバックとはインストールが成果として上がった場合、それをアドネットワークに送信されるリクエストです。また、計測URLに含まれたすべての関連マクロが送信されます。

例:

http://YourDomain.com/postback?clickid={clickid}&af_siteid={affiliate_id}

インストールポストバックの構成はアドネットワーク側の設定に応じて変更できます。

利用可能なパラメーターの一覧についてはこちらをご参照ください。

AppsFlyerではインストールポストバック毎に固定パラメーターを指定することも可能です。その場合、ポストバックを許可するための広告主IDとキー、またはパスワードで設定することができます。

なお、これらのパラメーターは広告主によってAppsFlyerの管理画面にて追加されます。

自社経由のインストール成果に加えて、AppsFlyerでは他社経由のインストールもポストバックを送信することもできます。これらのポストバックは「can claim」と呼ばれる特定のパラメーターでフラグを追加することができます。

&can_claim=1 自社経由からインストールを意味する。

&can_claim=0 他社経由またはオーガニックからのインストールを意味する。

http://yourdomain.com/AppsFlyer?clickid={clickid}&can_claim={1\0}

クリックIDなど特定のパラメーターが含まれていない場合、他社経由のインストールだと判断されます。

以下の手順はアプリ内イベントポストバックを受信できるアドネットワークのみ該当します。

3番目のステップでは、アプリ内イベントポストバックのエンドポイント及びマクロを指定します。

アプリ内ポストバックとはアプリ内イベントが成果として上がった場合、それをアドネットワークに送信されるリクエストです。また、アプリ内コンバージョンを測定する際にインストールコンバージョンに基づいてどのアドネットワーク経由で特定のイベントが発火したのかで判断されます。次に、AppsFlyerはアプリ内イベントをそのアドネットワークにアトリビューションします。

アプリ内イベントポストバックの例：

http://YourDomain.com?clickid={clickid}&event_name={event-name \ mapped-iae}&currency={currency}&value={revenue}

インストールポストバックで使用可能なパラメーターはアプリ内イベントポストバックでも利用できます。 利用可能なマクロの一覧についてはこちらをご参照ください。

イベントタグを指定して広告主が送信できる情報を事前に決めるか、またはイベントタグを入力可能なままにして、広告主がフリーテキストイベントを指定できるようにすることができます。

フリーテキストイベントタグの例：

事前に指定されたイベントタグの例：

以下の手順はリターゲティングキャンペーンを配信しているアドネットワークのみ該当します。

リアトリビューション - ターゲットを絞ったユーザーに対してリターゲティングキャンペーンでアプリを再インストールさせる。

リアトリビューションだとみなしたユーザーに対して受信するポストバックを指定します。

次の中から選択できます:

1. リアトリビューションのフラグが含まれているインストールポストバック
2. リアトリビューションのフラグが含まれているアプリ内イベントポストバック
3. カスタムポストバック

計測リンクの構造や関連するパラメータなど、リターゲティング（リアトリビューションとリエンゲージメント）計測の詳細については、こちらのページを参照してください。

以下の手順はリターゲティングキャンペーンを配信しているアドネットワークのみ該当します。

リエンゲージメント - アプリをインストールした既存のユーザーがリターゲティングキャンペーンによって復帰した時。

リエンゲージメントユーザーに対して受信するポストバックを指定します。

次の中から選択できます:

1. リエンゲージメントのフラグが含まれているインストールポストバック
2. リエンゲージメントのフラグが含まれているアプリ内イベントポストバック
3. カスタムポストバック

計測リンクの構造や関連するパラメータなど、リターゲティング（リアトリビューションとリエンゲージメント）計測の詳細については、こちらのページを参照してください。

インストール計測をテストするための計測リンクをまずは作成しましょう。

以下の計測リンクをコピーしてください。

https://app.appsflyer.com/com.appsflyer.adNetworkTest?pid=YOUR_PID&c=YOUR_CAMPAIGN
	  &af_click_lookback=7d&af_click_lookback=7d&clickid={clickid}
	  

以下のパラメータを変更してください。

1. pid(YOUR_PID) - AppsFlyerから指定された、あなたのpidを入力してください。
2. c (YOUR_CAMPAIGN) - 任意のキャンペーン名を入力してください。
3. clickid - 乱数または任意のIDを入力してください。

テスト端末に計測リンクを送信し、ブラウザ上でリンクを開いてアプリをインストールしてください。

アプリが起動されると、次の画面が表示されます。

このメッセージが表示されない場合は、計測リンクが正しく設定されていることを確認し、アプリを一度アンインストールしてから計測リンクを使用してアプリを再インストールしてください。

アプリをダウンロードして初回起動すると、管理画面にその結果が表示されます。

AppsFlyerの管理画面を開いてください。

アプリ内イベントのテストを開始する前に、広告主側で実装したAppsFlyerのアプリ内イベントをあなたのアドネットワーク用にマッピングする必要があります。

AppsFlyerの管理画面で、連携済みパートナー をクリックして、ご自身のアドネットワークを選択してください。連携タブでアプリ内イベントポストバックの箇所までスクロールしてください。アプリ内イベントを選択して、必要な場合には対となるイベントにマッピングしてください：

スクロールダウンして、保存をクリックしてください。

AppsFlyerへ送られるアプリ内イベントは、同じくそのアプリのインストールを発生させたアドネットワークにも紐付けて計測されます。アプリ内イベントの計測はアプリ内から直接テスト可能です。

アプリを起動したら、 EVENT TRACKING TESTをクリックしてください。

次の画面で、好きなボタンをクリックしてアプリ内イベントを発火させてください。

インストール計測をテストするための計測リンクをまずは作成しましょう。

あなたのアドネットークの要件と計測したいデータに沿う形で、計測リンクにパラメータを追加してください。

テスト端末に計測リンクを送信し、ブラウザ上でリンクを開いてアプリをインストールして起動してください。

アプリを起動することが計測フローにとって非常に重要になり、アプリが起動されなければ何も計測されません。

アプリ起動後に、管理画面上でアプリのインストールが確認できるようになります。

計測リンクを作成してください。手順は、上記の手順と同様のものを使用可能です。計測リンクをテスト端末へ送信して、テスト端末のブラウザを使ってリンクを開いてください。

次の画面が表示されます。

この画面表示が理想の挙動の結果です。アプリはまだリリースされていないため、計測リンクはどのアプリストアにも遷移しません。ただし、計測リンクは計測を行うという目的においては引き続き機能します。計測リンクと付与されたパラメータはAppsFlyerのクリックサーバーによって記録され、そのデータはインストール計測に使用されます。

広告主から提供されたアプリデータをテスト端末上でインストールして、アプリを起動してください。次にアプリを一度削除して、(複数件インストールを発生させるために)同じプロセスを繰り返してください。そうすることで、管理画面上でインストールが確認できるようになります。

広告主が 「 アプリ内イベントのポストバック設定 」の権限を付与すれば 、アドネットワーク側でもアドネットワークのサーバーに送信するアプリ内イベントをマッピングすることが可能です。

AppsFlyerの管理画面で、連携済みパートナー をクリックして、ご自身のアドネットワークを選択してください。連携タブでアプリ内イベントポストバックの箇所までスクロールしてください。アプリ内イベントを選択して、必要な場合には対となるイベントにマッピングしてください：

広告主が計測するアプリ内イベントとイベントのマッピングがわかったら、インストールしたアプリからアプリ内イベントをいくつか発火させてください。

アプリ内イベントのポストバックレポートでは、Postback URLやマッピングされたパラメータのデータを確認することができます。ポストバックレポート内のデータとサーバー内のデータと比較し、ポストバックされたデータが正しくサーバー側で記録されていることを確認してください。

アプリ内イベントのポストバックレポートを取得すると、レポートを確認することで以下のことが確認できます。

1. Media Sourceの列で、あなたのアドネットワークにイベントが紐付けられていること
2. Event Nameの列で、イベント名が正しいこと
3. ポストバックが有効な場合には、Postback URLの列でイベント名とイベントの値が含まれていること
4. Postback URLの列で、アプリ内イベントが正しくマッピングされていること

AppsFlyerを利用している広告主との計測連携をご希望の場合には、まずAppsFlyerの連携済みパートナーである必要があります。

Appsflyerのパートナーアカウントに登録するには、まずこちらのフォームを記入してください。追って、PDMチームからご連絡いたします。フォームを記入する際は、AppsFlyerでこれまで一度も使用したことのないメールアドレスを記載してください。 

AppsFlyerとの連携設定(ポストバックのエンドポイントなど)を更新したい場合には、新旧のアップデート内容の詳細を添えて、日本オフィスのパートナー担当(elina.watanabe@appsflyer.com / shuntaro@appsflyer.com)までご連絡ください。また、ご連絡いただく際には、必ず連携しているpidの情報も添えてください。

広告主は、アドネットワーク(パートナー)との連携設定を行う権限をそのアドネットワーク自体に付与することができます。

広告主側で行われたアドネットワークとの連携設定を編集および変更する権限があれば、連携媒体としてキャンペーン設定を簡単にテストすることができます。

付与可能な権限は以下です。(広告主側の契約によって異なります。)

• 連携設定
• アプリ内イベントのポストバック設定
• リテンションレポート
• Protect360管理画面

詳細については、アドネットワークへの権限付与のページを参照してください。

インストールの情報は、インストールの体mングから最長2分までの間に管理画面上に表示されます。

インストールとアプリ内イベントのローデーターレポートが作成されるまでには、最大15分かかります。

AppIDを検索する画面でアプリを追加出来ない場合には、まず広告主側でそのアプリが管理画面上に追加されていることを確認してください。

広告主と一緒にインストール計測のテストをしてもAppsFlyerの管理画面上にインストールが表示されない場合には：

1. テストに使用している端末を、広告主がホワイトリストに登録していることを確認してください。
2. S2Sのフィンガープリンティング計測を使ってキャンペーンを行う場合には、連携自体がホワイトリストに登録されていることを確認してください。詳細は担当のPDMまでご連絡ください。

ポストバックがサーバーに送信されていないと思われる場合には：

• ポストバックのエンドポイントがアクティブな状態であることを確認してください。
• ポストバックのエンドポイントが正しいかどうかを確認してください。修正が必要な場合には、担当PDMまでお問い合わせください。

アプリ内イベントのポストバック設定は、広告主管理画面上であなたのアドネットワークの設定画面において行われる必要があります。

• まずは、アプリ内イベントのポストバック設定を有効にしてイベントをマッピングするよう広告主に依頼してください。
• 広告主がアプリ内イベントのポストバック設定権限を付与している場合には、 連携タブ内のアプリ内イベントポストバックのトグルがONになっていることを確認してください。
• SDK Event Nameと、媒体側で独自に定義されているイベント名をマッピングする必要があります。
  
  

  
  

広告ネットワークは、広告主アカウント上で行われた連携設定を確認することができますが、代理店アカウント上で行われた設定は確認できません。そのため、広告主ではなく代理店がアプリ内イベントのポストバック設定を行った場合、アドネットワークから見るとこのセクションを非アクティブと表示されますが、実際には代理店アカウント上ではアクティブになっています。

ポストバックデータの中にクリックに関するデータが見つからない場合は、AppsFlyerの計測リンクに、ポストバックで返送するべき全てのデータが含まれていることを確認してください。詳細は計測リンクガイドを参照してください。

広告主側で全データのポストバックを受信するようにアドネットワークの連携設定を行った場合、そのアドネットワークに紐付けられていないインストール経由で発生したイベントのポストバックには、クリックデータは含まれません。

AppsFlyerの計測リンクを、リダイレクトURLとしてあなたのサーバーに設置する必要があります。次に、アドネットワーク側の独自の計測リンクを使用して、完全はテストを実施してください。

自身のアドネットワーク側の計測リンクのパラメータがAppsFlyer側の計測リンクにマッピングされていることを確認してください。

管理画面上にデータが表示されているのにそのデータがあなたのサーバー上では表示されない場合には、広告主側でアドネットワークの連携設定を行う際に必要なIDやキーなどの情報が正しく入力されているかどうか確認してください。

広告主は、アドネットワークによっては[ 連携 ] タブの [ General Settings ]のセクションにある、ID、キー、トークンなどの情報を連携時に入力する必要があることがあります。

もしもあなたのアドネットワークが連携において各種IDやキーの入力を必要とするのに対し、広告主側で入力がされていなかった場合、AppsFlyerからのポストバックがアドネットワーク側のサーバーによって受信を拒否されることがあります。ポストバックデータをサーバーに送信できないため、結果的にデータがサーバー上にないのです。

広告主と一緒に連携をテストするも、インストール、アプリ内イベントのデータが利用できない場合には、以下のステップに従ってください。

• どの広告主においても問題が発生した場合には、担当のPDMまでお問い合わせください。
• 特定の広告主または少数の広告主で問題が発生した場合：
  — アプリにAppsFlyer SDKを実装していることを広告主と確認してください。
  — SDKの実装が正しいことを広告主と確認してください。

広告主から計測連携の設定を依頼されているのに対し、実際の連携設定画面はロックされた状態ですべての選択肢がグレーアウトされている場合があります。

その際には、広告主に対し連携を設定するためのアドネットワークへの権限付与作業を依頼してください。