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

概要:  AppsFlyerの計測リンク構造とパラメータについて学びましょう。

概要

計測リンクを利用することで、広告におけるユーザーのエンゲージメントについてのデータを収集できます。計測リンクは広告の背後に配置され、ユーザーが広告に接触すると、AppsFlyerに通知されます。このエンゲージメントは、広告クリックまたは広告インプレッションの表示で発生します。 アトリビューションURLのコピーが、AppsFlyerに送信されます。

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

  OneLink(マルチプラットフォームリンク) 単一プラットフォームリンク
説明と使用するタイミング

使用ケース:

  • すべてのプラットフォームに対する単一のリンクが必要な場合。
  • ディープリンク機能が必要な場合。
  • AndroidアプリリンクまたはiOSユニバーサルリンクを使用してアプリを起動したい場合。

OneLinkの詳細はこちら

使用ケース:

  • 単一のプラットフォームのみを使用したい場合。(たとえば、iOSを使わずにAndroidのみを使用する場合)
  • アプリの起動にURIスキームのみを使用する場合。

連携済みパートナーの設定方法についての詳細はこちら

前提条件 OneLinkテンプレート なし
含まれる情報
ベースURL {サブドメイン}.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プロトコルのみをサポートしています。

計測リンクパラメーター

  • ここにリストされているパラメーターは、計測リンクで使用できます。
  • フィールドタイプ値の列は、パラメーター値の文字数制限です。パラメーター値の長さの制限については、こちらをご覧ください。

計測リンクパラメーター — ユーザー獲得とリターゲティング

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

パラメーター ローデータでの表示名 説明 フィールドタイプと長さ
pid Media Source AppsFlyerの統合パートナーを一意に識別します。変更しないでください。詳細はこちら 文字列 150
c Campaign 広告主またはパブリッシャーによって提供されます。キャンペーン名の制限を参照してください。 文字列
af_prt Partner
  • 代理店アカウント名により、インストールを代理店に紐づけることができます。
  • 注意:代理店権限付与設定が有効でない場合は、このパラメータを使用しないでください。
文字列 50
af_mp 該当なし
  • インストールごとに媒体のマーケティングパートナーへのポストバック送信を有効にします。
  • 注:現在、このパラメータはPinterestマーケティングパートナーにのみ関連します。
 
clickid 該当なし アドネットワークのユニーククリック識別子  
af_siteid Site ID
  • 広告を表示するパブリッシャーを識別する一意のID。詳細はこちら
文字列24
af_sub_siteid Sub Site ID
  • アドネットワークのサブネットワーク/パブリッシャーID。
  • メインパブリッシャー(サイトID)に加えてサブパブリッシャーがある場合、またはバナー、インタースティシャル、ビデオなど、アプリ内の広告タイプ/配置情報を含める場合は、af_sub_siteidを使用します。例: af_sub_siteid =ABCD_4567
文字列
af_c_id Campaign ID 広告主/パブリッシャー提供 文字列24
af_adset Adset
  • 広告主/パブリッシャーによって提供されます。
  • 広告セットはキャンペーンと広告の間の階層の中間レベルです。もっと見る
