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 Adjust

Use a estrutura de payload da Adjust para enviar informações do payload do SKAdNetwork e informações adicionais para a Adjust.

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 Adjust

Para simplificar o mapeamento de dados entre você e a Adjust, você precisa anexar parâmetros de campanha suportados da Adjust ao endpoint do SKAdNetwork e enviar postbacks de instalação do SKAdNetwork para a Adjust.

Siga estes passos para criar a estrutura de payload da Adjust

  1. Anexe o valor sk_network_token ao endpoint e depois anexe os parâmetros de campanha compatíveis da Adjust. Todos os parâmetros devem ser preenchidos no pedido de postback de instalação do SKAdNetwork.

  2. Use o método HTTP GET para enviar informações para a Adjust.

A Adjust recebe as seguintes informações:

Exemplo:

https://app.adjust.com/skadnetwork/?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

Aqui, o sk_payload é o completo, o payload codificado do SKAdNetwork conforme recebido da Apple.

sk_ts é a marca temporal UNIX (em segundos) em que você recebeu o postback original da Apple. Se o valor sk_ts estiver vazio, então a Adjust usa o horário no qual nós recebemos o postback de você.

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