AppsFlyer計測リンクの構造とパラメーター

概要: 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を使用してください。

 例

以下の"com.greatapp"アプリの計測リンクには、メディアソース名(pid)、キャンペーン名(c)、広告セットID (af_adset_id)のパラメータを使用しています。次の表では、AppsFlyerで対応している計測リンクの全パラメータとその説明について記載しています。

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
  • パブリッシャーマーケティングパートナーに対してインストールのポストバックを有効にします。
  • 注意 :現在、このパラメーターは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

広告主/代理店/アドネットワークにより設定

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

 以下の命名規則を使用してください:

  • text: テキストのみを含む広告ユニット(例:検索結果など)
  • banner: 画面の上部または下部に表示される基本フォーマット
  • interstitial: 画面閲覧中に差し込まれる、インターステシャル広告
  • video: リワード広告ではない、通常の動画広告
  • rewarded_video: 動画視聴と引き換えにアプリ内報酬を提供するリワード動画広告
  • playable: 実際のアプリ操作が一部可能な、インタラクティブな広告
  • sponsored_content: 広告記事のようなスポンサードコンテンツに含まれるリンク
  • audio: 音声広告

String型 - 最大24文字まで

af_click_lookback

Attribution lookback window

  • Lookback Window for Click Attribution(クリックアトリビューションのルックバック期間)。この有効期間は、新規ユーザーが表示中の元の広告/リンクと関連付けられる最大CTIT(クリックからインストールまでの時間)を指します。
  • クリックアトリビューションのルックバック期間の日数は設定変更が可能です。 設定可能なパラメーター値:1d~30d(日数)、または1h~23h(時間) デフォルト値は7日間です。
  • ルックバック期間は、OneLink と SRN 向けにもカスタマイズ可能です。

:クリックURLのみに影響し、インプレッションURLには影響しません。

最大3文字まで

af_viewthrough_
lookback

N/A

  • ビュースルーアトリビューションのルックバック期間の日数は設定変更が可能です。 設定可能なパラメーター値:1h~48h(時間)または1d~7d(日数)。 デフォルト値は1日です。
  • ルックバック期間は、SRN 向けにもカスタマイズ可能です。

:インプレッション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

  • 現在サポートされているのはCPI(デフォルト)モデルのみで、計測URLによって記録され、管理画面のオーバービューなどに表示される、AppsFlyerの集計データにコストの値が記録されます。 
  • APIを使ってコストを記録する場合があります。
    計測リンクとAPIの両方でコストが記録された場合には、APIのデータが優先されます。

String型 - 最大20文字まで

af_cost_currency

Cost Currency

  • ISO-4217に準拠した、3 文字の通貨コード。
    例:USD, JPY, EUR
  • デフォルト設定:USD

列挙(Enum)型 - 最大3文字

af_cost_value

Cost Value

  • 通貨設定(af_cost_currency)に則したコストの値です。
  • 小数点第4位まで
  • "56"、"2.85"など、数値のみ設定可ですので注意してください。(必要に応じて小数点は使用可です)

String型 - 最大20文字まで

af_sub[n] 

(n=1-5) 例: af_sub1

Sub param [n]

広告主側で自由に定義可能なカスタムパラメーター
これらのパラメータの使用方法の詳細については、FAQセクションを参照してください。

String型 - 最大100文字まで

af_r N/A

両プラットフォーム(Android/iOS)のユーザーを、指定したURLへリダイレクトさせます。
注意: af_rが設定されている場合、af_ios_url / af_android_url / af_web_dpのパラメータを個別に設定する必要はありません。これらのリダイレクトは全てaf_rでカバーしています。

 
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
  • このパラメータをfalseに設定した場合、計測リンクに付与されているパラメーターの情報はリダイレクト先のページには渡されません。
  • リダイレクトされたページでシンプルなURLに使用するか、リダイレクトされたページでのクエリーパラメーターの処理が原因で計測リンクパラメーターが問題を引き起こす可能性がある場合に使用します。
 
af_os OS version [iOSのみ]端末のOSバージョン  
af_model iOS model type

[iOSのみ]端末モデル
利用可能な値は以下のみです。

  • iphone (すべて小文字)
  • ipad (すべて小文字)
 
計測リンクパラメータ - 新規獲得とリターゲティング
パラメーター名 ローデータレポート内での表示名 説明

フィールドタイプ

is_retargeting

Is Retargeting (campaign)  すべてのリターゲティングキャンペーンのクリックURLには、 & is_retargeting = true を含める必要があります。
パラメーターが指定されていないか、値に"false"を指定した場合は、通常のユーザー獲得(UA)キャンペーンとみなされます。 

列挙(Enum)型 - 5文字

af_reengagement_window

リエンゲージメント期間

このパラメーターを計測リンクに追加して、 リエンゲージメントアトリビューションウィンドウを変更します。

可能なウィンドウ範囲オプションは次のとおりです。

  • 日数:1-90d / または時間:1-36h
  • Lifetime:リエンゲージメント期間が無制限になります。例: &af_reengagement_window=lifetime

デフォルト値:30日

例:&af_reengagement_window=30d で、リエンゲージメント期間を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   どれくらいの音声が聞こえたか
広告タイプ (af_ad_type) 

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

 

