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.

para parceiros

API de atribuição posterior

Com a API de atribuição posterior de servidor para servidor, os parceiros de TV podem substituir uma instalação originalmente atribuída como orgânica para um dispositivo. Assim, é possível reivindicar uma instalação até 7 dias depois que ela ocorre.

Antes de começar

Para trabalhar com essa API, você precisa de um token de API da Adjust. Entre em contato com integration@adjust.com para pedir o seu.

Endpoint

https://s2s.adjust.com/delayed_attribution

Método POST

Essa API exige que o método POST sobrescreva a atribuição de instalação orgânica original do dispositivo.

Importante:

Você só poderá enviar à Adjust informações de atribuição para instalações de até sete dias antes. Tente fazer seus callbacks da API frequentemente e o mais cedo possível.

Parâmetros da API

Parâmetros obrigatórios

Parâmetro	Tipo de dados	Descrição	Exemplo
`tracker`	String	Token de link orgânico da Adjust para o aplicativo.	`foobar`
`partner_token`	String	Fornecido pela Adjust e único para cada parceiro de atribuição.	`8wfxq4brf343`
`click_time`	Data	O horário de exibição do anúncio na TV em UTC (formato obrigatório).	`2006-01-02T15:04:05`

Parâmetros do ID do dispositivo

Você precisa incluir ao menos um dos parâmetros a seguir e quantos quiser:

Parâmetro	Tipo de dados	Descrição	Exemplo
`adid`	String	ID do dispositivo da Adjust presente em nossos callbacks.	`e3f5536a141811db40efd6400f1d0a4e`
`idfa`	String	ID do iOS para anunciantes.	`D2CADB5F-410F-4963-AC0C-2A78534BDF1E`
`idfv`	String	ID do iOS para fornecedores.	`EF76726C-D952-451C-8E1A-4E86938BDC20`
`mac`	String	Endereço MAC do dispositivo (sem ":") - Apenas Android	`15118fdce61d`
`mac_md5`	String	MD5 no MAC (maiúscula sem ":") - Apenas Android	`e3f5536a141811db40efd6400f1d0a4e`
`mac_sha1`	String	SHA1 no MAC (maiúscula com ":") - Apenas Android	`c1976429369bfe063ed8b3409db7c7e7d87196d9`
`android_id`	String	ID do Android	`e1cbfb61613b4f50`
`gps_adid`	String	Advertiser ID do Google Play	`660e1d86-6796-463a-be86-897993136018`

Parâmetros opcionais

Parâmetro	Tipo de dados	Descrição	Exemplo
`campanha`	String	Instrumento básico da campanha; por exemplo, um canal de TV.	`ProSieben`
`grupo de anúncios`	String	Segundo nível da estrutura da campanha, por exemplo, um programa televisivo.	`Notícias`
`criativo`	String	Terceiro nível da estrutura da campanha, por exemplo, o formato do anúncio.	`Funny Spot 1`

Exemplo

curl  -d adid=e3f5536a141811db40efd6400f1d0a4e  \
      -d tracker=foobar                         \
      -d partner_token=asd123asd123             \
      -d campaign=test123                       \
      -d adgroup=test123                        \
      -d creative=test123                       \

      https://s2s.adjust.com/delayed_attribution

Exemplo de resposta

HTTP Status 2XX

Se a interface retornar um erro, isso acontece geralmente porque o dispositivo é desconhecido ou porque o adid postado não pode ser encontrado.