どのようにお手伝いできますか?

計測リンクの構造とパラメータについて

  • 更新

概要:AppsFlyerの計測リンクの構造とパラメータを説明します。

概要

計測リンクを使用すると、広告主はユーザーの広告接触に関するデータを収集できます。広告に計測リンクを設定することで、ユーザーが広告に反応した際にAppsFlyerに通知されます。広告接触には、広告のクリックと、広告が表示されるインプレッションがあります。 計測URLのコピーがAppsFlyerに送信されます。

計測リンクは、OneLinkまたは単一プラットフォーム向けリンクを使用して作成します。

  OneLink(複数プラットフォーム向けリンク) 単一プラットフォーム向けリンク
概要と利用場面

以下の場合に使用します。

  • すべてのプラットフォームで1つのリンクを使用したい場合。
  • ディープリンク機能が必要な場合。
  • Android App LinksまたはiOSのユニバーサルリンクでアプリを開きたい場合。

OneLinkについて詳しく見る

以下の場合に使用します。

  • 単一のプラットフォームのみを使用する場合。たとえば、Androidのみを使用し、iOSは使用しない場合です。
  • URIスキームのみでアプリを開く場合。

連携済みパートナーの設定方法について詳しく見る

前提条件 OneLinkテンプレート なし
含める情報
ベースURL {subdomain}.onelink.me app.appsflyer.com
一意の識別子 テンプレートID app_id
URLの構造 https://{subdomain}.onelink.me/
{templateid}?pid={media_source}
&af_siteid={ApplicationID}
&c={CampaignName}
https://app.appsflyer.com/{app_id}?pid={media_source}&af_siteid={ApplicationID}&c={CampaignName}
例 https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int
&c=GreatCampaign&af_siteid=A1b1
https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int&
c=GreatCampaign&af_siteid=A1b1

 重要

AppsFlyerが受信する広告接触のトラフィック(クリックとインプレッション)は、HTTPSプロトコルのみに対応しています。

計測リンクのパラメータ

  • 以下のパラメータを計測リンクで使用できます。
  • フィールドの型の列の数値は、パラメータ値の文字数上限です。パラメータ値の長さに関する制限は、こちらを参照してください。

計測リンクのパラメータ|UAとリターゲティング

以下の表は、.csvファイルとしてダウンロードできます。

パラメータ ローデータでの表示名 説明 フィールドの型と長さ
pid メディアソース AppsFlyerの連携済みパートナーを一意に識別します。変更しないでください。詳細を見る。 文字列・150文字
c キャンペーン 広告主またはパブリッシャーが指定します。キャンペーン名の制限を参照してください。 文字列
af_prt パートナー
  • 代理店アカウント名を指定することで、インストールを代理店に紐付けられます。
  • 注意:このパラメータを使用する前に、代理店の権限が有効になっていることを必ず確認してください。
文字列・50文字
af_mp N/A
  • インストールごとに、パブリッシャーのマーケティングパートナーへのポストバック送信を有効にします。
  • 注意:現在、このパラメータはPinterestのマーケティングパートナーにのみ適用されます。
 
clickid N/A アドネットワークが発行する一意のクリック識別子  
af_siteid サイトID
  • 広告を表示するパブリッシャーを識別する一意のIDです。詳しく見る
文字列・24文字
af_sub_siteid サブサイトID
  • 広告のサブネットワーク/パブリッシャーIDです。
  • 主要なパブリッシャー(サイトID)に加えてサブパブリッシャーがある場合や、バナー、インタースティシャル、動画などの広告タイプやアプリ内の掲載位置に関する情報を含めたい場合は、af_sub_siteidを使用します。例:af_sub_siteid =ABCD_4567
文字列
af_c_id キャンペーンID 広告主またはパブリッシャーが指定します。 文字列・24文字
af_adset 広告セット
  • 広告主またはパブリッシャーが指定します。
  • 広告セットは、キャンペーンと広告の間に位置する階層です。詳しく見る
