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のペイロード構造を作成するには、以下の手順に従ってください。

  1. AppleのSKAdNetworkペイロードに追加情報を追加します。
パラメーター説明
adjust-tracker6〜7文字のAdjustリンクトークン
adjust-campaignAdjustキャンペーン名
adjust-campaign-idAdjustキャンペーンのID
adjust-adgroupAdjustアドグループ名
adjust-adgroup-idAdjustアドグループのID
adjust-creativeAdjustクリエイティブ名
adjust-creative-idAdjustクリエイティブのID
timestampAppleから元のポストバックを受け取った時点のUNIXタイムスタンプ(秒数)です。 この値が空の場合、Adjustはお客様からポストバックを受け取った時間を使用します。
countryインストール場所を示す2文字の国コード。
この値が空の場合、Adjustはこの値を「ZZ」としてレポートします(集計レポートには「不明」と表示されます)。
  1. 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