Esta página foi traduzida pela API Cloud Translation.

Integração do DDM para o 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 exibir uma campanha em produtos de compra da DoubleClick usando uma solução de rastreamento de aplicativos de terceiros. Para mais informações sobre o Marketing Digital da DoubleClick em geral, bem como uma visão geral da funcionalidade de atribuição no aplicativo, consulte a página de plano de fundo do Marketing Digital da DoubleClick.

O anunciante configura o evento de conversão no DDM para representar a instalação/conversão (somente Bid Manager - Pixel de conversão) (atividade do Campaign Manager - Floodlight).
O anunciante promove o evento de conversão do DDM na interface de terceiros e fornece variáveis importantes que identificam um anunciante e um grupo de atividades de conversão.
- src é o código 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 ao qual a atividade pertence.
- type é a string da tag de grupo que identifica o grupo de atividades associado à atividade do Floodlight.
- u1, u2, ... (se disponíveis) são as chaves-valor das variáveis do Floodlight personalizadas.
Além disso, o anunciante precisa fornecer o token de autorização específico a terceiros: token é uma string alfanumérica específica do anunciante que precisa ser transmitida a cada solicitação do servidor para o DDM.
O anunciante veicula uma campanha de anúncios no app com tags de anúncio veiculadas pelo DBM em trocas de lances em tempo real ou veiculadas pelo DCM em mídia de compra direta.
O usuário final vê e/ou clica em anúncios, que são registrados pelo DDM.
Quando o usuário final instala o app e/ou conclui um evento de conversão (jogos de jogo etc.), os servidores de terceiros dão um ping em cada atividade do app
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
```
em que:
- src é o código 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 ao qual a atividade pertence.
- type é a string da tag de grupo que identifica o grupo de atividades associado à atividade do Floodlight.
- ord é um número aleatório usado para tornar a tag do Floodlight única.
- u1, u2, ... (se disponíveis) são as chaves-valor das variáveis personalizadas do Floodlight.
com parâmetros adicionais enviados por meio do payload JSON em um HTTP POST:
```
{
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (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 aplicativo 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 de 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 de 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 do dispositivo atribuído ao dispositivo. Este parâmetro é obrigatório.
- didmd5 é a string de hash MD5 do IDFA em letras maiúsculas ou do valor do ID de publicidade do Google Play.
- lmt é um número inteiro, com valor 1 se o usuário tiver ativado a opção "Limite de rastreamento de anúncios" com IDFA/AdID, ou 0, se não estiver definido.
O DDM responderá com um JSON se o evento de conversão foi atribuído a uma visualização ou um clique veiculado pelo DCM e, em caso positivo, informações adicionais sobre o evento (última visualização ou clique):
```
- Ad ID
- Site ID
- Placement ID
- Creative ID
- Timestamp
```
Um exemplo de resposta JSON pode ter a seguinte aparência:
```
{"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"}
```
em que:
- attributed é o valor 1 (se a conversão puder ser atribuída a uma impressão ou clique) ou 0 (se não for atribuível).
- last_impression_ad_id (se atribuído = 1) é o ID do anúncio da última impressão.
- last_impression_site_id (se atribuído = 1) é o ID do site da última impressão.
- last_impression_placement_id (se atribuído = 1) é o ID da posição da última impressão.
- last_impression_creative_id (se atribuído = 1) é o ID do criativo para a última impressão.
- last_click_ad_id (se atribuído = 1 e um clique foi atribuído) é o ID do anúncio para o último clique.
- last_click_site_id (se atribuído = 1 e um clique foi atribuído) é o ID do site do último clique.
- last_click_placement_id (se atribuído = 1 e um clique foi atribuído) é o ID da posição do último clique.
- last_click_creative_id (se atribuído = 1 e um clique foi atribuído) é o ID do criativo do último clique.
- last_click_exclid corresponde a um ID de clique único preenchido pela macro %eiid!.
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, falta de parâmetros obrigatórios) e o servidor usa o acompanhamento de pixels.
- HTTP 401 se o token de autorização for inválido.
- HTTP 404 em caso de solicitações incorretas.
O anunciante verá relatórios de campanha no seu sistema. Ele também poderá ver relatórios de conversão no DCM com os mesmos parâmetros acima.