文字列100
af_adset_id Adset ID 広告主/パブリッシャー提供 文字列24
af_ad Ad 広告主/パブリッシャーが提供した広告名(詳細 文字列100
af_ad_id Ad ID 広告主/パブリッシャー提供 文字列24
af_ad_type Ad type

 次の命名規則を利用します。

  • native:メディアソースのコンテンツに合わせて設計された有料メディア。このメディアは自然なコンテンツのビジュアルデザインと機能に一致するように設計されており、おすすめ動画のフィードに表示されます。
  • banner:ディスプレイ広告は、通常、Webページやアプリのインターフェースに表示される小さな長方形の広告です。
  • interstitial:ホストアプリのインターフェース全体を覆うフルスクリーン広告。これらの広告はコンテンツの間に配置されるように設計されており、通常はアクティビティやゲームレベルの間、または一時停止中に表示されます。
  • rewarded_video:ユーザーが最後まで視聴することを選べる広告で、視聴するとアプリ内の特典(例えば、ゲーム内での追加ライフのための動画視聴、記事へのアクセス、空港でのWi-Fi利用)が得られるものです。これらの「報酬付き」広告はユーザーを引き付け、アプリの体験全体を向上させます。
  • audioオンラインポッドキャストや音楽ストリーミングプラットフォームで配信されるオーディオ形式の広告です。
  • offerwallデベロッパーがアプリを収益化するために使用するアプリ内の広告単位です。これはアプリ内のミニストアのように機能し、ユーザーがアプリ内の報酬を得るために完了できる複数の「オファー」をリストします。
文字列24
af_ad_format Ad format

 次の命名規則を利用します。

  • text通常は短いテキストとして表示されるテキストベースの広告です。これには、関心を喚起し、ウェブサイトやランディングページへのクリックスルーを促すように設計された見出し、説明、リンクまたは行動喚起が含まれることがあります。
  • imageグラフィックや写真を使用して製品、サービス、またはブランドを紹介する視覚的な広告です。通常、魅力的な画像と簡潔なテキストが含まれ、行動喚起のフレーズも組み込まれることがあります。
  • videoオーディオビジュアルコンテンツを使用してマーケティングメッセージを伝えるデジタル広告です。長さはさまざまで、オンライン動画コンテンツ内のプレロール、ミッドロール、ポストロールとして表示されることも、さまざまなプラットフォーム上のスタンドアロン動画として現れることもあります。
  • playableユーザーがダウンロードや購入を行う前に、ゲームやアプリのミニチュア版を体験できるインタラクティブ広告です。ユーザーは実際のゲームプレイやアプリの機能を実際に体験することができます。
  • interactiveユーザーの交流や参加を促す、魅力的で動的な広告です。ユーザーの注意を引き、積極的な参加を促すために、クイズ、アンケート、その他のインタラクティブな要素が含まれることがあります。
  • dynamic_productユーザーの行動、好み、閲覧履歴に基づいて、製品の情報や詳細を動的に表示するパーソナライズされた広告フォーマット。これにより、広告主は個人に対して関連性の高いカスタマイズされた製品広告を表示できます。
  • carousel1つの広告内に複数のスライドまたはカードが含まれる広告形式。各カードには異なる画像、見出し、説明を含めることができ、広告主は1つの広告で複数の製品や機能を紹介できます。
 
af_click_lookback Attribution lookback window
  • クリックアトリビューションのルックバック期間。この期間内であれば、新規ユーザーが広告/リンクを表示したソースに帰属します。最大CTIT(クリックからインストールまでの時間)です。
  • ルックバッククリックアトリビューション期間に設定可能な日数。使用可能なパラメーター値:1日 - 30日 (日数) または 1時間 - 23時間 (時間数)。デフォルト値は7日です。
  • ルックバック期間は、OneLinkとSRNに対してカスタマイズ可能です。

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

最大3文字
af_viewthrough_lookback 該当なし
  • ルックバックビュースルーアトリビューション期間に設定可能な時間数。使用可能なパラメーター値:1時間 - 24時間(時間)。デフォルトは24時間です。
  • ルックバック期間は、SRNに対してカスタマイズ可能です。

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

最大3文字
af_channel Channel 広告が配信されるメディアソースチャネル (例:UAC_Search、UAC_Display、Instagram、Meta Audience Networkなど)。 動的列挙型。文字列20
af_engagement_destination Engagement destination 広告にリンクされた遷移先のカテゴリを示します。例えば、ウェブ ランディングページ、モバイル アプリ(ディープリンクまたはアプリストア経由)、または CTVPCコンソール などの他のタイプのものです。 文字列 50
af_keywords Keywords テキストターゲットキャンペーンのためのキーワードリスト 文字列100
af_cost_model Cost model 文字列20
af_cost_currency Cost currency
  • ISO-4217に準拠した3文字の通貨コード。 例:USD、ZAR、EUR
  • [デフォルト]:USD
列挙型。3文字 
af_cost_value Cost value
  • コスト通貨を利用した場合のコスト値。
  • 小数点以下4桁まで可能です。
  • 数字のみを設定してください(必要であれば小数点を使用)例:「56」、「2.85」
数値

af_sub[n] 

(n=1-5) 例: af_sub1

Sub param [n] 広告主が設定した任意のカスタムパラメーター。これらのパラメーターの利用方法については、「特性と制限事項」セクションをご確認ください。 文字列100
af_r 該当なし

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

マルチプラットフォームリンク(OneLink)では、このパラメーターは次のことを行います。

  • テンプレートレベルのリダイレクト設定を上書きする
  • 次のリンクレベルのパラメーターによって上書きされます。

注:参照:追加のリダイレクトパラメータの特性と制限

 
af_web_dp 該当なし

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

注:参照:追加のリダイレクトパラメータの特性と制限

 
af_dp 該当なし

ユニバーサルリンクまたはAndroidアプリリンクメソッドが失敗したときや、Android 6.0未満のユーザー向けにアプリを起動するためのURIスキームフォールバック値。ベースパス、つまりデフォルトのアクティビティのみを指す必要があります。

注:このパラメータにWebのURLの値を使用する場合(非推奨です)、リダイレクトパラメータの特性と制限を確認してください。

 
af_force_deeplink 該当なし af_dpの値で指定されたアクティビティへのディープリンクを強制する  
af_ref 該当なし
S2Sクリックを利用する広告ネットワークは、次のパラメーターを利用して一意のリファラー値を送信することができます: &af_ref=ReferrerValue
af_refの値は次のように構成された一意の価値である必要があります。
ネットワーク名_クリックごとのユニーククリック値
例: af_ref=networkname_123456789ABCDEF
 
ネットワーク名には任意の有効な文字列を指定できます。ネットワーク名をnetworkname_intまたはそのまま使うことも可能です。
 
AppsFlyerは、Androidデバイスのアトリビューションにこのパラメーターを使用することがあります。AppsFlyerは、iOSまたはWindowsデバイスのアトリビューションにこのパラメーターを使用しません。
 
is_incentivized 該当なし
ブール値:true/false
インセンティブ付きまたはなしのキャンペーン
 
af_param_forwarding 該当なし
  • falseに設定すると、アトリビューションリンクのパラメーターはリダイレクトされたページに転送されません。
  • リダイレクトページのURLをすっきり見せたい場合や、アトリビューションリンクのパラメーターがクエリパラメータ処理で問題を引き起こす可能性がある場合に使用します。
 
af_base_params_forward 該当なし
  • falseに設定すると、アトリビューションリンク上のAppsFlyerのPIDとCパラメーターはリダイレクトされたページに転送されません。
  • この設定は、デスクトップからクリックされるURLで重要なCRMパラメーターを保持しながら、AppsFlyer PIDとCパラメーターを削除したい場合に使用します。これにより、URL内に複数のPIDが含まれるのを避けられます。
 
af_partner_account_id Network Account ID そのパートナーにおける広告主のアカウントID 文字列100
redirect 該当なし &redirect=falseの場合、このパラメーターは、これがS2Sクリックであり、クリックしたユーザーのリダイレクトがパートナーの責任であることをAppsFlyerに知らせます。  
af_ua User-agent

クリックとインプレッションをサーバー間で送信するアドネットワークに関連します。

【重要】クライアントからサーバーへのリンク(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 version

[iOSのみ] デバイスのオペレーティングシステムのバージョン。

このパラメータは非推奨ですが、AppsFlyerでは引き続きサポートされています。推奨:af_os_versionパラメータを利用してください。 

 
af_os_version OS version
  • クリックとインプレッションをサーバー間で送信するアドネットワークに関連します。
  • デバイスのオペレーティングシステムのバージョン。
    • Android:
      • 例:12
      • ユーザーエージェントが縮小されている場合(ブラウザがデスクトップまたはAndroidで実行されており、Chrome 110以降のエンジンを使用しているため)、アドネットワークはClient Hints APIを使用してこの値を取得する必要があります。
      • 縮小されていないユーザーエージェントの場合、次の正規表現を使用してユーザーエージェント文字列からAndroid OSバージョンを抽出します:
    • iOS:
      • 正確なアトリビューションのために、完全なOSバージョンを含めてください。例:18.6.2

 
af_model Device model
  • クリックとインプレッションをサーバー間で送信するアドネットワークに関連します。
  • デバイスモデル。
    • Android:
      • 例:Pixel 5
      • ユーザーエージェントが縮小されている場合(ブラウザがデスクトップまたはAndroidで実行されており、Chrome 110以降のエンジンを使用しているため)、アドネットワークはClient Hints APIを使用してこの値を取得する必要があります。
      • 縮小されていないユーザーエージェントの場合、次の正規表現を使用してユーザーエージェント文字列からAndroidモデルを抽出します:
    • iOS:
      • 正確なアトリビューションのために、デバイスモデル識別子全体を含めてください。例:iphone15,1 , ipad14,2
 
af_media_type Media type

リンクを含む広告の配置は次の通りです。

  • アプリ:リンクはアプリ内で利用可能です
  • ウェブ:リンクはモバイルウェブサイト内で利用可能です
 
deep_link_sub1-10 該当なし 追加のディープリンク値。デベロッパーは、コード内で値の望ましい動作を実装します。  
deep_link_value 該当なし ユーザーが誘導される特定のアプリ内コンテンツの名前。デベロッパーは、コード内でdeep_link_valueの望ましい動作を実装します。   
af_og_title 該当なし リンクがソーシャルメディアに投稿されると、オープングラフ (OG) タイトルによってタイトルのプレビューが生成されます。 文字列40
af_og_description 該当なし リンクがソーシャルメディアに投稿されると、オープングラフ (OG) 説明によって説明のプレビューが生成されます。 文字列300
af_og_image 該当なし リンクがソーシャルメディアに投稿されると、オープングラフ (OG) 画像によって画像のプレビューが生成されます。  

アトリビューションリンクパラメーター—リターゲティングのみ

パラメーター ローデータでの表示名 説明 フィールドタイプと幅
is_retargeting Is Retargeting (campaign)  すべてのリターゲティングキャンペーンのクリックURLには&is_retargeting=trueを含める必要があります。
パラメーターが含まれていないか、その値が「false」の場合、キャンペーンは通常のユーザー獲得キャンペーンと見なされます。
列挙型 5 文字
af_reengagement_window Re-engagement window

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

可能な期間範囲オプションは次のとおりです。

  • 日数:1-90 または 時間 1-36
  • 有効期間:つまり、リエンゲージメント期間は無制限です。例: &af_reengagement_window=lifetime

デフォルト値:30日間

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

該当なし

視認性パラメーター

広告の種類に応じて、エンゲージメントの仕様を詳細に説明するための関連する視認性パラメーターを送信できます。

パラメーター 値のフォーマット 説明
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 該当なし SHA1でハッシュ化されたGoogle Advertising ID - アドネットワークのサポートが必要  
md5_advertising_id 該当なし MD5でハッシュ化されたGoogle Advertising ID - アドネットワークのサポートが必要 インストールとリエンゲージメントのみサポートされます
android_id Android ID デバイスのAndroid_id - アドネットワークのサポートが必要 最大20文字
sha1_android_id 該当なし SHA1でハッシュ化されたデバイスのAndroid_id - アドネットワークのサポートが必要  
md5_android_id 該当なし MD5でハッシュ化されたデバイスのAndroid_id - アドネットワークのサポートが必要 インストールとリエンゲージメントのみサポートされます
imei IMEI デバイスのIMEI ID。  
sha1_imei 該当なし SHA1でハッシュ化されたデバイスIMEI ID - アドネットワークのサポートが必要  
md5_imei 該当なし MD5でハッシュ化されたデバイスIMEI ID - アドネットワークのサポートが必要  
oaid OAID オープン匿名デバイス識別子 Android SDKバージョン4.10.3以降で利用可能
sha1_oaid 該当なし SHA1でハッシュ化されたオープン匿名デバイス識別子 - アドネットワークのサポートが必要 Android SDKバージョン4.10.3以降で利用可能
md5_oaid 該当なし MD5でハッシュ化されたオープン匿名デバイス識別子 - アドネットワークのサポートが必要 Android SDKバージョン4.10.3以降で利用可能
af_android_url 該当なし

AndroidユーザーをGoogle Playのアプリページとは異なるURLにリダイレクトします。サードパーティのアプリストアで使用します。

注:参照:追加のリダイレクトパラメータの特性と制限

 
sha1_el 該当なし デスクトップからモバイルへのアトリビューションに使用されます - SHA1でハッシュされたメール。アドネットワークのサポートが必要  
fire_advertising_id 該当なし Amazon Fire広告ID  
af_android_store_csl store_product_page Googleコンソールのカスタムストアリスティング string

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 [非推奨] 該当なし 非推奨:ユーザーはiOS URIスキームフローに基づいてリダイレクトされます。 
sha1_idfa 該当なし SHA1でハッシュされたIDFA。アドネットワークのサポートが必要
sha1_idfv 該当なし SHA1でハッシュされたIDFV
mac 該当なし デバイスのMACアドレス。アドネットワークのサポートが必要
md5_idfa 該当なし MD5でハッシュ化されたIDFA
md5_idfv 該当なし MD5でハッシュされたIDFV
sha1_mac 該当なし 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によって割り当てられた メディアソース毎に 一意の識別子です。 

連携済みパートナーは それぞれユニークなPID値を持ち、末尾に_int が付与されています。 OneLinkリンク を使用する際 、PIDは任意の値に設定できます。(その値が 連携済みパートナーによって 既に利用されていない場合に限ります) 

 注意

AppsFlyerでは、メールやSMSなどのカスタムメディアソースにおいて、 PID値にSRN 向けに使用されている名称を使用した 計測リンクはブロックされます。 この制限はアドバンスSRNには適用されません。

既に使用されている重要なPIDの例:organic、 googleadwords_int(Google AdWords)、facebook_int(Meta広告) 、 twitter_int(X広告)。 メールやSMSなど、計測連携していない場合には任意の名前を 使用できます 。

一般的なPIDの問題を回避するために:

  • 計測リンクには必ずPIDのパラメータを含めてください。 計測リンクにPIDがない場合、ユーザーは自動的に 「None」のメディアソースにアトリビューションされ、元のインストール ソースは消えてしまいます。
  • 各連携済みメディアソースでは、インストールを正しく アトリビューションするために、 指定されたPIDのみを使用してください。
  • カスタムソースに対しては、連携済みパートナーが使っていないPIDの値を使用してください。  メール、SMS、Facebook上の 非広告のバイラル投稿など、 vカスタムメディアソースには、owned_emailsms_push など、連携済みパートナーの名称と 一致しない独自の PID値を 使用してください。
  • 合法な文字のみを使用してください。アトリビューションリンクのPIDパラメーターに、 次のいずれかの文字が含まれている場合: /<>*&?\
    • 管理画面上では、クリックやインストールは以下メディアソースに計測されます: af_invalid_param
    • 計測リンクには正しく成果が紐づけられません。
    • クリックに対してディープリンク機能が動作しません。

TIPS

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の不足:基準となるaf_siteid のクリックURLにおけるパラメータの値が空です。サイトIDが 空の状態で 送信されたエンゲージメントは、技術的な問題、または不正検知メカニズムを意図的に回避しようとする試みのいずれかを示します。
  • 複数のサイトID:同一の媒体社が、 異なるサイトIDを 使用した複数のクリックURLで送信されています。これは、 実際の媒体社のアクティビティを 隠蔽する不正行為と 見なされ 、多くの場合、 クリック洪水と関連しています。
  • サイトIDの形式が不正: 誤った 形式でデータを送信し、さらに他の不正兆候も確認された場合、特定の媒体社だけでなく、より上位の クラスターレベル で ブロックされる可能性があります。その結果、パートナーのより 広範なアクティビティに影響が及ぶことがあります。

インストールがブロックされないよう、例に示すとおり、媒体社ごとに1つの サイトIDパラメーター のみを送信してください。

データ粒度のレベル

最大4つのURLパラメーターを利用して、広告のパフォーマンスを深く分析することができます。

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

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

パラメーターは次のとおりです。

  • Media source (pid=)
  • campaign name (c=)
  • Ad set (af_adset=)
  • Ad name (af_ad=)

 

次のアトリビューションリンクは、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(例: )のみが動的です。
つまり、統合パートナー用のアトリビューションリンクやオウンドメディアの長い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
  • キャンペーン名は空白で始まったり終わったりしないようにしてください。ダッシュボードやレポートで矛盾が生じる可能性があります。

特性と限界

特性 備考
特殊文字  次の特殊文字は、パラメータのキーと値に使用できません(リダイレクトおよびaf_dpパラメータには適用されません):  ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %, ),(
リダイレクトパラメータ:
  • リダイレクトURLのドメインがリダイレクト許可リストに追加されていることを確認してください。
  • リダイレクトの値は、完全に有効な(かつ公開アクセス可能な)ウェブURL(https://[ドメイン][任意のpath])でなければならず、RFC 1738標準に従う必要があります。
  • リダイレクトURLではURIフラグメント識別子サポートされていません。(例:ユーザーを記事の特定のセクションにスクロールさせる#webpagesection) 
URLの文字数制限  URLの合計最大文字数は2000文字です。
AndroidソーシャルアプリのWebViewディープリンクリダイレクト 制限の詳細についてはこちらをご覧ください。
AndroidのNaver Blogアプリではディープリンクはサポートされていません。 AndroidのNaver Blogアプリではディープリンクはサポートされていません。ユーザーは、リンクに従ってGoogle PlayストアまたはWebにリダイレクトされます。
iOS版ChromeブラウザでURIスキームリンクをクリックするとポップアップが表示されます。 Chrome iOSの変更により、ユーザーがiOS上のChromeでURIスキームリンクをクリックするたびにポップアップが表示され、アプリを開くかアプリストアにリダイレクトするかの確認が求められます。
URIスキームの有効性要件 有効なURIスキームとしてRFC 3986に準拠することをお勧めします。上記に準拠していないスキームでは、Webビューや他のWeb環境からのクリックでアプリが開かず、エラーが発生する可能性があります。
Telegram WebViewのアトリビューション 制限の詳細についてはこちらをご覧ください。