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

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

 例

The following attribution link for the com.greatapp app uses several parameters including Media source  (pid), campaign name (c) and adset ID (af_adset_id). See the table below for the full list of supported attribution link parameters and their explanations.
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
  • パブリッシャーマーケティングパートナーに対してインストールのポストバックを有効にします。
  • 注意 :現在、このパラメーターは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

 Use the following naming convention:

  • 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の集計データにコストの値が記録されます。 
  • Where possible report cost by API. In cases where cost is reported by on the link and by API - API has priority.

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_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
  • When set to false, parameters that are on the attribution link are not forwarded to the redirected page
  • リダイレクトされたページでシンプルなURLに使用するか、リダイレクトされたページでのクエリーパラメーターの処理が原因で計測リンクパラメーターが問題を引き起こす可能性がある場合に使用します。
 
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:

  • iphone (all lower case)
  • ipad (all lower case) 
 
計測リンクパラメータ - 新規獲得とリターゲティング
パラメーター名 Display name in raw data 説明

フィールドタイプ

is_retargeting

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

列挙(Enum)型 - 5文字

af_reengagement_window

Re-engagement window

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

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

  • Days: 1-90 or Hours 1-36
  • Lifetime:リエンゲージメント期間が無制限になります。例: &af_reengagement_window=lifetime

デフォルト値:30日

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

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

 

Android用パラメータ


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

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パラメータを使用する場合は、次のルールを考慮してください。

Always include PID in your attribution links

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

For Custom Sources Use non-integrated partner PIDs
各連携ソースには、インストールを正しく計測するため、指定されたPIDのみを使用します。メール、SMS、またはFacebookの口コミ投稿などのカスタムメディアソースの場合は、非連携のPID値を使用してください。
 
Use only legal characters
トラッキングリンクの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

FAQ

パラメータには、小文字または大文字どちらを使用すべきですか?

大文字、小文字どちらも使用できますが、設定後は統一して管理いただく必要があります。大文字または小文字でカスタムパラメータを設定する場合は、必ずそのパラメータを使用してください。

たとえば、 pid = MyMediaSource を設定する場合は、常に使用するようにしてください。ある計測リンクでpid=MyMediaSourceを使用し、別の計測リンクでpid=mymediasourceを使用すると、データの不一致が発生する可能性があります。これは計測リンクで設定した他のパラメーターにも同様に、当てはまります。

AppsFlyerの計測リンクは動的 (dynamic) ですか、静的 (static) ですか?

The attribution links are not trackers, and could either be dynamic or 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で次のエラーメッセージが表示された場合:

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のキャンペーン名は最大100文字です。文字数の制限を超えた場合、キャンペーン名は次の文字列に変更されます。
c_name_exceeded_max_length

 ヒント

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

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