文字列・100文字
af_adset_id 広告セットID 広告主またはパブリッシャーが指定します。 文字列・24文字
af_ad 広告 広告主またはパブリッシャーが指定する広告名です(詳しく見る)。 文字列・100文字
af_ad_id 広告ID 広告主またはパブリッシャーが指定します。 文字列・24文字
af_ad_type 広告タイプ

 以下の値を使用します。

  • native:メディアソースのコンテンツになじむよう設計された有料広告です。通常のコンテンツと見た目や機能を合わせて設計され、おすすめ動画のフィードなどに表示されます。
  • banner:一般に小さな長方形のディスプレイ広告で、Webページやアプリ画面のさまざまな場所に表示されます。
  • interstitial:掲載先アプリの画面全体を覆う全画面広告です。コンテンツの合間に配置する広告で、通常はアクティビティ間、ゲームのレベル間、一時停止中など、アプリ操作の区切りに表示されます。
  • rewarded_video:ユーザーがアプリ内報酬と引き換えに、最後まで視聴することを選べる広告です。たとえば、動画視聴の報酬としてゲーム内のライフ、記事の閲覧権、空港のWi-Fi利用権などを提供します。このようなリワード広告は、ユーザーの参加を促し、アプリ全体の体験を向上させます。
  • audio:オンラインのポッドキャストや音楽配信プラットフォームで配信される音声形式の広告です。
  • offerwall:開発者がアプリの収益化に使用するアプリ内広告枠です。アプリ内の小さなストアのように複数の「オファー」を一覧表示し、ユーザーは条件を達成することでアプリ内報酬を得られます。
文字列・24文字
af_ad_format 広告フォーマット

 以下の値を使用します。

  • text:通常、短いテキストで表示される文字主体の広告です。見出し、説明文、リンクやCTAなどを含め、関心を引いてWebサイトやランディングページへのクリックを促します。
  • image:画像や写真を使って商品、サービス、ブランドを紹介するビジュアル広告です。通常は目を引く画像と簡潔なテキストを組み合わせ、CTAを含めることもあります。
  • video:映像と音声を使用してマーケティングメッセージを伝えるデジタル広告です。長さはさまざまで、オンライン動画の再生前・途中・終了後に表示されるほか、各種プラットフォームで独立した動画として配信されます。
  • playable:ダウンロードや購入の前に、ゲームやアプリの簡易版を操作できるインタラクティブ広告です。ユーザーは実際のゲームプレイやアプリ機能の一部を体験できます。
  • interactive:ユーザーの操作や参加を促す、動きのある魅力的な広告です。クイズ、投票などの双方向的な要素を使い、ユーザーの関心を引いて積極的な参加を促します。
  • dynamic_product:ユーザーの行動、好み、閲覧履歴に基づき、商品情報や詳細を動的に表示するパーソナライズ広告形式です。一人ひとりに関連性の高い、最適な商品広告を表示できます。
  • carousel:1つの広告内に複数のスライドやカードを配置する形式です。カードごとに異なる画像、見出し、説明文を設定し、複数の商品や機能を1つの広告で紹介できます。
 
af_click_lookback アトリビューションのルックバック期間
  • クリックによるアトリビューションのルックバック期間です。広告やリンクを掲載したメディアソースに新規ユーザーを紐付けられる、クリックからインストールまでの最大時間(CTIT)を定めます。
  • クリックによるアトリビューションのルックバック期間を日数で設定できます。指定可能な値:1d~30d(日)または1h~23h(時間)。デフォルト値は7dです。
  • OneLinkおよびSRNのルックバック期間は変更できます。

注意:クリックURLにのみ適用され、インプレッションURLには適用されません。

最大3文字
af_viewthrough_lookback N/A
  • ビュースルーアトリビューションのルックバック期間を時間単位で設定できます。指定可能な値:1h~24h(時間)。デフォルト値は24hです。
  • SRNのルックバック期間は変更できます。

注意:インプレッションURLにのみ適用され、クリックURLには適用されません。

最大3文字
af_channel チャネル 広告が配信されるメディアソース内のチャネルです。例:UAC_Search、UAC_Display、Instagram、Meta Audience Networkなど。 動的な列挙型。文字列・20文字
af_engagement_destination 広告のリンク先 広告のリンク先のカテゴリを示します。Webのランディングページ、モバイルアプリ(ディープリンクまたはアプリストア経由)、CTV、PC、コンソールなどがあります。 文字列・50文字
af_keywords キーワード テキストターゲティングキャンペーンのキーワード一覧です。 文字列・100文字
af_cost_model コストモデル
  • コストモデルです。クリック経由でコストを報告し、AppsFlyerの集計データレポートにコスト値を反映する場合、現在対応しているモデルはCPI(デフォルト)のみです。
  • 可能な場合は、APIでコストを報告してください。リンクとAPIの両方でコストが報告された場合は、APIの値が優先されます。
