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).
Versão mínima do SDK | Documentaçã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âmetro | Valor |
---|---|
gps_adid , idfa | String 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. |
s2s | Sempre 1 |
app_token | O 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:
Key | Value | Description |
---|---|---|
eea | 1 = 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_personalization | 1 = user consented 0 = user did not consent |
|
ad_user_data | 1 = 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. |
npa | 1 = user did not consent 0 = user consented |
|
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.