概要:Hubscaleを利用するアドネットワークが、AppsFlyerと連携する方法を紹介します。
連携を開始するには、以下をAppsFlyerに送付する必要があります。
- アトリビューションリンク
- ポストバック(インストールとアプリ内イベント用)
アトリビューションリンクの作成
アトリビューションリンクは、以下のAppsFlyerの基本リンクに、アドネットワークが追加するマクロを組み合わせて作成します。
AppsFlyerの基本のアトリビューションリンクと、各マクロの詳細を以下に示します。
| AppsFlyerのベースURL | 説明 |
|---|---|
|
https://app.appsflyer.com |
AppsFlyerのエンドポイント |
|
app_id |
アプリ固有のID。プロモーションするアプリごとに値が異なります。 |
|
pid |
メディアソース名に_intを付けます。これは、連携済みのネットワークを識別するために使用されます。 |
|
c |
キャンペーン名 |
Hubscaleの追加マクロを設定したアトリビューションリンクの完成例を以下に示します。
https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid=
{transaction_id}&af_siteid={affiliate_id}&af_sub5={offer_id}af_ad_id=
{offer_file_id}&advertising_id={google_aid}&idfa={ios_ifa}" target="
_blank" rel="nofollow noopener noreferrer" data-is-link="https://
app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid={transaction_id}
&af_siteid={affiliate_id}&af_sub5={offer_id}af_ad_id={offer_file_id}
&advertising_id={google_aid}&idfa={ios_ifa}">
https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid=
{transaction_id}&af_siteid={pub_id}-{sub_pub_id}&advertising_id=
{google_id}&idfa={ios_ifa}
インストールとアプリ内イベントのグローバルポストバック
Hubscaleでは、インストールとアプリ内イベントにグローバルポストバックを使用します。
インストールの場合:
https://companyname.156th.com/conv?transaction_id={publisher_ref_id}&ios_ifa={ios_ifa}
&google_id={google_aid}&app_version={app_version}&language={language}&ext_country_code={country_code}
&ext_city={city}&user_agent={user_agent}&user_ip={device_ip}&adv_revenue={revenue_usd}Hubscaleでは、同じトランザクションIDについて、インストール後のイベントを最大9件記録できます。以下のように、9つのグローバルポストバックをテンプレートとして作成する必要があります。
| イベント番号 | URLテンプレート |
|---|---|
| イベント2(イベント1はインストール) | https://companyname.156th.com/conv?transaction_id={publisher_ref_id}
&ios_ifa={ios_ifa}&google_id={google_aid}&app_version={app_version}
&language={language}&ext_country_code={country_code}&ext_city={city}
&user_agent={user_agent}&user_ip={device_ip}
&adv_revenue={revenue_usd}&level=2 |
| イベント3 | https://companyname.156th.com/conv?transaction_id={publisher_ref_id}
&ios_ifa={ios_ifa}&google_id={google_aid}&app_version={app_version}
&language={language}&ext_country_code={country_code}&ext_city={city}
&user_agent={user_agent}&user_ip={device_ip}
&adv_revenue={revenue_usd}&level=3
|
| イベント4 | ... |
| ... | ... |
| イベント10 | https://companyname.156th.com/conv?transaction_id={publisher_ref_id}
&ios_ifa={ios_ifa}&google_id={google_aid}&app_version={app_version}
&language={language}&ext_country_code={country_code}&ext_city={city}
&user_agent={user_agent}&user_ip={device_ip}
&adv_revenue={revenue_usd}&level=10
|
イベントタグは、広告主がイベントをマッピングする際に入力する値です。
Hubscaleを利用するパートナーの名前がPARTNERの場合、ドメインは通常partner.156th.comとなります。
汎用のアトリビューションリンク:
https://app.appsflyer.com/com.appsflyer?pid=partnername_int&clickid={transaction_id}&af_siteid={pub_id}-{sub_pub_id}&advertising_id={google_id}&idfa={ios_ifa}登録の完了
- すでにAppsFlyerと連携している場合は、パートナーアシスタントウィジェットからお問い合わせください。
- まだAppsFlyerと連携していない場合は、広告パートナー登録フォームに必要事項を入力してください。
AppsFlyerのパラメータとHubscaleのマクロの対応
| AppsFlyerのパラメータ | Hubscaleのマクロ | 説明 |
|---|---|---|
|
pid |
pub_id | 連携済みパートナーのメディアソース名です。 変更しないでください。詳細はこちら |
|
c |
campaign_name | キャンペーン名。広告主が指定します。 |
|
clickid |
transaction_id |
アドネットワークが発行する一意のクリック識別子 |
|
af_siteid |
pub_id |
アドネットワークのパブリッシャーID |
|
af_sub_siteid |
sub_pub_id |
広告サブネットワーク / パブリッシャーのID |
|
af_c_id |
campaign_id |
キャンペーンID。広告主が指定します。 |
|
af_adset |
広告セット名。広告主が指定します。広告セットは、 |
|
|
af_ad |
adv_name | 広告名(詳細はこちら) |
|
af_ad_id |
adv_id | 広告ID |
|
af_cost_model |
adv_payout_model | コストモデル。現在対応しているのは CPIのみです。 |
|
af_cost_currency |
adv_payout_currency | 通貨コード(例:USD) |
|
af_cost_value |
adv_payout_amount | コスト値 |