文字列・20文字
af_cost_currency コスト通貨
  • ISO-4217に準拠した3文字の通貨コードです。 例:USD、ZAR、EUR。
  • [デフォルト]:USD
列挙型。 3文字 
af_cost_value コスト値
  • 指定したコスト通貨でのコスト値です。
  • 小数点以下4桁まで指定できます。
  • 数値のみを指定してください(必要に応じて小数点を使用)。例:"56"、"2.85"。
数値

af_sub[n] 

(n=1~5)例:af_sub1

サブパラメータ[n] 広告主が任意で定義するカスタムパラメータです。使用方法について詳しくは、仕様と制限事項を参照してください。 文字列・100文字
af_r N/A

すべてのプラットフォーム(Android、iOS、PC)で、ユーザーを指定したURLにリダイレクトするために使用します。

複数プラットフォーム向けリンク(OneLink)では、このパラメータは以下のように動作します。

  • テンプレート単位のリダイレクト設定より優先されます。
  • ただし、以下のリンク単位のパラメータが、このパラメータより優先されます。

注意:リダイレクトパラメータに関するその他の仕様と制限事項も参照してください。

 
af_web_dp N/A

PC(WindowsやMacなど)のユーザーを、OneLinkテンプレートで設定したページとは別のWebページにリダイレクトするためのURLです。 PCユーザーのアトリビューションデータを、Google AnalyticsやOmnitureなどの他のプラットフォームで保持する場合に使用します。

注意:リダイレクトパラメータに関するその他の仕様と制限事項も参照してください。

 
af_dp N/A

ユニバーサルリンクやAndroid App Linksでアプリを開けない場合、またはAndroid 6.0未満の場合に使用する、アプリ起動用のURIスキームのフォールバック値です。ベースパス(デフォルトのアクティビティ)のみを指定してください。

注意:このパラメータにWeb URLを指定する場合(非推奨)は、必ずリダイレクトパラメータの仕様と制限事項を確認してください。

 
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でも、ネットワーク名だけでもかまいません。
 
AppsFlyerは、Androidデバイスのアトリビューションにこのパラメータを使用する場合があります。 iOSおよびWindowsデバイスのアトリビューションには、このパラメータを使用しません。
 
is_incentivized N/A
ブール値:true/false
インセンティブ付き、またはインセンティブなしのキャンペーン
 
af_param_forwarding N/A
  • falseに設定すると、計測リンクのパラメータがリダイレクト先のページに転送されなくなります。
  • リダイレクト先のURLを簡潔にしたい場合や、リダイレクト先のクエリパラメータの処理で計測リンクのパラメータが問題を起こす可能性がある場合に使用します。
 
af_base_params_forward N/A
  • falseに設定すると、計測リンクのAppsFlyerのPIDおよびCパラメータがリダイレクト先のページに転送されなくなります。
  • PCでクリックされるURLで、CRMに必要なパラメータは残しつつ、AppsFlyerのPIDおよびCパラメータを除外したい場合に使用します。これにより、URLに複数のPIDが含まれることを防げます。
 
af_partner_account_id アドネットワークのアカウントID パートナー側の広告主アカウントIDです。 文字列・100文字
redirect N/A &redirect=falseを指定すると、S2Sクリックであり、クリックしたユーザーのリダイレクトはパートナーが行うことをAppsFlyerに通知します。  
af_ua ユーザーエージェント

クリックやインプレッションをサーバー間(S2S)で送信するアドネットワーク向けのパラメータです。

重要:クライアントからサーバー(C2S)へのリンクでは、af_uaを使用しないでください。 C2Sリンクでaf_uaを使用すると、アトリビューションに影響する場合があります。

ユーザーエージェント文字列は、以下の方法で送信します。

  1. URLパラメータ(URLエンコード済み)
  2. HTTPリクエストヘッダー(エンコードなし)

User-Agentは、URLパラメータとHTTPヘッダーで同じ値にしてください。

