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

計測リンクを使用して、クリックとモバイル広告のインプレッションに関連するユーザーアクティビティを記録します。

ユーザーが計測リンクをクリックすると、URLがAppsFlyerに送信され、ユーザーはアプリをダウンロードするようにリダイレクトされます。AppsFlyerでは、リンクに含まれる関連するパラメーターが解析され、ローデータレポートの生成に使用されます。

AppsFlyerの基本計測リンク

基本の計測リンクは、クリックを記録し、ユーザーをアプリのダウンロードページにリダイレクトするための最小限の情報で構成されています。'?' の後に追加のパラメーターを追加することで、追加情報を記録します。

http://app.appsflyer.com/{app_id}


基本計測リンクには、Apple iTunes / App StoreアプリのアプリケーションID, またはGoogle Playのパッケージ名である{App_id}パラメーターが含まれています。

 例

次の com.greatapp アプリの計測リンクには、媒体ID(pid)、キャンペーン名(c)、広告セットID (af_adset_id)などの複数のパラメータを使用しています。次の表では、AppsFlyerで対応しているすべての計測リンクパラメータとその説明について記載しています。
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

広告タイプ - 次の規則のいずれかを使用します:

text - 検索結果など、テキストのみを含む
広告ユニット
banner - デバイス画面の上部または下部に表示される基本フォーマット
interstitial - すきま広告、インタースティシャル広告(ページ間に表示される広告)
video - 標準のビデオ(例:非報酬の動画)
rewarded_video - 動画の視聴と引き換えにアプリ内報酬を提供する広告ユニット
playable - アプリエクスペリエンスのインタラクティブなプレビューを含む広告ユニット
sponsored_content - 広告記事のようなスポンサードコンテンツに含まれるリンク
audio - オーディオ広告

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には、 & is_retargeting = true を含める必要があります。
パラメーターが指定されていないか、値に"false"を指定した場合は、通常のユーザー獲得(UA)キャンペーンとみなされます。 

列挙(Enum)型 - 5文字

af_reengagement_window

Re-Engagement Window

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

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

  • 日数:1-90
    --もしくは--
  • 時間:1-36

デフォルト値:30日

例:&af_reengagement_window=60d で、リエンゲージメント期間を60日間に設定します。

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

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

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

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

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

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

PIDに関する一般的な問題の回避策

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

1. 計測リンクには、PIDを常に含めてください。

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

2. カスタムソースには非連携パートナーのPIDを使用する 
各連携ソースには、インストールを正しく計測するため、指定されたPIDのみを使用します。メール、SMS、またはFacebookの口コミ投稿などのカスタムメディアソースの場合は、非連携のPID値を使用してください。
 
3. 有効な文字のみを使用する
トラッキングリンクの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"(カシミヤ)の広告を計測しています。

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) ですか?

AppsFlyerの計測リンクはトラッカーではなく、dynamicまたはstaticのいずれかです。
リンクがdynamicかstaticかをどのように確認できますか?
計測リンクにパラメーターが含まれている場合、それは事前に定義された長い計測リンクであり、したがってstaticです。
カスタム計測リンクに使用される短縮URL のみ、 dynamicです。
つまり、連携パートナーの計測リンク、またはオウンド(自社)メディアの長いURLを使用し始めると、AppsFlyerのダッシュボードで計測リンクの値を変更しても、それに関与しているリードについては変更されません。変更を行うには、今後新しい長い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などのSubscriber Parameter(サブスクライバーパラメータ)は、任意の便利なKPIを計測するために使用できます。これらのパラメータは解析され、ローデータレポートに表示されます。値はデータの集計や絞込みを行うのに非常に役立ちます。

 例

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

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

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

 ヒント

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

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