Estamos sempre publicando atualizações em nossa documentação, mas pode ser que elas ainda não estejam disponíveis em seu idioma. Para ter acesso às informações mais atualizadas, use a ​​versão em inglês.

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:

  1. Anexe informações adicionais ao payload do SKAdNetwork da Apple.
ParâmetroDescrição
adjust-trackerToken do link da Adjust de 6 ou 7 caracteres
adjust-campaignNome da campanha na Adjust
adjust-campaign-idID de campanha na Adjust
adjust-adgroupNome do adgroup na Adjust
adjust-adgroup-idID do adgroup na Adjust
adjust-creativeNome do criativo na Adjust
adjust-creative-idID do criativo na Adjust
timestampA 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ísO 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).
  1. 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