計測リンクを使用して、クリックとモバイル広告のインプレッションに関連するユーザーアクティビティを記録します。
ユーザーが計測リンクをクリックすると、URLがAppsFlyerに送信され、ユーザーはアプリをダウンロードするようにリダイレクトされます。AppsFlyerでは、リンクに含まれる関連するパラメーターが解析され、ローデータレポートの生成に使用されます。
AppsFlyerの基本計測リンク
基本の計測リンクは、クリックを記録し、ユーザーをアプリのダウンロードページにリダイレクトするための最小限の情報で構成されています。'?' の後に追加のパラメーターを追加することで、追加情報を記録します。
http://app.appsflyer.com/{app_id}
基本計測リンクには、Apple iTunes / App StoreアプリのアプリケーションID, またはGoogle Playのパッケージ名である{App_id}パラメーターが含まれています。
例
http://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822計測リンクのパラメーター
次のパラメータは作成された計測リンク内でご利用可能です。
フィールドタイプ列の数値は、パラメーター値の文字制限です。パラメーター値の長さの制限について詳しくは、こちらをご覧ください。
| パラメーター名 | 表示名 | 説明 |
フィールドタイプ |
|---|---|---|---|
| pid | メディアソース | メディアソース名。AppsFlyerが連携パートナーに付与する固有の値（PIDなど）であり、変更不可。詳細情報 |
String型 - 最大50文字まで |
| c | キャンペーン | キャンペーン名。広告主/もしくは媒体によって設定されます。長さが100文字を超えるものは、"c_name_exceeded_max_length"と管理画面に表示されます。 |
String型 - 最大100文字まで |
|
af_prt |
代理店 |
代理店識別子。新規インストールを代理店に関連付けることができます。 |
String型 - 最大50文字まで |
|
af_mp |
マーケティングパートナー |
主要なパブリッシャーのマーケティングパートナーが、インストールごとにポストバックを受信できます。 注意 ：現在、このパラメーターはPinterest Marketing Partnerのみに関連しています。 |
|
|
clickid |
N/A |
アドネットワークの固有となるクリックID |
|
|
af_siteid |
Site ID |
アドネットワークパブリッシャーID |
String型 - 最大24文字まで |
|
af_sub_siteid |
Sub Site ID |
アドネットワークのサブネットワーク/パブリッシャーID |
String型 - 最大50文字まで |
|
af_c_id |
Campaign ID |
キャンペーンID。広告主かパブリッシャーにより設定。 |
String型 - 最大24文字まで |
|
af_adset |
Adset |
広告セット名。広告主かパブリッシャーにより設定。広告セットはキャンペーンと広告間の中間レベルの階層に属します。詳細はこちらをご確認ください。 |
String型 - 最大100文字まで |
|
af_adset_id |
Adset ID |
広告セットID。広告主かパブリッシャーにより設定。 |
String型 - 最大24文字まで |
|
af_ad |
広告 |
広告名（詳細を参照）。広告主かパブリッシャーにより設定。 |
文字列 - 最大100文字まで |
|
af_ad_id |
Ad ID | 広告ID。広告主かパブリッシャーにより設定。 |
String型 - 最大24文字まで |
|
af_ad_type* |
Ad Type |
広告タイプ - 次の規則のいずれかを使用します： |
String型 - 最大24文字まで |
|
af_click_lookback |
Lookback Window for Click Attribution（クリックアトリビューションのルックバック期間）。この有効期間は、新規ユーザーが表示中の元の広告/リンクと関連付けられる最大CTIT（クリックからインストールまでの時間）を指します。 |
クリックアトリビューションのルックバック期間の日数は設定変更が可能です。 設定可能なパラメーター値：1d～30d（日数）、または1H～23H（時間） デフォルト値は7日間です。 注 ：クリックURLのみに影響し、インプレッションURLには影響しません。 |
最大3文字まで |
|
af_viewthrough_lookback |
Lookback Window for View-through Attribution（ビュースルーアトリビューションのルックバック期間） |
ビュースルーアトリビューションのルックバック期間の日数は設定変更が可能です。 設定可能なパラメーター値：1h～48h（時間）または1d～7d（日数）。 デフォルト値は1日です。 注 ：インプレッションURLにのみ影響し、クリックURLには影響しません |
最大3文字まで |
|
is_retargeting |
Is Retargeting Campaign? |
すべてのリターゲティングキャンペーンのクリックURLには、 |
列挙（Enum）型 - 5文字 |
|
af_reengagement_window |
Re-Engagement Window |
このパラメーターを計測リンクに追加して、 リエンゲージメントアトリビューションウィンドウを変更します。 可能なウィンドウ範囲オプションは次のとおりです。
デフォルト値：30日 例： |
最大3文字まで |
|
af_channel |
Channel |
広告が配信されるメディアソースチャネル。例： UAC_Search、 UAC_Display、 Instagram、Facebook Audience Network など。 |
動的列挙文字列型 - 最大20文字まで |
|
af_keywords |
Keywords |
テキストによるターゲティングキャンペーンのキーワードリスト |
String型 - 最大100文字まで |
|
af_cost_model |
Cost Model |
コストモデル。現在サポートされているのはCPI（デフォルト）モデルのみです。管理画面の概要ページなどに表示される、AppsFlyerの集計データのコスト値を追加できます。 |
String型 - 最大20文字まで |
|
af_cost_currency |
Cost Currency |
通貨コード（USD、EURなど）。設定可能な通貨コードはこちらを参照してください。デフォルト値はUSD（米ドル）です。 |
列挙（Enum）型 - 最大3文字 |
|
af_cost_value |
Cost Value |
コンバージョンコスト値。 小数点以下4桁まで対応しています。 重要："56"、"2.85"など、数値のみ設定可（必要に応じて小数点を使用）。 |
String型 - 最大20文字まで |
|
af_sub1 |
Sub Param 1 |
サブスクライバーパラメータ1。広告主が設定するオプションのカスタムパラメータ。これらのパラメータの使用方法の詳細については、FAQセクションを参照してください。 |
String型 - 最大100文字まで |
| af_sub2 | Sub Param 2 | サブスクライバーパラメータ2 | String型 - 最大100文字まで |
| af_sub3 | Sub Param 3 | サブスクライバーパラメータ3 | String型 - 最大100文字まで |
| af_sub4 | Sub Param 4 | サブスクライバーパラメータ4 | String型 - 最大100文字まで |
| af_sub5 | Sub Param 5 | サブスクライバーパラメータ5 | String型 - 最大100文字まで |
| af_r | N/A | 両プラットフォーム（Android/iOS）のユーザーを指定されたURLへリダイレクトします。 | |
| af_web_dp | N/A | デスクトップユーザーを、OneLinkテンプレートで設定したページ以外の別のWebページにリダイレクトします。このパラメータを使用して、他のプラットフォーム（Google AnalyticsやOmnitureなど）において デスクトップユーザーのアトリビューションデータを確認できます。 | |
| af_dp | N/A | ユーザーがディープリンクで転送されるアプリの内部アクティビティのパス。ディープリンクとリターゲティングで使用します。 | |
| af_force_deeplink | N/A | af_dpの値で指定されたアクティビティに、強制的にディープリンクさせます。 | |
| af_ref | N/A |
S2S（サーバー間）連携しているアドネットワークでは、次のパラメーターを使用してクリックの固有リファラー値を送信できます。 &af_ref=ReferrerValue
af_refの値は、必ず固有の値で構成します。構成は次のとおりです。
NetworkName_UniqueClickValueForEachClick
例：af_ref=networkname_123456789ABCDEF
ネットワーク名は文字列で自由に設定できます。例：networkname_int もしくは networkname でも可能
AppsFlyerはAndroidデバイスにおけるアトリビューションにこのパラメーターを使用することがあります。AppsFlyerは、iOSもしくはWindowsデバイスにおけるアトリビューションにはこのパラメーターは使用しません。
|
|
| is_incentivized | true/false |
インセンティブまたは非インセンティブのキャンペーン
|
|
| af_param_forwarding | falseに設定すると、計測リンクにあるパラメーターはリダイレクトされたページに転送されません |
リダイレクトされたページでシンプルなURLに使用するか、リダイレクトされたページでのクエリーパラメーターの処理が原因で計測リンクパラメーターが問題を引き起こす可能性がある場合に使用します。
|
* 広告タイプに応じて、エンゲージメントの仕様を詳述する関連するビューワビリティパラメーターを送信することもできます。以下は、「af_ad_type」の有効な値と、予想されるビューワビリティパラメータのリストです。
| パラメータ名 | 値の形式 | 説明 |
|---|---|---|
| af_video_total_length | 動画の可能な総時間 | |
| af_video_played_length | 動画がどれだけ視聴されたか | |
| af_playable_played_length | 完全にロードされてから再生可能な要素が再生された時間 | |
| af_ad_time_viewed | 広告ユニットが画面に表示されていた時間 | |
| af_ad_displayed_percent | デバイス画面に表示された広告ユニットの最大割合 | |
| af_audio_total_length | 動画の可能な総時間 | |
| af_audio_played_length | どれくらいの音声が聞こえたか |
Android用パラメータ
| パラメータ名 | 表示名 | 説明 |
フィールドタイプ |
|---|---|---|---|
|
advertising_id |
Advertising ID |
Google Advertising ID 。アドネットワークのサポートが必要です。 |
最大40文字まで |
|
sha1_advertising_id |
N/A |
SHA1でハッシュ化されたGoogle Advertising ID 。アドネットワークのサポートが必要です。 |
|
|
md5_advertising_id |
N/A |
MD5でハッシュ化されたGoogle Advertising ID - アドネットワークのサポートが必要 |
インストールとリアトリビューションのみでサポート |
|
android_id |
Android ID |
端末のAndroid_id 。アドネットワークのサポートが必要です。 |
最大20文字まで |
|
sha1_android_id |
N/A |
SHA1でハッシュ化された端末のAndroid_id 。アドネットワークのサポートが必要です。 |
|
|
md5_android_id |
N/A |
SHA1でハッシュ化された端末のAndroid_id 。アドネットワークのサポートが必要です。 |
インストールとリアトリビューションのみでサポート |
|
imei |
imei |
デバイスIMEI ID |
|
|
sha1_imei |
N/A |
SHA1でハッシュ化されたデバイスIMEI ID - アドネットワークのサポートが必要 |
|
|
md5_imei |
N/A |
MD5でハッシュ化されたデバイスIMEI ID - アドネットワークのサポートが必要 |
|
|
oaid |
OAID |
匿名デバイスIDを開く (Open Anonymous Device Identifier) |
Android SDKバージョン4.10.3以降で利用可能 |
|
sha1_oaid |
N/A |
SHA1でハッシュ化されたOpen Anonymous Device Identifier - アドネットワークのサポートが必要 |
Android SDKバージョン4.10.3以降で利用可能 |
|
md5_oaid |
N/A | MD5でハッシュ化されたOpen Anonymous Device Identifier - アドネットワークのサポートが必要 | Android SDKバージョン4.10.3以降で利用可能 |
|
af_android_url |
N/A |
AndroidユーザーをGoogle Playストアアプリのページ以外の別のURLにリダイレクトします。ストア以外のアプリに使用します。 |
|
|
sha1_el |
N/A |
デスクトップからモバイルへの計測の場合のみ。SHA1でハッシュ化されたemail。アドネットワークのサポートが必要です。 |
|
|
fire_advertising_id |
N/A |
Amazon Fire端末用の広告ID |
|
iOS固有パラメータ
| パラメーター名 | 表示名 | 説明 |
フィールドタイプ |
|---|---|---|---|
|
idfa |
IDFA |
Appleの広告ID。大文字を使用する必要があります。アドネットワークのサポートが必要です。 |
最大40文字まで |
|
af_ios_url |
iOSユーザーをiTunesアプリストアページ以外の別のURLにリダイレクト |
ランディングページのリダイレクションに使用します。 |
|
|
af_ios_fallback |
N/A |
IOS 10.3ユーザー向けのフォールバック(代替)URL を指定できます。 |
|
|
sha1_idfa |
N/A |
SHA1でハッシュ化されたAppleの広告ID 。アドネットワークのサポートが必要です。 |
|
|
mac |
N/A |
端末のMACアドレス。アドネットワークのサポートが必要です。 |
|
|
sha1_mac |
N/A |
SHA1でハッシュ化された端末のMACアドレス 。アドネットワークのサポートが必要です。 |
|
例
http://app.appsflyer.com/{app_id}/?pid=airpush_int & c = RedBanner &
af_siteid = {publisher_id} & af_sub1 = 1.5 & af_sub2 = USD & af_sub3 = burst_campaign
すべてのパラメーターは、 インストールレポート 、 分析、レポートおよびAPIで使用できます。
カスタムパラメーター
デフォルト、Android固有、iOS固有のパラメーターに加えて、カスタムパラメーターも指定できます。これらのカスタムパラメータは、インストールにつながる計測リンクに従ってユーザーエクスペリエンスとコンテンツをカスタマイズする場合に役立ちます。
parameter = value 形式でカスタムリンクを計測リンクに追加できます。
例：
http://app.appsflyer.com/com.greatapp?pid=networkx_int & c = winter & af_adset = coats & af_ad = cashmere & my_custom_param = my_custom_valueカスタムパラメータについて知っておくべき2つの重要な事項：
- カスタムパラメータはローデータには表示されません。
- カスタムパラメータは、 コンバージョンデータの取得 SDK API から取得できます。
PID（パブリッシャーID）の重要性について
利用可能なすべての計測リンクパラメーターの中で、PIDは、すべての計測リンクに含める必要があります。
PID（パブリッシャーID）は、実際にはメディアソース名を指します。インストールをその発生元と関連付けるための最も重要なフィールドです。
AppsFlyerの 連携パートナー には、それぞれに固有のPID値があり、その末尾に"_int"が付いています。 カスタム計測リンクを使用する場合、連携パートナーによって有していない限り、任意のPID名を設定できます。
主要な連携済みのパブリッシャーIDの例：Organic、googleadwords_int（Google AdWords）、Facebook ads、Twitter。メール、SMS（テキストメッセージ）、Mail Pigeonなどの非連携ソースには、任意の名前を使用できます。
PIDに関する一般的な問題の回避策
PIDパラメータを使用する場合は、次のルールを考慮してください。
計測リンクにPIDがない場合、ユーザーのメディアソースが自動的に"None（なし）"にアトリビューションされ、 インストール元の情報が取得できなくなります。
ヒント
PIDの値に空白を使用しないようにする、もしくは、計測リンクを使用する前に必ずURLエンコードを行ってください。
データ粒度のレベル
URLパラメータを最大4つまで使用して、広告のパフォーマンスを細部まで掘り下げることができます。
アクティブなすべての計測リンクで4つのパラメーターをすべて使用すると、次のことが可能になります。
- すべてのユーザーのインストールとイベントを特定の広告に結び付ける
- 集計レポートの広告セット別、キャンペーン別、メディアソース別にすべての広告をドリルダウンし、パフォーマンスを比較して、各レベルで最適化する
- ローデータレポートとピボットテーブル上で、あらゆるメディアソースにわたってすべての広告を比較する
次のパラメータを使用します。
メディアソース（pid=）キャンペーン名（c=）Ad set (af_adset=)広告名（af_ad=）
例
次のトラッキングリンクでは、4つのレベルの粒度を使用して、連携済みの"networkx"メディアソースで実施している"winter"（ウィンター）キャンペーンで、"coats" （コート）の広告セットの"cashmere"（カシミヤ）の広告を計測しています。
http://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmereよくある質問
パラメータには、小文字または大文字どちらを使用すべきですか？
大文字、小文字どちらも使用できますが、設定後は統一して管理いただく必要があります。大文字または小文字でカスタムパラメータを設定する場合は、必ずそのパラメータを使用してください。
たとえば、 pid = MyMediaSource を設定する場合は、常に使用するようにしてください。ある計測リンクでpid=MyMediaSourceを使用し、別の計測リンクでpid=mymediasourceを使用すると、データの不一致が発生する可能性があります。これは計測リンクで設定した他のパラメーターにも同様に、当てはまります。
AppsFlyerの計測リンクは動的 (dynamic) ですか、静的 (static) ですか？
リンクがdynamicかstaticかをどのように確認できますか？
計測リンクにパラメーターが含まれている場合、それは事前に定義された長い計測リンクであり、したがってstaticです。
カスタム計測リンクに使用される短縮URL のみ、 dynamicです。
つまり、連携パートナーの計測リンク、またはオウンド（自社）メディアの長いURLを使用し始めると、AppsFlyerのダッシュボードで計測リンクの値を変更しても、それに関与しているリードについては変更されません。変更を行うには、今後新しい長いURLを使用する必要があります。
一方、オウンドメディアの短縮URLには、パラメーターが直接含まれていません。リードがAppsFlyerの短縮URLに関与すると、リードはAppsFlyerにリダイレクトされ、現在設定されているパラメーターが動的に発生します。
このPlayストアのエラーメッセージは何ですか。
計測リンクをたどった後にPlay Storeで次のエラーメッセージが表示された場合：
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#通常、リンクにはこれらの文字が含まれますが、マクロのため、動的に任意の値に置き換えられます。重大な問題ではないため、メッセージは無視してもかまいません。
Subscriber Parameter（サブスクライバーパラメータ）の用途を教えてください。
例
配車アプリのLuberの広告には、青、黄、赤の3色のテンプレートがあります。Luberのモバイルマーケティング担当者のリンダは、どの色のテンプレートがインストール数を増やせるかをテストしたいと考えています。そのため、すべての非SRNメディアソース間で、すべての青色の広告の計測リンクに &af_sub3=blue を追加することにしました。黄色と赤色の広告についても、同様のテストを行います。この情報が解析され、ローデータレポートに表示されることで、リンダはさまざまな色の広告の成果を分析して、最も優れたコンバージョンを選択することができます。
キャンペーン名の最大長は何文字ですか。
c_name_exceeded_max_length
ヒント
ビデオ：PlaytikaのNoam Goharyが、リンク構造とデータの最適化のための3つの最良の方法を明らかにします。