Androidでは、Client Hintsによってユーザーエージェントが簡略化される場合があります。その場合も送信してください。

  • 完全なユーザーエージェントの例:Mozilla/5.0 (Linux; Android 12; Pixel 5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.16 Mobile Safari/537.36
  • 簡略化されたユーザーエージェントの例:Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.0.0 Mobile Safari/537.36

iOSでは、iOS 26以降、バージョン情報が末尾に追加されます。 
以下に例を示します。

  • 追加される部分の例:Version/26.0.1 Mobile/15E148 Safari/604.1
  • 完全なユーザーエージェントの例:
    Mozilla/5.0 (iPhone; CPU iPhone OS 16_4_1 like Mac OS X) AppleWebKit/8615.1.26.10.24 (KHTML, like Gecko) Mobile/20E252 Version/26.0.1 Mobile/15E148 Safari/604.1

 

 
af_ip IP

クリックやインプレッションをサーバー間で送信するアドネットワーク向けのパラメータです。

重要:クライアントからサーバー(C2S)へのリンクでは、af_ipを使用しないでください。 C2Sリンクでaf_ipを使用すると、アトリビューションに影響する場合があります。

デバイスのIPアドレス

推奨:取得可能な場合は、af_ipパラメータにデバイスのIPアドレスを指定してください。

次の選択肢:利用可能な場合、AppsFlyerはX-Forwarded-For内のIPアドレスを使用します。

 
[非推奨]af_os OSバージョン

[iOSのみ]デバイスのOSバージョンです。

このパラメータは非推奨ですが、AppsFlyerは引き続き対応しています。推奨:代わりにaf_os_versionパラメータを使用してください。 

 
af_os_version OSバージョン
  • クリックやインプレッションをサーバー間で送信するアドネットワーク向けのパラメータです。
  • デバイスのOSバージョンです。
    • Android:
      • 例:12
      • ユーザーエージェントが簡略化されている場合(PCまたはAndroidでChrome 110以降のエンジンを使用するブラウザの場合)、アドネットワークはClient Hints APIでこの値を取得する必要があります。
      • ユーザーエージェントが簡略化されていない場合は、以下の正規表現で文字列からAndroidのOSバージョンを抽出します:(\d+(?:\.\d+)*);(?:\s..-..;)?\s(.+?(?=\)|\s\w*\/))。
    • iOS:
      • 正確に計測するため、OSバージョンは省略せずに指定してください。例:18.6.2

 
af_model デバイスモデル
  • クリックやインプレッションをサーバー間で送信するアドネットワーク向けのパラメータです。
  • デバイスのモデルです。
    • Android:
      • 例:Pixel 5
      • ユーザーエージェントが簡略化されている場合(PCまたはAndroidでChrome 110以降のエンジンを使用するブラウザの場合)、アドネットワークはClient Hints APIでこの値を取得する必要があります。
      • ユーザーエージェントが簡略化されていない場合は、以下の正規表現で文字列からAndroidのモデルを抽出します:(\d+(?:\.\d+)*);(?:\s..-..;)?\s(.+?(?=\)|\s\w*\/))。
    • iOS:
      • 正確に計測するため、デバイスモデルの識別子は省略せずに指定してください。例:iphone15,1 またはipad14,2。
 
af_media_type メディアタイプ

リンクを設定した広告の掲載場所を、以下の値で指定します。

  • app:アプリ内のリンク
  • web:モバイルWebサイト内のリンク
 
deep_link_sub1-10 N/A 追加のディープリンク値です。開発者は、値に応じた動作をコードに実装します。  
deep_link_value N/A ユーザーの移動先となる、アプリ内の特定のコンテンツを示す名前です。開発者は、deep_link_valueに応じた動作をコードに実装します。   
af_og_title N/A SNSにリンクを投稿した際、Open Graph(OG)タイトルの値がタイトルのプレビューに使用されます。 文字列・40文字
af_og_description N/A SNSにリンクを投稿した際、Open Graph(OG)説明文の値が説明文のプレビューに使用されます。 文字列・300文字
af_og_image N/A SNSにリンクを投稿した際、Open Graph(OG)画像の値が画像のプレビューに使用されます。  

計測リンクのパラメータ|リターゲティング専用

パラメータ ローデータでの表示名 説明 フィールドの型と長さ
is_retargeting リターゲティングの有無(キャンペーン)  すべてのリターゲティングキャンペーンのクリックURLに、&is_retargeting=trueを含める必要があります。
このパラメータがない場合や値が"false"の場合、通常のユーザー獲得キャンペーンとして扱われます。
列挙型・5文字
af_reengagement_window リエンゲージメント期間

