Esta página foi traduzida pela API Cloud Translation.

Integração da DDM para rastreamento de apps de terceiros

O fluxo completo a seguir descreve a configuração do anunciante e a implementação de terceiros necessárias para veicular uma campanha nos produtos de compra do DoubleClick usando uma solução de rastreamento de apps terceirizada.

Para mais informações sobre o Marketing Digital da DoubleClick em geral e uma visão geral dos recursos de atribuição no app, consulte a página de informações gerais sobre o Marketing Digital da DoubleClick.

O anunciante configura um evento de conversão na DDM para representar a instalação ou a conversão (somente no Bid Manager: pixel de conversão; no Campaign Manager: atividade do Floodlight).
O anunciante "vincula" o evento de conversão da DDM na interface de terceiros e fornece variáveis principais que identificam um anunciante e um grupo de atividades de conversão.
- src é o ID do anunciante que é a origem da atividade do Floodlight.
- cat é a string da tag de atividade que os servidores do Floodlight usam para identificar o grupo de atividades a que a atividade pertence.
- type é a string da tag de grupo que identifica o grupo de atividades com que a atividade do Floodlight está associada.
- u1, u2, ... (se disponível) são as chaves-valor das variáveis personalizadas do Floodlight.
O anunciante adiciona variáveis para indicar a coleta de consentimento para conformidade com a DMA.
- O eea é usado para identificar usuários do EEE.
  - eea=0 indica que o usuário não é do EEE.
  - eea=1 indica que o usuário é do EEE.
- ad_user_data é a flag de consentimento para o uso de dados do usuário para fins de publicidade.
  - Só precisa ser definido se eea=1
  - ad_user_data=0 indica que o usuário negou o consentimento para a transmissão de dados no nível do usuário ao Google para fins de publicidade.
  - ad_user_data=1 indica que o usuário deu consentimento para a transmissão de dados no nível do usuário ao Google para fins de publicidade.
- O npa é usado para conteúdo de personalização de anúncios.
  - npa=0 indica que o usuário consente com a personalização.
  - npa=1 indica que o usuário não consentiu com a personalização.
- test_request_reason=dma pode ser usado para testar parâmetros da DMA
  - Valida todos os parâmetros de DMA e retorna avisos.
  - Retorna várias respostas com cliques falsos.
  - Registra as conversões como conversões de teste.
Além disso, o anunciante precisa fornecer aos terceiros o token de autorização específico:

token é uma string alfanumérica específica do anunciante que precisa ser transmitida com cada solicitação do servidor para a DDM.
O anunciante veicula uma campanha publicitária no app com tags de anúncio veiculadas pela DBM em trocas de lances em tempo real ou pela DCM em mídia comprada diretamente.
O usuário final vê e clica nos anúncios, que são registrados pela DDM.
Quando o usuário final instala o app ou conclui um evento de conversão, como "game play", os servidores de terceiros enviam um "ping" para a DDM em todas as atividades do app:

