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

HubscaleとAppsFlyerの連携

  • 更新

概要:Hubscaleを利用するアドネットワークが、AppsFlyerと連携する方法を紹介します。

連携を開始するには、以下をAppsFlyerに送付する必要があります。

  1. アトリビューションリンク
  2. ポストバック(インストールとアプリ内イベント用)

アトリビューションリンクの作成

アトリビューションリンクは、以下の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}

AppsFlyerのパラメータ一覧

インストールとアプリ内イベントのグローバルポストバック

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

イベントタグは、広告主がイベントをマッピングする際に入力する値です。

In-App_Events.png

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のパラメータと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 コスト値