Estrutura de payload da Apple
Use a estrutura de payload da Adjust para enviar informações do payload do SKAdNetwork e demais informações adicionais de campanha para a Adjust.
A Adjust suporta a estrutura de payload JSON do SkadNetwork da Apple.
Antes de começar
O que você precisa saber antes de começar.
Requisito
Assegure-se que você está recebendo o payload do SKAdNetwork da Apple com os seguintes parâmetros:
versão
ad-network-id
campaign-id
transaction-id
app-id
attribution-signature
redownload
source-app-id
conversion-value
fidelity-type
(versão 2.2 do SKAdNetwork e posterior)did-win
(versão 14.6 do iOS e posterior, versão 3.0 do SKAdNetwork)coarse-conversion-value
(versão 16.1 do iOS e posterior, versão 4.0 do SKAdNetwork)source-identifier
(versão 16.1 do iOS e posterior, versão 4.0 do SKAdNetwork)postback-sequence-index
(versão 16.1 do iOS e posterior, versão 4.0 do SKAdNetwork)
Exemplo:
{
"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"
}
Crie a estrutura de payload da Apple
Você precisa anexar os parâmetros suportados da campanha da Adjust ao payload do SKAdNetwork da Apple e enviar o postback de instalação do SKAdNetwork para a Adjust.
Siga estes passos para criar a estrutura de payload da Apple:
- Anexe informações adicionais ao payload do SKAdNetwork da Apple.
Parâmetro | Descrição |
---|---|
adjust-tracker | Token do link da Adjust de 6 ou 7 caracteres |
adjust-campaign | Nome da campanha na Adjust |
adjust-campaign-id | ID de campanha na Adjust |
adjust-adgroup | Nome do adgroup na Adjust |
adjust-adgroup-id | ID do adgroup na Adjust |
adjust-creative | Nome do criativo na Adjust |
adjust-creative-id | ID do criativo na Adjust |
timestamp | A marca temporal UNIX (em segundos) em que você recebeu o postback original da Apple. Se esse valor estiver vazio, então a Adjust usa o horário no qual recebemos o postback vindo da sua parte. |
país | O código de país de dois caracteres com a localização da instalação. Se esse valor está vazio, a Adjust vai reportá-lo como "ZZ" (ou "desconhecido" no relatório agregado). |
- Use o método HTTP POST com
Content-Type: application/json
para enviar informações à Adjust.
A Adjust recebe as seguintes informações:
Exemplo:
URL: https://app.adjust.com/skadnetwork/<sk_network_token>
Corpo:
{
"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"
}
Aqui, o user_agent
é o agente de usuário do payload do SKAdNetwork. Contudo, recomendamos que envie o agente de usuário do navegador atual. Por exemplo: 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