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のペイロード構造を作成するには、以下の手順に従ってください。
sk_network_token
の値をエンドポイントに追加し、それからサポートされているAdjustキャンペーンのパラメーターを追加してください。SKAdnetworkインストールのポストバックリクエストに全てのパラメーターが入力されていることを確認してください。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