At a glance: Attribution links report user activity related to clicks and mobile ad impressions to AppsFlyer. Clicking on an attribution link redirects the user to download the app. A copy of the URL clicked is sent to AppsFlyer. Portions of the link are used to populate raw data reports.
AppsFlyerの基本計測リンク
The base attribution link contains the minimum information required to record the click and redirect the user to download the app. Additional parameters are added to the link after the ? character, to record extra information.
http://app.appsflyer.com/{app_id}?pid={media_source}
ベースとなる計測リンクには、Apple iTunes / App StoreアプリのアプリケーションID, またはGoogle Playのパッケージ名である{App_id}のパラメーターが含まれており、これが計測リンクを構成する最低条件になります。
注 ： Amazonアプリの場合は、ASINではなくbundle / package nameを使用してください。
例
http://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822計測リンクのパラメーター
次のパラメータは作成された計測リンク内でご利用可能です。
フィールドタイプ列の数値は、パラメーター値の文字制限です。パラメーター値の長さの制限について詳しくは、こちらをご覧ください。
| パラメーター名 | Display name in raw data | 説明 |
フィールドタイプ |
|---|---|---|---|
| pid | メディアソース | Uniquely identifies an AppsFlyer integrated partner. Don't change it. More details. |
String型 - 最大50文字まで |
| c | キャンペーン | キャンペーン名。広告主/代理店/媒体によって設定されます。長さが100文字を超えるものは、"c_name_exceeded_max_length"と管理画面に表示されます。 |
String型 - 最大100文字まで |
|
af_prt |
代理店 |
|
String型 - 最大50文字まで |
|
af_mp |
N/A |
|
|
|
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 |
広告主/代理店/アドネットワークにより設定 |
String型 - 最大24文字まで |
|
af_adset |
Adset |
|
String型 - 最大100文字まで |
|
af_adset_id |
Adset ID |
広告主/代理店/アドネットワークにより設定 |
String型 - 最大24文字まで |
|
af_ad |
広告 |
広告名（詳細） |
文字列 - 最大100文字まで |
|
af_ad_id |
Ad ID | 広告主/代理店/アドネットワークにより設定 |
String型 - 最大24文字まで |
|
af_ad_type |
Ad type |
Use the following naming convention:
|
String型 - 最大24文字まで |
|
af_click_lookback |
Attribution lookback window |
注 ：クリックURLのみに影響し、インプレッションURLには影響しません。 |
最大3文字まで |
|
af_viewthrough_ |
N/A |
注 ：インプレッションURLにのみ影響し、クリックURLには影響しません |
最大3文字まで |
|
af_channel |
Channel |
広告が配信されるメディアソースチャネル。例： UAC_Search、 UAC_Display、 Instagram、Facebook Audience Network など。 |
動的列挙文字列型 - 最大20文字まで |
|
af_keywords |
Keywords |
テキストによるターゲティングキャンペーンのキーワードリスト |
String型 - 最大100文字まで |
|
af_cost_model |
Cost Model |
|
String型 - 最大20文字まで |
|
af_cost_currency |
Cost Currency |
|
列挙（Enum）型 - 最大3文字 |
|
af_cost_value |
Cost Value |
|
String型 - 最大20文字まで |
|
af_sub[n] (n=1-5) 例: af_sub1 |
Sub param [n] |
広告主側で自由に定義可能なカスタムパラメーター |
String型 - 最大100文字まで |
| af_r | N/A | 両プラットフォーム（Android/iOS）のユーザーを指定されたURLへリダイレクトします。 | |
| af_web_dp | N/A | デスクトップユーザー(WindowsやMacなど)を、OneLinkテンプレートで既に設定してあるページ以外のWebページにリダイレクトさせるURLです。このパラメータを使用して、他のプラットフォーム（Google AnalyticsやOmnitureなど）において デスクトップユーザーのアトリビューションデータを確認できます。 | |
| af_dp | N/A | アプリを起動するためのフォールバック値です。ユニバーサルリンクまたは AndroidのAppLinkが失敗した場合と、Android6.0以下のユーザーに対して使用されます。 ここには、Base path、つまりデフォルトのアクティビティのみを設定するようにしてください。 | |
| 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 | N/A |
Boolean: true/false
インセンティブまたは非インセンティブのキャンペーン
|
|
| af_param_ forwarding |
N/A |
|
|
| af_os | OS version | [For iOS only] The device operating system version | |
| af_model | iOS model type |
[For iOS only] The device model. Values permitted:
|
| パラメーター名 | Display name in raw data | 説明 |
フィールドタイプ |
|---|---|---|---|
|
is_retargeting |
Is Retargeting (campaign) | すべてのリターゲティングキャンペーンのクリックURLには、 & is_retargeting = true を含める必要があります。 パラメーターが指定されていないか、値に"false"を指定した場合は、通常のユーザー獲得（UA）キャンペーンとみなされます。 |
列挙（Enum）型 - 5文字 |
|
af_reengagement_window |
Re-engagement window |
このパラメーターを計測リンクに追加して、 リエンゲージメントアトリビューションウィンドウを変更します。 可能なウィンドウ範囲オプションは次のとおりです。
デフォルト値：30日 例： |
最大3文字まで |
広告タイプのパラメータ
* 広告タイプに応じて、エンゲージメントの仕様を詳述する関連するビューアビリティパラメーターを送信することもできます。以下は、「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用パラメータ
| パラメータ名 | Display name in raw data | 説明 |
フィールドタイプ |
|---|---|---|---|
|
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 |
Redirect Android users to a different URL than the app page on Google Play. Use for out-of- store apps |
|
|
sha1_el |
N/A |
デスクトップからモバイルへの計測の場合のみ。SHA1でハッシュ化されたemail。アドネットワークのサポートが必要です。 |
|
|
fire_advertising_id |
N/A |
Amazon Fire Advertising ID |
|
iOS固有パラメータ
| パラメーター名 | 表示名 | 説明 |
|---|---|---|
|
idfa |
IDFA |
Use upper case. Requires ad network support Field type: 40 char max |
|
idfv |
IDFV | Use upper case. |
|
af_ios_url |
Redirect iOS (iPhone or iPad) users to a different URL than the app page on iTunes |
ランディングページのリダイレクションに使用します。 |
|
af_ios_fallback |
N/A |
IOS 10.3ユーザー向けのフォールバック(代替)URL を指定できます。 |
|
sha1_idfa |
N/A |
IDFA hashed with SHA1. Requires ad network support |
|
sha1_idfv |
N/A |
IDFV hashed with SHA1 |
|
mac |
N/A |
端末のMACアドレス。アドネットワークのサポートが必要です。 |
|
md5_idfv |
N/A |
IDFV hashed with MD5 |
|
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 から取得できます。
Why is publisher ID (PID) the Most Important Parameter?
利用可能なすべての計測リンクパラメーターの中で、PIDは、すべての計測リンクに含める必要があります。
PID（パブリッシャーID）は、実際にはメディアソース名を指します。。インストールをその発生元と関連付けるための最も重要なフィールドです
Integrated Partners have their own unique PID value, which ends with "_int". When using Custom Attribution Links you can set any PID name you'd like, as long as it's not reserved by integrated partners.
主要な連携済みのパブリッシャーIDの例：
Organic、googleadwords_int（Google AdWords）、Facebook ads、Twitter
(メール、SMS(テキストメッセージ)などの未連携のメディアソースには、任意の名前を使用できます。)
Avoid common PID issues
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=cashmereFAQ
パラメータには、小文字または大文字どちらを使用すべきですか？
大文字、小文字どちらも使用できますが、設定後は統一して管理いただく必要があります。大文字または小文字でカスタムパラメータを設定する場合は、必ずそのパラメータを使用してください。
たとえば、 pid = MyMediaSource を設定する場合は、常に使用するようにしてください。ある計測リンクでpid=MyMediaSourceを使用し、別の計測リンクでpid=mymediasourceを使用すると、データの不一致が発生する可能性があります。これは計測リンクで設定した他のパラメーターにも同様に、当てはまります。
AppsFlyerの計測リンクは動的 (dynamic) ですか、静的 (static) ですか？
How can you tell if a link is dynamic or static?
If the attribution link contains parameters, it's a long pre-defined attribution link, and therefore static.
Only shortened URLs, used for custom attribution links, are dynamic.
This means that once you start using an attribution Link for an integrated partner, or a long URL for owned media, it would not change for any leads engaging with it, even if you change the attribution link values on AppsFlyer's dashboard. For the change to take place, you need to use the new long URL going forward.
On the other hand, shortened URLs for owned media, don't directly contain parameters. When a lead engages with an AppsFlyer's shortened URL, the lead is redirected to AppsFlyer and the current set parameters take place dynamically.
この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つの最良の方法を明らかにします。