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.

Reative/desative o compartilhamento com terceiros via S2S

Com a Adjust, você pode gerenciar como os dados são compartilhados com terceiros para fins estatísticos. Isso dá mais opções aos seus usuários sobre como os dados deles serão tratados. Aqui você encontra instruções sobre como reativar ou desativar o compartilhamento com terceiros de servidor para servidor (S2S).

Observação:
Qualquer usuário que optar por não compartilhar dados de usuário não será redirecionado, mesmo que opte por fazer o compartilhamento depois. Isso significa que ele não será incluído na lista do Audiências .
Versão mínima do SDKDocumentação do desenvolvedor
Android SDK 4.26.0+Android - reativar o compartilhamento
iOS SDK 4.25.0+iOS - reativar o compartilhamento

Endpoint

O endereço da requisição do endpoint da API é:

https://s2s.adjust.com/third_party_sharing

Use uma requisição POST para interagir com a API. Você também enviar parâmetros de endpoint na URL ou como dados de formulário.

Parâmetros obrigatórios

Nome do parâmetroValor
gps_adid, idfaString dos IDs do dispositivo. É necessário, pelo menos, um ID do dispositivo. A API suporta os mesmos IDs do dispositivo suportados por outras APIs S2S da Adjust.
s2sSempre 1
app_tokenO token do app.
sharing enable ou disable para permitir ou prevenir compartilhamento de dados de terceiros, respectivamente.

Respostas

Resposta de êxito

Você vai receber o seguinte para uma resposta com êxito:

{
   “status”: "OK"
}

Resposta de erro

Caso ocorra um erro, você receberá uma resposta 400 Bad Request junto com uma mensagem descrevendo o erro.

Exemplo:

{
   "error": "Third party sharing failed (App not found)”
} ou erro: houve uma falha no compartilhamento de dados de terceiros (aplicativo não encontrado)

Exemplos de URLs

Insira o parâmetro ativar para permitir o compartilhamento com terceiros, por exemplo:

https://s2s.adjust.com/third_party_sharing?s2s=1&sharing=enable&app_token=abc123abc123&gps_adid=10820328-872d-43a2-9786-0ccc748335d9

Insira o parâmetro desativar para impedir o compartilhamento com terceiros, por exemplo:

https://s2s.adjust.com/third_party_sharing?s2s=1&sharing=disable&app_token=abc123abc123&gps_adid=10820328-872d-43a2-9786-0ccc748335d9

Enviar dados de consentimento para o Google (Regulamento Mercados Digitais)

Para estar em conformidade com o Regulamento Mercados Digitais (DMA, na sigla em inglês), o Google Ads e o Google Marketing Platform exigem um consentimento explícito do usuário para poderem receber requisições de atribuição da Adjust em suas APIs.

Caso um usuário mude sua resposta, é possível usar a API de reativar/desativar o compartilhamento com terceiros da Adjust para compartilhar isso conosco. Passe os seguintes parâmetros na sua requisição:

KeyValueDescription
eea1 = users are in the EEA and the DMA applies

0 = users are not in the EEA and the DMA does not apply
The eea parameter informs Google whether users are located in the EEA and thus whether the European regulations, including the DMA, apply to this user and conversion. The parameter type is boolean.
ad_personalization1 = user consented

0 = user did not consent
  • For Google Ads

The ad_personalization parameter informs whether users consented to being served personalized ads via Google Ads after installing the app, i.e. whether Google can retarget the users.
ad_user_data1 = user consented

0 = user did not consent
The ad_user_data parameter informs Google whether users granted consent to personal data being shared for measurement purposes or not. The consent applies to all the Core Platform Services (CPS) advertisers have specified in their Google Ads and Google Marketing Platform UI.
npa1 = user did not consent

0 = user consented
  • For Google Marketing Platform

The npa parameter informs whether users consented to being served personalized ads via Google Marketing Platform after installing the app, i.e. whether Google can retarget the users.

Observe que é necessário enviar o parâmetro ad_personalization se estiver trabalhando com o Google Ads e o parâmetro npa se estiver trabalhando com o Google Marketing Platform.