Appleのペイロード構造
Appleのペイロード構造を使用すると、SKAdNetworkペイロードからの情報やその他の追加情報をAdjustに送信できます。
Adjustは、AppleのJSON SKAdNetworkペイロード構造をサポートしています。
事前準備
はじめに、以下の設定手順をご覧ください。
要件
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"
}
Appleのペイロード構造を作成する
サポートされているAdjustのキャンペーンパラメーターを、AppleのSKAdNetworkペイロードに追加し、SKAdNetworkインストールポストバックをAdjustに送信する必要があります。
Appleのペイロード構造を作成するには、以下の手順に従ってください。
- AppleのSKAdNetworkペイロードに追加情報を追加します。
パラメーター | 説明 |
---|---|
adjust-tracker | 6〜7文字のAdjustリンクトークン |
adjust-campaign | Adjustキャンペーン名 |
adjust-campaign-id | AdjustキャンペーンのID |
adjust-adgroup | Adjustアドグループ名 |
adjust-adgroup-id | AdjustアドグループのID |
adjust-creative | Adjustクリエイティブ名 |
adjust-creative-id | AdjustクリエイティブのID |
timestamp | Appleから元のポストバックを受け取った時点のUNIXタイムスタンプ(秒数)です。 この値が空の場合、Adjustはお客様からポストバックを受け取った時間を使用します。 |
country | インストール場所を示す2文字の国コード。 この値が空の場合、Adjustはこの値を「ZZ」としてレポートします(集計レポートには「不明」と表示されます)。 |
Content-Type: application/json
を指定してHTTP POSTでAdjustに情報を送信します。
Adjustは以下の情報を受け取ります。
例:
URL:https://app.adjust.com/skadnetwork/<sk_network_token>
Body:
{
"source-app-id" : 123456789,
"app-id" : 987654321,
"attribution-signature" : "xxxxxxxxxxxx",
"campaign-id" : 1,
"transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
"conversion-value" : 1,
"fidelity-type": 1,
"version" : "2.2",
"ad-network-id" : "xxxxxxxxx.skadnetwork",
"redownload" : true,
"coarse-conversion-value": "high"
"postback-sequence-index": 0
"source-identifer": "5239"
"adjust-tracker": "abc123",
"adjust-campaign": "test_campaign_name",
"adjust-campaign-id": "test_campaign_id",
"adjust-adgroup": "test_adgroup_name",
"adjust-adgroup-id": "test_adgroup_id",
"adjust-creative": "test_creative_name",
"adjust-creative-id": "test_creative_id",
"timestamp": 1597151456,
"country": "de",
"ip-address": "10.10.10.10",
"user-agent": "App Store"
}
ここでは、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