計測リンクにこのパラメータを追加して、リエンゲージメント期間を変更できます。

指定可能な期間は以下のとおりです。

  • 日数:1~90日、または時間:1~36時間
  • Lifetime:リエンゲージメント期間を無期限にします。例: &af_reengagement_window=lifetime

デフォルト値:30日

例: &af_reengagement_window=30dを指定すると、リエンゲージメント期間は30日になります。

N/A

ビューアビリティのパラメータ

広告タイプに応じて、広告接触の詳細を示すビューアビリティのパラメータも送信できます。

パラメータ 値の形式 説明
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 広告ID Google広告ID。アドネットワーク側の対応が必要です。 最大40文字
sha1_advertising_id N/A SHA1でハッシュ化したGoogle広告ID。アドネットワーク側の対応が必要です。  
md5_advertising_id N/A MD5でハッシュ化したGoogle広告ID。アドネットワーク側の対応が必要です。 インストールとリアトリビューションにのみ対応しています。
android_id Android ID デバイスのAndroid_id。アドネットワーク側の対応が必要です。 最大20文字
sha1_android_id N/A SHA1でハッシュ化したデバイスのAndroid_id。アドネットワーク側の対応が必要です。  
md5_android_id N/A MD5でハッシュ化したデバイスのAndroid_id。アドネットワーク側の対応が必要です。 インストールとリアトリビューションにのみ対応しています。
imei IMEI デバイスのIMEI ID。  
sha1_imei N/A SHA1でハッシュ化したデバイスのIMEI ID。アドネットワーク側の対応が必要です。  
md5_imei N/A MD5でハッシュ化したデバイスのIMEI ID。アドネットワーク側の対応が必要です。  
oaid OAID Open Anonymous Device Identifier(匿名のデバイス識別子) Android SDK V4.10.3以降で利用できます。
sha1_oaid N/A SHA1でハッシュ化したOpen Anonymous Device Identifier。アドネットワーク側の対応が必要です。 Android SDK V4.10.3以降で利用できます。
md5_oaid N/A MD5でハッシュ化したOpen Anonymous Device Identifier。アドネットワーク側の対応が必要です。 Android SDK V4.10.3以降で利用できます。
af_android_url N/A

Androidユーザーを、Google Playのアプリページとは別のURLにリダイレクトします。サードパーティのアプリストアへの誘導に使用します。

注意:リダイレクトパラメータに関するその他の仕様と制限事項も参照してください。

 
sha1_el N/A PCからモバイルへのアトリビューションに使用する、SHA1でハッシュ化したメールアドレスです。アドネットワーク側の対応が必要です。  
fire_advertising_id N/A Amazon Fire広告ID  
af_android_store_csl store_product_page Google Consoleのカスタムストア掲載情報 文字列

iOS専用のパラメータ

パラメータ 表示名 説明
idfa IDFA

大文字を使用してください。アドネットワーク側の対応が必要です。

フィールドの長さ:最大40文字

idfv IDFV 大文字を使用してください。 
af_ios_url  

iOS(iPhoneまたはiPad)ユーザーを、iTunesのアプリページとは別のURLへ誘導する、ランディングページへのリダイレクトに使用します。

注意:リダイレクトパラメータに関するその他の仕様と制限事項も参照してください。

af_ios_store_cpp store_product_page

カスタムプロダクトページID(ppid)

注意:ローデータと集計レポートでは、af_ios_store_cpp(カスタムプロダクトページID)の値はクリックには記録されますが、インプレッションには記録されません。

af_ios_fallback[非推奨] N/A 非推奨:ユーザーはiOSのURIスキームのフローに基づいてリダイレクトされます。 
sha1_idfa N/A SHA1でハッシュ化したIDFAです。アドネットワーク側の対応が必要です。
sha1_idfv N/A SHA1でハッシュ化したIDFVです。
mac N/A デバイスのMACアドレスです。アドネットワーク側の対応が必要です。
md5_idfa N/A MD5でハッシュ化したIDFAです。
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つの注意点があります。

パートナーID(PID)パラメータ

計測リンクで使用できるパラメータのうち、PIDは必須です。 PIDは、AppsFlyerがメディアソースに割り当てる一意の識別子です。 

各連携済みパートナーには、末尾が_int の一意のPIDが割り当てられています。 OneLinkリンクでは、連携済みパートナー用に予約されていない値であれば、PIDを任意に設定できます。 

