概要: AppsFlyerの計測リンクの構造と各種パラメータについて説明しています。
計測リンクはAppsFlyerに対して、クリックやモバイル広告のインプレッションなどのユーザーアクティビティをレポートします。計測リンクをクリックすると、アプリをダウンロードしてもらうためにユーザーをストアへリダイレクトさせ、そのURLのコピーがAppsFlyerへ送信され、そのリンクの各パラメータを使用してローデータレポートが作成されます。
AppsFlyerの基本計測リンク
ベースとなる計測リンクは、クリックを記録し、ユーザーをアプリのダウンロードページにリダイレクトするための最小限の情報で構成されています。'?' より後にパラメーターを追加することで、追加の情報を記録することが可能になります。
https://app.appsflyer.com/{app_id}?pid={media_source}
ベースとなる計測リンクには、Apple iTunes / App StoreアプリのアプリケーションID, またはGoogle Playのパッケージ名である{App_id}のパラメーターが含まれており、これが計測リンクを構成する最低条件になります。
注 : Amazonアプリの場合は、ASINではなくbundle / package nameを使用してください。
例
https://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822
計測リンクのパラメーター
次のパラメータは作成された計測リンク内でご利用可能です。
フィールドタイプ列の数値は、パラメーター値の文字制限です。パラメーター値の長さの制限について詳しくは、こちらをご覧ください。
パラメーター名 | ローデータレポート内での表示名 | 説明 |
フィールドタイプ |
---|---|---|---|
pid | メディアソース | AppsFlyerの連携済みパートナーが持つ、一意の識別子です。絶対に変更しないでください。(詳細) |
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 |
以下の命名規則を使用してください:
|
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 |
両プラットフォーム(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 | [iOSのみ]端末のOSバージョン | |
af_model | iOS model type |
[iOSのみ]端末モデル
|
|
af_media_type | メディアタイプ |
計測リンクの設置場所を示すパラメータです。
|
パラメーター名 | ローデータレポート内での表示名 | 説明 |
フィールドタイプ |
---|---|---|---|
is_retargeting |
Is Retargeting (campaign) | リターゲティング広告用のクリックURLには、必ず& is_retargeting=true のパラメータを追加してください。このパラメータが追加されていなかったり、値が"false"に設定されていた場合には、その計測URLはすべて通常のユーザー獲得(UA)キャンペーンとして処理されます。 |
列挙(Enum)型 - 5文字 |
af_reengagement_window |
リエンゲージメント期間 |
このパラメーターを計測リンクに追加して、 リエンゲージメントアトリビューションウィンドウを変更します。 可能なウィンドウ範囲オプションは次のとおりです。
デフォルト値:30日 例: |
N/A |
広告タイプのパラメータ
* 広告タイプに応じて、エンゲージメントの仕様を詳述する関連するビューアビリティパラメーターを送信することもできます。以下は、「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 |
大文字のみ。 フィールドタイプ:最大40文字 |
idfv |
IDFV | 大文字のみ。 |
af_ios_url |
iOSユーザー(iPhone/iPad)をiTunesのアプリページ以外のURLにリダイレクトさせます。 |
ランディングページのリダイレクションに使用します。 |
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 から取得できます。
PID(パブリッシャーID)の重要性について
利用可能なすべての計測リンクパラメーターの中で、PIDは、すべての計測リンクに含める必要があります。
PID(パブリッシャーID)は、実際にはメディアソース名を指します。。インストールをその発生元と関連付けるための最も重要なフィールドです
連携済みパートナーは、それぞれ固有のPIDを持っており、その末尾に"_int"が付いています。カスタム計測リンクを使用する場合には、連携パートナーによって利用されていない限り、任意のPID名を設定できます。
主要な連携済みのパブリッシャーIDの例:
Organic、googleadwords_int(Google AdWords)、Facebook ads、Twitter
メール、SMS(テキストメッセージ)、Mail Pigeonなどの連携していないメディアソースには、任意の名前を利用可能です。
PIDに関するよくある問題とその回避策
PIDパラメータを使用する場合は、次のルールを考慮してください。
計測リンクにPIDがない場合、ユーザーの成果が自動的に"None(なし)"に紐付けられ、 インストール元となった媒体の情報が取得できなくなります。
ヒント
PIDの値に空白を使用しないようにする、もしくは、計測リンクを使用する前に必ずURLエンコードを行ってください。
データ粒度のレベル
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
よくある質問
パラメータには、小文字または大文字どちらを使用すべきですか?
大文字、小文字どちらも使用できますが、設定後は統一して管理いただく必要があります。
たとえば、 pid=MyMediaSource を設定したい場合には、常にそのメディアソース名を使用するようにしてください。ある計測リンクではpid=MyMediaSourceを使用し、別の計測リンクでpid=mymediasourceを使用してしまった場合、2つのPIDを別の物と認識してしまう可能性があります。このルールは、計測リンクに設定した他のパラメータにおいても同様に適用されるので注意してください。
AppsFlyerの計測リンクは、DynamicとStaticのどちらですか?
計測リンクに各種パラメータが含まれている場合には、それは事前に値が定義済みのロングリンクであり、これらはどれもStaticです。
一方、カスタム計測リンクで使用される短縮URLのみが、 Dynamicです。
つまり、連携済みパートナーの計測リンクや自社メディア計測用のカスタム計測リンクをロングリンクで使用し始めた場合、仮にAppsFlyerの管理画面上で計測リンクの値を変更したとしても、その計測URLに接触したユーザーにはその変更が適用されません。その変更を適用させるには、古い計測リンクを新しく発行したロングリンクに差し替えて使用する必要があります。
一方、自社メディア向けに発行したカスタム計測リンクが短縮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つの最良の方法を明らかにします。