Android用パラメータ

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つの重要な事項:

PID(パブリッシャーID)の重要性について

利用可能なすべての計測リンクパラメーターの中で、PIDは、すべての計測リンクに含める必要があります。

PID(パブリッシャーID)は、実際にはメディアソース名を指します。。インストールをその発生元と関連付けるための最も重要なフィールドです

連携済みパートナーは、それぞれ固有のPIDを持っており、その末尾に"_int"が付いています。カスタム計測リンクを使用する場合には、連携パートナーによって利用されていない限り、任意のPID名を設定できます。

主要な連携済みのパブリッシャーIDの例:
Organic、googleadwords_int(Google AdWords)、Facebook ads、Twitter
(メール、SMS(テキストメッセージ)などの未連携のメディアソースには、任意の名前を使用できます。)

PIDに関するよくある問題とその回避策

PIDパラメータを使用する場合は、次のルールを考慮してください。

計測リンクには常にPIDを入力してください。

計測リンクにPIDがない場合、ユーザーのメディアソースが自動的に"None(なし)"にアトリビューションされ、 インストール元の情報が取得できなくなります。

カスタム計測リンク:連携済みパートナーのPIDを使用しないでください。
各連携ソースには、インストールを正しく計測するため、指定されたPIDのみを使用します。メール、SMS、またはFacebookの口コミ投稿などのカスタムメディアソースの場合は、非連携のPID値を使用してください。
 
有効な文字のみを使用してください。
トラッキングリンクのPIDパラメーターに ":<>*&?/" - のいずれかの文字が含まれる場合、管理画面の invalid_media_source_nameにそのクリック/インストールがカウントされます。

 

 ヒント

PIDの値に空白を使用しないようにする、もしくは、計測リンクを使用する前に必ずURLエンコードを行ってください。

データ粒度のレベル

URLパラメータを最大4つまで使用して、広告のパフォーマンスを細部まで掘り下げることができます。

アクティブなすべての計測リンクで4つのパラメーターをすべて使用すると、次のことが可能になります。

  • すべてのユーザーのインストールとイベントを特定の広告に結び付ける
  • 集計レポートの広告セット別、キャンペーン別、メディアソース別にすべての広告をドリルダウンし、パフォーマンスを比較して、各レベルで最適化する
  • ローデータレポートとピボットテーブル上で、あらゆるメディアソースにわたってすべての広告を比較する

次のパラメータを使用します。

  1. メディアソース(pid=)
  2. キャンペーン名(c=)
  3. Ad set (af_adset=)
  4. 広告名(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のどちらですか?

AppsFlyerの計測リンクは、Dynamic / Staticのどちらかになります。計測リンクがDynamicかStaticかは、どのように識別できますか?
計測リンクに各種パラメータが含まれている場合には、それは事前に値が定義済みのロングリンクであり、これらはどれもStaticです。
一方、カスタム計測リンクで使用される短縮URLのみが、 Dynamicです。
つまり、連携済みパートナーの計測リンクや自社メディア計測用のカスタム計測リンクをロングリンクで使用し始めた場合、仮にAppsFlyerの管理画面上で計測リンクの値を変更したとしても、その計測URLに接触したユーザーにはその変更が適用されません。その変更を適用させるには、古い計測リンクを新しく発行したロングリンクに差し替えて使用する必要があります。一方、自社メディア向けに発行したカスタム計測リンクの短縮URLの場合、計測URLには直接パラメータが含まれていません。ユーザーがAppsFlyerの短縮URLに接触すると、ユーザーはAppsFlyerのサーバーへリダイレクトされ、現在設定されている各種パラメータが動的に付与されます。

このPlayストアのエラーメッセージは何ですか。

計測リンクをたどった後にPlay Storeで次のエラーメッセージが表示された場合:

TL_error_message.png

これは、属性リンクに#文字が含まれているためです。例:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#

通常、リンクにはこれらの文字が含まれますが、マクロのため、動的に任意の値に置き換えられます。重大な問題ではないため、メッセージは無視してもかまいません。

Subscriber Parameter(サブスクライバーパラメータ)の用途を教えてください。

af_sub1~af_sub5のパラメータは、任意のKPIを計測するために利用可能です。これらのパラメータは解析され、ローデータレポート上で確認が可能なので、データの集計や絞込みを行うのに非常に役立ちます。

 例

配車アプリのLuberの広告には、青、黄、赤の3色のテンプレートがあります。Luberのモバイルマーケティング担当者のリンダは、どの色のテンプレートがインストール数を増やせるかをテストしたいと考えています。そのため、すべての非SRNメディアソース間で、すべての青色の広告の計測リンクに &af_sub3=blue を追加することにしました。黄色と赤色の広告についても、同様のテストを行います。この情報が解析され、ローデータレポートに表示されることで、リンダはさまざまな色の広告の成果を分析して、最も優れたコンバージョンを選択することができます。

キャンペーン名の最大長は何文字ですか。

計測リンクURLのキャンペーン名は最大100文字です。文字数の制限を超えた場合、キャンペーン名は次の文字列に変更されます。
c_name_exceeded_max_length

 ヒント

ビデオ:PlaytikaのNoam Goharyが、リンク構造とデータの最適化のための3つの最良の方法を明らかにします。

この記事は役に立ちましたか?