注意

メールやSMSなどのカスタムメディアソースで、予約済みのSRN名をPIDに使用した計測リンクは、AppsFlyerによってブロックされます。 この制限は、アドバンスSRNには適用されません。

主な予約済みのパブリッシャーIDには、organic、googleadwords_int(Google AdWords)、facebook_int(Meta広告)、twitter_int(X広告)などがあります。メール、SMS、伝書鳩などの未連携の流入元には、任意の名前を使用できます。

PIDでよくある問題の防止

  • 計測リンクには必ずPIDを含めてください。 計測リンクにPIDがない場合、ユーザーのメディアソースは自動的に「None」となり、元のインストールの流入元を把握できなくなります。
  • 連携済みの流入元では、インストールを正しく計測するため、その流入元に指定されたPIDのみを使用してください。
  • カスタムの流入元では、連携済みパートナーのPIDを使用しないでください。  メール、SMS、Facebookで自然拡散した無償の投稿などのカスタムメディアソースには、連携済みパートナーと異なるPID値を使用してください。たとえば、owned_email、sms_pushなど、連携済みパートナーの名前と一致しない独自の識別子を使用します。
  • 使用可能な文字のみを指定してください。計測リンクのPIDパラメータに、/<>*&?\のいずれかが含まれる場合、以下のようになります。
    • クリックやインストールが、ダッシュボードでaf_invalid_paramとして表示されます。
    • 計測リンクによるアトリビューションが行われません。
    • クリック時にディープリンクが機能しません。

 ヒント

PID値にスペースを含めないでください。含める場合は、計測リンクを使用する前に必ずURLエンコードしてください。

サイトIDパラメータ

サイトIDは、広告を配信するパブリッシャーを識別する一意のIDです。つまり、広告を表示するWebサイトやアプリを示します。アドネットワークは、パブリッシャーごとに一意のサイトIDを割り当てます。 

このIDは、計測リンクのaf_siteidパラメータでAppsFlyerに送信され、各種ダッシュボード、レポート、ポストバックで確認できます。 

以下の理由から、計測リンクでサイトIDをAppsFlyerに送信する必要があります。

  • 広告の掲載先を明確にし、透明性を確保するため。
  • AppsFlyerによる、不正なパブリッシャーやその他のトラフィックのグループの特定・排除に使用するため。

サイト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がない:クリックURLのaf_siteidパラメータが空です。サイトIDが空の広告接触の送信は、技術的な問題、または不正検知の仕組みを意図的に回避しようとしている可能性を示します。
  • 複数のサイトIDを使用している:同じパブリッシャーについて、複数のクリックURLで異なるサイトIDが送信されています。これは、パブリッシャーの実際の活動を隠す不正行為とみなされ、多くの場合、クリック洪水に関連しています。
  • サイトIDの形式が不適切:不適切な形式での送信に他の不正の兆候が重なると、特定のパブリッシャーだけでなく、より上位のグループ単位でブロックされ、パートナーのトラフィックの広い範囲に影響する場合があります。

インストールのブロックを防ぐため、例に示すとおり、パブリッシャーごとに単一のサイトIDを送信してください。

データの詳細度の階層

最大4つのURLパラメータを使用して、広告のパフォーマンスを詳しく分析できます。

使用中のすべての計測リンクに4つのパラメータをすべて含めると、以下が可能になります。

  • すべてのユーザーのインストールとイベントを、個々の広告に紐付ける。
  • 集計レポートで広告セット別、キャンペーン別、メディアソース別に掘り下げ、各広告のパフォーマンスを比較して、それぞれの階層で最適化する。
  • ローデータレポートとピボットテーブルで、すべてのメディアソースの広告を比較する。

対象のパラメータは以下のとおりです。

  • メディアソース(pid=)
  • キャンペーン名(c=)
  • 広告セット(af_adset=)
  • 広告名(af_ad=)

 例

以下の計測リンクでは、連携済みメディアソース「network」の「winter」キャンペーンにある「coats」広告セット内の「cashmere」広告を、4階層の情報で記録しています。

https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere

よくある質問

パラメータでは大文字と小文字のどちらを使用すべきですか?

どちらも使用できますが、表記を統一する必要があります。カスタムパラメータで大文字・小文字を指定した場合は、常に同じ表記で使用してください。

