概要: AppsFlyerのアトリビューション計測リンクの構造とパラメータについて説明します。
概要
アトリビューションリンクを使用すると、広告主は広告に対するユーザーエンゲージメントに関するデータを計測できます。アトリビューションリンクは広告の背後に配置され、ユーザーが広告に反応したときにAppsFlyerに通知します。エンゲージメントは、広告のクリックを介して、またはユーザーが広告インプレッションを見たときに発生する可能性があります。 アトリビューションURLのコピーがAppsFlyerに送信されます。
アトリビューションリンクは、OneLink または単一プラットフォームリンクを使用して生成されます。
OneLink
OneLinkは、その名の通り1つのリンクでいずれのデバイス、オペレーティングシステム(iOS / AndroidなどのOS)、チャネル、またはプラットフォーム間で使用できます。
次の場合に OneLinkを選択します:
- すべてのプラットフォーム(OS)に対して 1つのリンクが必要な場合
- 既存ユーザーにディープリンク(アプリを直接起動)させたい場合
- アプリ起動にAndroidアプリリンクまたはiOSユニバーサルリンクを使用したい。
単一プラットフォームリンク
単一プラットフォームリンクは、特定のプラットフォーム(OS)のみで動作するリンクです。
たとえば、iOS用に作成されたプラットフォームリンクは、Androidでは機能しません。
次の場合に単一プラットフォームのリンクを選択します:
- 使用するOSが1つのみの場合
例:アプリがAndroidのみでリリースされている / iOSのみで施策を配信する、など - URIスキームを、アプリを起動するためにのみ使用する場合
OneLink と単一プラットフォームの両方のリンクにおいて、エンゲージメントに関連する追加データを含むパラメーターが含まれます。(利用可能なパラメータは以下表に記載されています。)
注意事項
単一プラットフォームのリンクには、クリックを記録するために必要な最小限の情報が含まれている必要があります。
- AppsFlyerのエンドポイント:app.appsflyer.com
-
app_id:AppsFlyerのプラットフォーム上で使用されるアプリ毎にユニークなIDです。
通常、AppleのAppStoreやGooglePlayのIDのフォーマットに沿ったものになります。 - media_source:AppsFlyerによって発行された、広告を掲載するメディアソースの識別子です。
- 例:
https://app.appsflyer.com/{app_id}?pid={media_source}
計測リンクのパラメーター
- 以下に記載されているパラメータは計測リンクで利用可能です。
- フィールドタイプ列の値は、パラメーター値の文字制限です。パラメーター値の長さの制限について詳しくは、 こちらをご覧ください。
次の表は .csv
ファイルとしてダウンロードできます。
パラメータ名 | ローデータレポート内での表示名 | 説明 |
フィールドタイプと文字数 |
---|---|---|---|
pid | Media Source | AppsFlyerの連携済みパートナーが持つ、一意の識別子です。絶対に変更しないでください。(詳細) |
String型 - 最大50文字まで |
c | Campaign | キャンペーン名。広告主/代理店/媒体によって設定されます。長さが100文字を超えるものは、"c_name_exceeded_max_length"と管理画面に表示されます。 |
String型 - 最大100文字まで |
af_prt |
Partner |
|
String型 - 最大50文字まで |
af_mp |
N/A |
|
|
clickid |
N/A |
アドネットワークが発行したユニークなクリックID |
|
af_siteid |
Site ID |
|
String型 - 最大24文字まで |
af_sub_siteid |
Sub Site ID |
|
String型 - 最大50文字まで |
af_c_id |
Campaign ID |
広告主/代理店/アドネットワークにより設定 |
String型 - 最大24文字まで |
af_adset |
Adset |
|
String型 - 最大100文字まで |
af_adset_id |
Adset ID |
広告主/代理店/アドネットワークにより設定 |
String型 - 最大24文字まで |
af_ad |
Ad |
広告名(詳細) |
文字列 - 最大100文字まで |
af_ad_id |
Ad ID | 広告主/代理店/アドネットワークにより設定 |
String型 - 最大24文字まで |
af_ad_type |
Ad type |
以下の命名規則を使用してください:
|
String型 - 最大24文字まで |
af_click_lookback |
Attribution lookback window |
注 :クリックURLのみに影響し、インプレッションURLには影響しません。 |
最大3文字まで |
af_viewthrough_ |
N/A |
注 :インプレッションURLにのみ影響し、クリックURLには影響しません |
最大3文字まで |
af_channel |
Channel |
広告が配信されるチャネル。 |
動的列挙文字列型 - 最大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 |
単一プラットフォームのリンクで、ユーザーを 両OS (Android と iOS) の指定されたURL にリダイレクトあっせるために使用します。 注意:
|
|
af_web_dp | N/A |
デスクトップユーザー(WindowsやMacなど)を、OneLinkテンプレートで既に設定してあるページ以外のWebページにリダイレクトさせるURLです。 注意: アクティブな リダイレクト許可リストがある場合は、この URL のドメインがリストにあることを確認してください。 |
|
af_dp | N/A | アプリを起動するためのURIスキームフォールバック値は、ユニバーサルリンクまたはAndroidアプリリンクメソッドが失敗した場合と、Android 6.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 | [iOSのみ]端末のOSバージョン | |
af_model | iOS model type |
[iOSのみ]端末モデル
|
|
af_media_type | Media type |
計測リンクの設置場所を示すパラメータです。
|
|
deep_link_sub1-10 | N/A |
追加のディープリンク値。開発者は、コード内の値の望ましい動作を実装し ます。 |
|
deep_link_value | N/A |
ユーザーが誘導される特定のアプリ内コンテンツの名前。開発者は、deep_link_value の希望する動作をコードに実装します。 |
|
af_og_title(プレビューのタイトル) | N/A |
ソーシャルメディアに投稿したときのリンクプレビューのタイトル |
|
af_og_description(プレビューの説明) | N/A |
ソーシャルメディアに投稿したときのリンクプレビューの説明 |
|
af_og_image(プレビューの画像URL) | N/A |
ソーシャルメディアに投稿したときのリンクプレビュー用の画像 |
パラメータ名 | ローデータレポート内での表示名 | 説明 |
フィールドタイプと文字数 |
---|---|---|---|
is_retargeting |
Is Retargeting (campaign) | リターゲティング広告用のクリックURLには、必ず& is_retargeting=true のパラメータを追加してください。このパラメータが追加されていなかったり、値が"false"に設定されていた場合には、その計測URLはすべて通常のユーザー獲得(UA)キャンペーンとして処理されます。 |
列挙(Enum)型 - 5文字 |
af_reengagement_window |
Re-engagement window |
このパラメーターを計測リンクに追加して、リエンゲージメントアトリビューション期間を変更します。 可能なウィンドウ範囲オプションは次のとおりです。
デフォルト値:30日 例: |
N/A |
広告タイプのパラメータ
* 広告タイプに応じて、エンゲージメントの仕様を詳述する関連するビューアビリティパラメーターを送信することもできます。以下は、「af_ad_type」の有効な値と、予想されるビューアビリティパラメータのリストです。
パラメータ名 | 値の形式 | 説明 |
---|---|---|
af_video_total_length | seconds (秒) | 動画の可能な総時間 |
af_video_played_length | seconds (秒) | 動画がどれだけ視聴されたか |
af_playable_played_length | seconds (秒) | 完全にロードされてから再生可能な要素が再生された時間 |
af_ad_time_viewed | seconds (秒) | 広告ユニットが画面に表示されていた時間 |
af_ad_displayed_percent | % | デバイス画面に表示された広告ユニットの最大割合 |
af_audio_total_length | seconds (秒) | 動画の可能な総時間 |
af_audio_played_length | seconds (秒) | どれくらいの音声が聞こえたか |
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にリダイレクトさせます。サードパーティアプリストアに使用してください。 注意: アクティブなリダイレクト許可リストがある場合は、このURLのドメインがリストにあることを確認してください。 |
|
sha1_el |
N/A |
デスクトップからモバイルへの計測の場合のみ。SHA1でハッシュ化されたemail。アドネットワークのサポートが必要です。 |
|
fire_advertising_id |
N/A |
Amazon Fire端末用の広告ID |
|
iOS専用のパラメータ
パラメーター名 | 表示名 | 説明 |
---|---|---|
idfa |
IDFA |
大文字のみ。 フィールドタイプ:最大40文字 |
idfv |
IDFV | 大文字のみ。 |
af_ios_url |
iOSユーザー(iPhone/iPad)をiTunesのアプリページ以外のURLにリダイレクトさせます。 |
ランディングページへのリダイレクトに使用してください。 注意: アクティブなリダイレクト許可リストがある場合は、このURLのドメインがリストにあることを確認してください。 |
af_ios_store_cpp |
カスタムプロダクトページのID (ppid) |
|
af_ios_fallback (非推奨) |
N/A |
(非推奨):ユーザーは iOSのURIスキームフローに基づいてリダイレクトされます 。 |
sha1_idfa |
N/A |
SHA1でハッシュ化されたIDFA。 |
sha1_idfv |
N/A |
SHA1でハッシュ化されたIDFV。 |
mac |
N/A |
端末のMACアドレス。アドネットワークのサポートが必要です。 |
md5_idfv |
N/A |
MD5でハッシュ化されたIDFV。 |
sha1_mac |
N/A |
SHA1でハッシュ化された端末のMACアドレス 。アドネットワークのサポートが必要です。 |
例
https://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
形式でカスタムリンクを計測リンクに追加できます。
例:
https://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 から取得できます。
パートナーID(PID)パラメーター
利用可能な計測リンクパラメータのうち、PIDは常に必須のものです。PIDは、AppsFlyerが発番しているメディアソース毎にユニークな識別子です。
連携済みパートナーはそれぞれ、ユニークなPIDを持っており、PIDの末尾には_intが付与されています。カスタム計測リンクを使用する場合には、連携済みパートナーによって既に使用されていない限り、任意のPIDを設定できます。ただし、不具合を避けるために_intは末尾に付与しないでください。
重要な連携済みパートナーのPID例:
organic / googleadwords_int (Google Adwords) / Facebook ads / Twitter
email、SMS、LPなど、連携していないメディアソースには任意のPID値を利用できます。
PIDに関するよくある問題とその回避策
- 計測リンクには、常にPIDを入力してください。計測リンクにPIDがない場合、ユーザーのメディアソースが自動的に"None(なし)"に成果が紐づき、インストール元の情報が取得できなくなります。
- カスタム計測リンクには、連携済みパートナーのPIDを使用しないでください。連携済みパートナーの場合には、そのインストールを正しく計測するために予め設定されたPIDのみを使用してください。一方、mailやSMS、Facebookの自社ポストなどに使うカスタム計測リンクの場合には、連携済みパートナーのPIDは使用しないでください。
- 有効な文字のみを使用してください。計測リンクのPIDパラメーターに ":<>*&?/"のいずれかの文字が含まれる場合、管理画面の invalid_media_source_nameにそのクリック/インストールがカウントされます。
ヒント
PIDの値に空白を使用しないようにする、もしくは、計測リンクを使用する前に必ずURLエンコードを行ってください。
サイトIDパラメーター
サイトIDは、広告を配信しているパブリッシャー(配信面)毎にユニークな識別子です。言い換えれば広告を表示しているwebサイトやアプリ毎にユニークであり、アドネットワークは各パブリッシャー(配信面)毎にユニークなサイトIDを発番しています。
サイトIDは計測URL内のaf_siteid
のパラメータに対して渡され、AppsFlyer内のさまざまなレポート画面やデータ、AppsFlyerからのポストバックにおいて利用可能です。
計測リンクでは、サイトIDをAppsFlyerに渡す必要があります。その理由は次のとおりです。
- パブリッシャー(配信面)について透明性を提供します。
- AppsFlyerは、サイトIDを不正なパブリッシャーやその他のトラフィッククラスターを識別し、排除するために使用します。
サイトIDパラメーターには、広告を配信するパブリッシャーのIDのみが含まれています。
広告タイプ/アプリ内での配信位置(例:バナー、インタースティシャル、動画)などの追加情報を含めたい場合は、サブサイトIDのパラメータを使用してください。
例
次の計測リンクには、以下が含まれています。
-
af_siteid
(サイトID):パブリッシャーID -
af_sub_siteid
(サブサイトID):追加ID情報 (この場合、アフィリエイト媒体と広告タイプの配置)
https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid=1234&af_sub_siteid=ABCD_4567
リンクの例には:
- 1234 = パブリッシャーID
- ABCD = パブリッシャーが使用するアフィリエイト媒体(サブパブリッシャー)
- 4567 = バナー、インタースティシャル、動画などアプリ内の広告タイプの配置
よくある質問:このトラフィックでブロック済みインストールが多いのはなぜですか?
ブロック済みインストールの原因は、以下のことが考えられます。
-
サイトIDがない:
af_siteid
パラメーターがクリックURL上で空欄になっている。空のサイトIDで送信されたエンゲージメントは、技術的な問題が発生したか、不正検知メカニズムを回避するための意図的な試みであることを示しています。 - 複数のサイトID:同じパブリッシャーが、異なるサイトIDを使って複数のクリックURLで送信されています。これは実際のパブリッシャーの活動を隠す不正な行為と考えられ、クリック洪水と関連していることが多いです。
- サイトIDの形式が間違っている:間違った形式で送信すると、他の不正行為の兆候と相まって、特定のパブリッシャーだけでなく、より上位のクラスターレベルでもブロックされる可能性があり、パートナーレベルでより大きなボリュームに影響を与える可能性があります。
インストールのブロックを防ぐには、例のようにパブリッシャーごとに1つのサイトIDパラメーターを送信してください。
データ粒度のレベル
4つの計測パラメータを使用することで、広告パフォーマンスを階層分けして掘り下げることが可能です。
アクティブなすべての計測リンクで4つのパラメーターをすべて使用すると、次のことが可能になります。
- すべてのユーザーのインストールとイベントを特定の広告に結び付ける
- 集計パフォーマンスレポート上で、全ての広告キャンペーンを広告セット別、キャンペーン別、メディアソース別に階層化して表示し、パフォーマンスを比較して各レベルでの最適化
- ローデータレポートとピボットテーブル上で、あらゆるメディアソースにわたってすべての広告を比較する
次のパラメータを使用します。
メディアソース(pid=)
キャンペーン名(c=)
Ad set (af_adset=)
広告名(af_ad=)
例
次の計測リンクでは、4階層のパラメータを使用して、連携済みパートナーである"networkx"で実施している"winter"(ウィンター)キャンペーンで、"coats" (コート)の広告セットの"cashmere"(カシミヤ)の広告を計測しています。
https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere
特性と制限
特性 | 備考 |
---|---|
特殊文字 |
|
URLの文字数制限 |
|
よくある質問
パラメータには、小文字または大文字どちらを使用すべきですか?
大文字、小文字どちらも使用できますが、設定後は統一して管理いただく必要があります。
たとえば、 pid=MyMediaSource を設定したい場合には、常にそのメディアソース名を使用するようにしてください。ある計測リンクではpid=MyMediaSourceを使用し、別の計測リンクでpid=mymediasourceを使用してしまった場合、2つのPIDを別の物と認識してしまう可能性があります。このルールは、計測リンクに設定した他のパラメータにおいても同様に適用されるので注意してください。
AppsFlyerの計測リンクは、DynamicとStaticのどちらですか?
計測リンクがDynamicかStaticかは、どのように識別できますか?
計測リンクに各種パラメーターが含まれている場合には、それは事前に値が定義済みのロングリンクであり、これらはどれもStaticです。
カスタム計測リンクで使用されるショートリンク(例えば、
yourbrand.onelink.me/HaT8/r5c2b371
)のみが dynamic です。つまり、連携済みパートナーの計測リンクや自社メディア計測用のカスタム計測リンクをロングリンクで使用し始めた場合、仮にAppsFlyerの管理画面上で計測リンクの値を変更したとしても、その計測URLに接触したユーザーにはその変更が適用されません。その変更を適用させるには、古い計測リンクを新しく発行したロングリンクに差し替えて使用する必要があります。
一方、自社メディア向けに発行したカスタム計測リンクがショートリンクの場合、計測URLには直接パラメータが含まれていません。ユーザーがAppsFlyerのショートリンクに接触すると、ユーザーは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つの最良の方法を明らかにします。