ポストバック可能なパラメータとAppsFlyerにおけるマクロ

  • 広告主
  • 広告ネットワーク

はじめに

When mobile users install or perform in-app events, AppsFlyer sends postbacks to the originating networks or to other endpoints. These postabacks may include a wide array of macros.

There are 3 different sources for postbacks data, which AppsFlyer can send back to ad networks:

  1. トラッキングリンクパラメータ
    パートナーから提供されるクリックURLまたはインプレッションURLのパラメータは、ポストバックURLに追加して返すことができます。
    例:トラッキングリンクのclick IDパラメーター - "&click_id=CLICK_ID"
  2. Partner IDs in AppsFlyer
    Unique IDs given to the advertiser by the partner can be sent back via postbacks.
    Examples: app ID, account ID, user ID, network ID, SDK key etc.

    integration_key.png

  3. SDKによる取得情報
    AppsFlyer SDKがデバイスから収集した情報。 
    例:iOSデバイスIDは、ポストバックに"&IDFA=(idfa)" を使用することで取得できます。 

 重要:

ポストバックメッセージのストラクチャとデータを更新するには、アドネットワークからAppsFlyerのパートナーディベロップメント担当にご連絡いただく必要があります。

サポートされているポストバックのマクロ

AppsFlyerで対応しているマクロの一覧を次に記載します。これらのマクロは、ポストバックで使用すると、関連するユーザーデータに自動的に置き換えられます。たとえば、インストール中のユーザーのIPアドレスを取得するには、ポストバックURLに"&ip_address=(ip)" を追加します。 

インストールおよびアプリ内イベントのマクロ

マクロ データソース 説明

(idfa)

SDK

iOSにおける広告ID
(sha1-idfa) も使用可。

(advertiserId)

SDK

Androidの広告ID(Android GAID)
(sha1-advertiserId) も使用可。

(android-id)

SDK

Android ID
(sha1-android-id) も使用可。

(app-id)

SDK

アプリIDの名前 

(wifi)

SDK

コンバージョン時にユーザーが使用したデータ接続の種類("TRUE" または "FALSE")

(install-unix-ts)

SDK

インストール(アプリの初回起動時)のタイムスタンプ(UNIX時間)

(click-ts)

SDK

AppsFlyerのトラッキングリンクのクリック時刻またはインプレッション時刻

(campaign)

リンク

AppsFlyerのトラッキングリンクで送信されるキャンペーン名(c=)

(publisher_id)

リンク

AppsFlyerのトラッキングリンクで送信されるサイトID(af_siteid=)

(country-code)

SDK

コンバージョン時に記録される 2桁の国コード

(city)

SDK

コンバージョン時に記録されるユーザーの端末の都市

(device-brand)

SDK

コンバージョン時に記録されるユーザーの端末のメーカー

(carrier)

SDK

端末のサービスプロバイダー(例:"AT&T")

(ip)

SDK

コンバージョン時に記録されるユーザーの端末のIPアドレス

(device-model)

SDK

コンバージョン時に記録されるユーザーの端末のモデル

(language)

SDK

コンバージョン時に記録されるユーザーの端末で使用している言語

(appsflyer-device-id)

SDK

コンバージョン時に記録されるAppsFlyerにおけるユニークID

(sdk-version)

SDK

AppsFlyer SDKのバージョン

(app-version-name)

SDK

アプリのバージョン(開発者によってアプリのコードに設定されている)

(user-agent)

SDK

ユーザーエージェントのフォーマット(例:"Mozilla/5.0 (iPad)")

(vendorId)

SDK

ベンダーID(例:iOSのIDFV)

(os-version)

SDK

OSのバージョン名

(app-name)

SDK

アプリの名前

(match-type)

SDK

アトリビューションメソッド(例:UID(id_matching)、ref (gp_referrer)、fp(fingerprint))

(gp_referrer_click_ts)

SDK

Google Playにアクセスした時刻

(gp_referrer_install_ts)

SDK

Google Playでユーザーがインストールをクリックした時刻


アプリ内イベント用マクロ

次のマクロは、アプリ内イベント(またはS2Sイベント)の発生後に パートナーに送信されるポストバックにのみ使用できます。

マクロ 説明

(event-name)

アプリから発生したイベントの名前

(mapped-iae)

パートナーのプラットフォームで発生したイベントと照合するための名前またはID

(monetary)

イベントの値(USD(米ドル)) 

(orig-monetary)

イベントの値(アプリで設定されている元の通貨)

(currency)

イベントの通貨コード

(timestamp)

アプリ内イベントの発生時刻

(event-value)

拡張されたリッチアプリ内イベントに含まれる値。 JSON形式のポストバックですべてを送信可能。値は (encode) マクロを使用してURLエンコードされます。

 例

イベントポストバックのテンプレート"&event=(event)&json=(encode)"が、次の固有の af_purchaseイベントのポストバックに変換されています。

&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%
22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22
af_content_type%22%3A%22default_type%22%7D%0A

このポストバックを
JSONデコードした値は次のようになります。

{"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

エンコードされる値

ポストバックに、 英数字以外の不規則な文字を使用しなればならない場合があります。ポストバック時にこれらの値を正しく転送するため、AppsFlyerではポストバックの中の英数字以外の値をURLエンコードします。

エンコードされたポストバックをデコードしたり、デコードされたポストバックをエンコードする場合は、Web上のフリーのエンコーディングツール(例はこちら)を使用できます。

ポストバックの例

一般的なインストールポストバックの例

Android iOS
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)

一般的なアプリ内イベントのポストバックの例

Android iOS
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)&
install_time=(install-unix-ts)&event_name=(event-name)&currency=(currency)&
json=(event-value

リッチアプリ内イベントのポストバックの例

イベントパラメータ:

イベント名:af_revenue
イベント収益:120.00
Event Currency: US)
Event Value:{"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

ポストバック:

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&device_ip=
38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&
android_id=9aaeecc4455xxxxx&;install_time=1451923560&event_name=af_purchase&
currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue
%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id
%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A
この記事は役に立ちましたか?
3人中3人がこの記事が役に立ったと言っています