たとえば、pid=MyMediaSourceと設定した場合は、常にその表記を使用します。ある計測リンクでpid=MyMediaSource、別のリンクでpid=mymediasourceを使用すると、データに差異が生じる場合があります。計測リンクに設定する他のパラメータも同様です。

AppsFlyerの計測リンクは動的ですか、それとも静的ですか?

計測リンクには、動的なものと静的なものがあります。
動的か静的かは、どのように見分けられますか?
パラメータを含む計測リンクは、値があらかじめ定められた長いリンクであり、静的です。
カスタム計測リンクで使用する短縮URLのみ(例:yourbrand.onelink.me/HaT8/r5c2b371)が動的です。
つまり、連携済みパートナー用の計測リンクやオウンドメディア用の長いURLは、使用を開始した後にAppsFlyerの管理画面で設定値を変更しても、そのリンクを利用するユーザーに適用される値は変わりません。変更を反映するには、それ以降、新しい長いURLを使用する必要があります。
一方、オウンドメディア用の短縮URLは、パラメータを直接含みません。見込みユーザーがAppsFlyerの短縮URLに反応すると、AppsFlyerにリダイレクトされ、その時点で設定されているパラメータが動的に適用されます。

Playストアでこのエラーメッセージが表示されるのはなぜですか?

計測リンクを開いた後、Playストアで以下のエラーメッセージが表示される場合があります。

TL_error_message.png

これは、計測リンクに#が含まれているためです。例:

https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#

通常、これらの文字はマクロとしてリンクに含まれ、実際には値に動的に置き換えられるため、大きな問題はなく、メッセージは無視できます。

サブパラメータは何に役立ちますか?

サブパラメータ(af_sub1、af_sub2、…、af_sub_5)を使って、必要なKPIを記録できます。これらのパラメータは解析されてローデータレポートに表示されるため、データの集計や絞り込みに便利です。

 例

配車アプリのLuberでは、青、黄、赤の3色のテンプレートを使ったクリエイティブを配信しています。 Luberのモバイルマーケティング担当者Lindaは、最も多くのインストールにつながる色を検証したいと考えています。そこで、すべての非SRNメディアソースで配信している青い広告の計測リンクに、&af_sub3=blueを追加します。黄色と赤の広告にも、同様に対応します。この情報が解析されてローデータレポートに表示されるため、Lindaは色別の広告の成果を分析し、コンバージョン率が最も高い色を選べます。

キャンペーン名にはどのような制限がありますか?

  • 計測リンクのURLで指定するキャンペーン名は、最大100文字です。上限を超えると、キャンペーン名はc_name_exceeded_max_lengthに変更されます。
  • ダッシュボードやレポートに差異が生じる場合があるため、キャンペーン名の先頭や末尾にスペースを含めないでください。

仕様と制限事項

項目 備考
特殊文字  パラメータのキーと値には、以下の特殊文字を使用できません(redirectとaf_dpパラメータを除く): ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %, ),(
リダイレクトパラメータ
  • リダイレクト先URLのドメインが、リダイレクト許可リストに追加されていることを確認してください。
  • リダイレクト先には、RFC 1738に準拠した、外部からアクセスできる完全な有効なWeb URL(https://[domain][optional-path])を指定する必要があります。
  • リダイレクトURLでは、URIフラグメント識別子(記事内の特定のセクションへスクロールする#webpagesectionなど)には対応していません。 
URLの文字数上限  URL全体の長さは2,000文字以内にしてください。
AndroidのSNSアプリのWebViewでのディープリンクによるリダイレクト 制限の詳細は、こちらを参照してください。
AndroidのNaver Blogアプリではディープリンクに非対応 AndroidのNaver Blogアプリでは、ディープリンクに対応していません。ユーザーは、リンクの設定に応じてGoogle PlayストアまたはWebにリダイレクトされます。
iOSのChromeでURIスキームのリンクをクリックするとポップアップが表示される iOS版Chromeの仕様変更により、ユーザーがURIスキームのリンクをクリックすると、アプリを開くか、App Storeに移動するかを確認するポップアップが表示されます。
URIスキームの有効性に関する要件 RFC 3986に準拠した有効なURIスキームの使用を推奨します。準拠していないスキームは、WebViewなどのWeb環境からクリックした際、アプリを開けず、エラーになる場合があります。
TelegramのWebViewでのアトリビューション 制限の詳細は、こちらを参照してください。