Adjustのペイロード構造

Adjustのペイロード構造を使用すると、SKAdNetworkペイロードからの情報やその他の追加情報をAdjustに送信できます。

事前準備

はじめに、以下の設定手順をご覧ください。

要件

Appleから以下のパラメーターを含むSKAdNetworkペイロードを受け取ってください。

  • version
  • ad-network-id
  • campaign-id
  • transaction-id
  • app-id
  • attribution-signature
  • redownload
  • source-app-id
  • conversion-value
  • fidelity-type (SKAdNetwork バージョン2.2以降)
  • did-win (iOS 14.6以降、SKAdNetwork バージョン3.0)
  • coarse-conversion-value (iOS 16.1以降、SKAdNetwork バージョン4.0)
  • source-identifier (iOS 16.1以降、SKAdNetwork バージョン4.0)
  • postback-sequence-index (iOS 16.1以降、SKAdNetwork バージョン4.0)

例:

{
  "version" : "2.2",
"ad-network-id" : "com.example",
"campaign-id" : 42,
  "transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
  "app-id" : 525463029,
  "attribution-signature" : "MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY/AOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9/sY",
  "redownload": true,
  "source-app-id": 1234567891,
  "fidelity-type": 1,
  "conversion-value": 20,
  "did-win": true
  "coarse-conversion-value": "high" 
  "postback-sequence-index": 0
  "source-identifer": "5239"
}

Adjustのペイロード構造を作成する

お客様とAdjustの間のデータマッピングを簡素化するためには、サポートされているAdjustのキャンペーンパラメーターをSKAdNetworkのエンドポイントに追加し、SKAdNetworkインストールポストバックをAdjustに送信する必要があります。

Appleのペイロード構造を作成するには、以下の手順に従ってください。

  1. sk_network_tokenの値をエンドポイントに追加し、それからサポートされているAdjustキャンペーンのパラメーターを追加してください。SKAdnetworkインストールのポストバックリクエストに全てのパラメーターが入力されていることを確認してください。

  2. HTTP GETメソッドを使用して、Adjustに情報を送信します。

Adjustは以下の情報を受け取ります。

例:

https://app.adjust.com/skadnetwork/<sk_network_token>?tracker=abc123&campaign={your_campaign_name}&campaign_id={your_campaign_id}&adgroup={your_adgroup_name}&adgroup_id={your_adgroup_id}&creative={your_creative_name}&creative_id={your_creative_id}&sk_ts=1597151456&ip_address=10.10.10.10&user_agent=App+Store&sk_payload=%7B%0A%20%20%22version%22%20%3A%20%222.2%22%2C%0A%20%20%22ad-network-id%22%20%3A%20%22com.example%22%2C%0A%20%20%22campaign-id%22%20%3A%2042%2C%0A%20%20%22transaction-id%22%20%3A%20%226aafb7a5-0170-41b5-bbe4-fe71dedf1e28%22%2C%0A%20%20%22app-id%22%20%3A%20525463029%2C%0A%20%20%22attribution-signature%22%20%3A%20%22MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY%2FAOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9%2FsY%22%2C%0A%20%20%22redownload%22%3A%20true%2C%0A%20%20%22source-app-id%22%3A%201234567891%2C%0A%20%20%22fidelity-type%22%3A%201%0A%20%20%22conversion-value%22%3A%2020%0A%20%20%22coarse-conversion-value%22%3A%20%22high%22%20%0A%20%20%22postback-sequence-index%22%3A%200%0A%20%20%22source-identifer%22%3A%20%225239%22%0A%7D

ここでは、sk_payloadはAppleから受信する完全でエンコードされたSKAdNetworkペイロードです。

sk_tsは、Appleから元のポストバックを受け取った時点のUNIXタイムスタンプ(秒数)です。 sk_tsの値が空の場合、Adjustはお客様からポストバックを受け取った時間を使用します。

user_agentはSKAdNetworkペイロードからのユーザーエージェントです。 Adjustでは、実際にお使いのブラウザのユーザーエージェントを送信することを推奨しています。 例:Mozilla/5.0 (iPod; U; CPU iPhone OS 4_3_3 like Mac OS X; ja-jp) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8J2 Safari/6533.18.5