Exemplo de URL para usuários fora do EEE
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
Exemplo de URL para usuário no EEE
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0
```
em que:
- src é o ID do anunciante que é a origem da atividade do Floodlight.
- cat é a string da tag de atividade que os servidores do Floodlight usam para identificar o grupo de atividades a que a atividade pertence.
- type é a string da tag de grupo que identifica o grupo de atividades com que a atividade do Floodlight está associada.
- ord é um número aleatório usado para tornar a tag do Floodlight única.
- u1, u2, ... (se disponível) são as chaves-valor das variáveis do Floodlight personalizadas.
- eea identifica se o usuário está no EEE.
- ad_user_data identifica se o usuário aceita cookies e medição.
- npa identifica se o usuário consente com a personalização.
com parâmetros adicionais enviados por um payload JSON em um HTTP POST:
```
{
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
    "ip": "108.176.57.230",
    "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
    "lmt": 1
  }
}
```
e o token de autorização do anunciante é transmitido no cabeçalho de autorização HTTP:
```
Authorization: Token token="[advertiser authorization token string]"
```
em que:
- app (obrigatório) é o objeto JSON que representa o app em que a atividade de conversão ocorreu. Use app: {} se o app em que a atividade de conversão ocorreu não estiver disponível.
- bundle (se disponível) é o campo do objeto do app que contém um valor de string do nome do pacote da Play Store ou do ID da App Store.
- device é o objeto JSON que representa o dispositivo em que a atividade de conversão ocorreu.
- ua é o campo do objeto do dispositivo que representa a string do user agent do app em que uma atividade foi registrada. Este parâmetro é obrigatório.
- ip (se disponível) é o endereço IPv4 atribuído ao dispositivo. Este parâmetro é obrigatório.
- didmd5 é a string com hash MD5 do IDFA ou do valor do ID de publicidade do Google Play em maiúsculas.
- lmt é um número inteiro com valor 1 se o usuário ativou a opção "Limitar o rastreamento de anúncios" com IDFA ou AdID, ou 0, se não estiver definido.
A DDM vai responder com um JSON informando se o evento de conversão foi atribuído a uma visualização ou clique veiculado pela DCM e, em caso afirmativo, informações adicionais sobre o evento (última visualização ou clique):
- ID do anúncio
- ID do site
- ID da posição
- ID do criativo
- Carimbo de data/hora
Um exemplo de resposta JSON pode ser assim:
```
{
  "attributed": 1,  // Whether the conversion can be attributed to a DCM event.
  "last_impression_ad_id":283641088,
  "last_impression_site_id":1408067,
  "last_impression_placement_id":107616368,
  "last_impression_creative_id":60162352,
  "last_impression_timestamp":1415647607,
  "last_click_ad_id":283641088,
  "last_click_site_id":1408067,
  "last_click_placement_id":107616368,
  "last_click_creative_id":60162352,
  "last_click_timestamp":1415647657,
  "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A",
  "cps": <cps>,
  "ad_events": [
    <ad event objects>
  ],
  "warnings": [<warning strings>],
  "errors": [<error strings>],
}
```
em que:
- attributed é o valor 1 (se a conversão puder ser atribuída a uma impressão ou um clique) ou 0 (se não for atribuível).
- last_impression_ad_id (se attributed = 1) é o ID do anúncio da última impressão.
- last_impression_site_id (se attributed = 1) é o ID do site da última impressão.
- last_impression_placement_id (se attributed = 1) é o ID da posição da última impressão.
- last_impression_creative_id (se attributed = 1) é o ID do criativo da última impressão.
- last_click_ad_id (se attributed = 1 e um clique foi atribuído) é o ID do anúncio do último clique.
- last_click_site_id (se attributed = 1 e um clique foi atribuído) é o ID do site do último clique.
- last_click_placement_id (se attributed = 1 e um clique foi atribuído) é o ID da posição do último clique.
- last_click_creative_id (se attributed = 1 e um clique foi atribuído) é o ID do criativo do último clique.
- last_click_exclid corresponde a um ID de clique exclusivo preenchido usando a macro %eiid!.
A partir da aplicação da DMA em março de 2024, os seguintes campos também vão estar disponíveis:
- cps indica a qual serviço essencial de plataforma o evento pertence.
  - a : anúncios
  - m : Maps
  - p : Play Store
  - s : Pesquisa
  - h : Shopping
  - y : YouTube
- ad_events é uma matriz de objetos ad_event que contém todos os eventos de conversão.
  - O objeto ad_event tem os seguintes campos:
  - product_type é uma string que informa o produto responsável pela conversão. Será DCM ou DBM.
  - interaction_type é o tipo de interação que levou ao evento. impression ou click.
  - conversion_metric é a métrica de conversão usada para atribuição. conversion ou view_through_conversion.
  - timestamp é o carimbo de data/hora UNIX em que o evento de anúncio ocorreu com precisão de microssegundos. Esse valor deve ser usado para atribuição de último clique.
  - campaign_type identifica o tipo de campanha que gerou o evento de anúncio.
  - line_item_id (somente DBM) é o ID do item de linha do DBM que gerou o evento de anúncio.
  - line_item_name (somente DBM) é o nome do item de linha do DBM que gerou o evento de anúncio.
  - placement_id (somente DCM) é o ID da tag de posição do DCM que gerou o evento de anúncio.
  - placement_name (somente DCM) é o nome da tag de posição do DCM que gerou o evento de anúncio.
  - external_customer_id é o identificador do anunciante proprietário da campanha que gerou o evento de anúncio.
    - Se product for o DBM, este campo vai representar o ID do anunciante do DBM.
    - Se product for o DCM, este campo vai representar o ID do anunciante do DCM.
  - creative_id é o ID do bloco de anúncios criativo que gerou o evento de anúncio.
    - Se product for DBM, esse campo vai representar o ID do criativo do DBM.
    - Se product for DCM, este campo representará o ID do criativo do DCM.
  - exchange_id (somente DBM) é o ID da troca que veiculou o anúncio do DBM.
  - insertion_order_id (somente DBM) é o ID do pedido de inserção do DBM.
  - site_id (somente DCM) é o ID do site do DCM para o evento de anúncio.
  - cps indica a qual serviço principal da plataforma o evento de anúncio pertence. Consulte a explicação completa do campo cps na documentação para mais detalhes.
- warnings é uma matriz de avisos produzidos pelo evento de conversão.
- errors é uma matriz de erros produzidos pelo evento de conversão com códigos de erro HTTP, nos seguintes cenários:
  - HTTP 204 se a cota de solicitações tiver sido excedida.
  - HTTP 400 quando a solicitação é considerada inválida, por exemplo, parâmetros obrigatórios ausentes, e o servidor voltou ao rastreamento de pixels.
  - HTTP 401 se o token de autorização for inválido.
  - HTTP 404 para solicitações inválidas.
O anunciante poderá acessar os relatórios de campanha no seu sistema e de conversão no DCM com os mesmos parâmetros.

Outros exemplos de respostas após a entrada em vigor da DMA em março de 2024

Exemplo de uma resposta de acompanhamento de conversões atribuídas em que a conversão é atribuída a interações de anúncios de pesquisa e do YouTube, mas o consentimento de uso cruzado 5(2)(b) + 5(2)(c) é negado entre as CPSs de pesquisa e do YouTube:
```
{
  attributed: 1,
  last_impression_ad_id: 283641088,
  last_impression_site_id: 1408067,
  last_impression_placement_id: 107616368,
  last_impression_creative_id: 60162352,
  last_impression_timestamp: 1415647607,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id: 60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
  cps: "s",
  ad_events: [{
      cps : "s",
      product_type: "DCM",
      interaction_type: "click",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647655.123456,
      site_id: 1408067,
      }, {
      cps : "s",
      product_type:"DCM",
      interaction_type: "impression",
      ad_event_type: "impression",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647607.123456,
      site_id: 1408067
      },{
      cps : "y",
      product_type: "DCM",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616370,
      placement_name: "Placement on Youtube",
      external_customer_id: 7480542,
      creative_id: 6016444,
      timestamp: 14344344.123456,
      site_id: 140806
      },
  ]}
```
Exemplo de uma resposta afirmativa de acompanhamento de conversões para uma campanha do DBM:
```
{
  attributed: 1,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id :60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
  cps: "y",
  ad_events: [{
    product_type: "DBM",
    interaction_type: "click",
    ad_event_type: "click",
    campaign_type: "Display",
    line_item_id: 123456789,
    line_item_name: "TEST LINE ITEM NAME",
    external_customer_id: 2550,
    creative_id: 512333,
    exchange_id: 132,
    insertion_order_id: 523423,
    timestamp: 1432681913.123456
    cps: "y"
  },
  {
    product_type: "DCM",
    interaction_type: "click",
    campaign_type: "Display",
    placement_id: 9342323,
    placement_name: "TEST PLACEMENT NAME",
    external_customer_id: 7480542,
    creative_id: 8234234,
    timestamp: 1432681913.123456,
    cps: "y"
  }
]}
```

Integração da DDM para rastreamento de apps de terceiros Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Integração da DDM para rastreamento de apps de terceiros