Questa pagina è stata tradotta dall'API Cloud Translation.

Integrazione di DDM per il monitoraggio delle app di terze parti

Il seguente flusso end-to-end descrive sia la configurazione dell'inserzionista sia l'implementazione di terze parti obbligatoria per pubblicare una campagna su prodotti lato acquirente DoubleClick utilizzando una soluzione di monitoraggio di app di terze parti. Per ulteriori informazioni su DoubleClick Digital Marketing in generale e per una panoramica della funzionalità di attribuzione in-app, consulta la pagina di sfondo di DoubleClick Digital Marketing.

L'inserzionista imposta l'evento di conversione in DDM per rappresentare l'installazione/conversione (solo Bid Manager - pixel di conversione) (Campaign Manager - attività Floodlight).
Evento di conversione DDM per i link nell'interfaccia di terze parti e fornisce variabili chiave che identificano un inserzionista e un gruppo attività di conversione.
- src è l'ID inserzionista che ha dato inizio all'attività Floodlight.
- cat è la stringa tag dell'attività, che i server Floodlight utilizzano per identificare il gruppo attività a cui appartiene l'attività.
- type è la stringa tag gruppo, che identifica il gruppo attività a cui l'attività Floodlight è associata.
- u1, u2, ... (se disponibili) sono le coppie chiave-valore delle variabili personalizzate Floodlight.
Inoltre, l'inserzionista deve fornire alle terze parti il suo token di autorizzazione specifico: token è una stringa alfanumerica specifica dell'inserzionista che deve essere trasmessa insieme a ciascuna richiesta del server a DDM.
L'inserzionista pubblica una campagna pubblicitaria in-app con tag annuncio pubblicati da DBM su piattaforme di scambio delle offerte in tempo reale o pubblicati da DCM su media acquistati direttamente.
L'utente finale visualizza e/o fa clic sugli annunci, che vengono registrati da DDM.
Quando l'utente finale installa l'app e/o completa un evento di conversione ("game play" e così via), server di terze parti "ping" DDM su ogni attività in app
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
```
dove:
- src è l'ID inserzionista che ha dato inizio all'attività Floodlight.
- cat è la stringa tag dell'attività, che i server Floodlight utilizzano per identificare il gruppo attività a cui appartiene l'attività.
- type è la stringa tag gruppo, che identifica il gruppo attività a cui l'attività Floodlight è associata.
- ord è un numero casuale utilizzato per rendere univoco il tag Floodlight.
- u1, u2, ... (se disponibili) sono le coppie chiave-valore delle variabili Floodlight personalizzate.
con parametri aggiuntivi inviati tramite payload JSON in un POST HTTP:
```
{
  "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 il token di autorizzazione dell'inserzionista viene trasmesso nell'intestazione dell'autorizzazione HTTP:
```
Authorization: Token token="[advertiser authorization token string]"
```
dove:
- (Obbligatorio) app è l'oggetto JSON che rappresenta l'app in cui si è verificata l'attività di conversione. Utilizza app: {} se l'app in cui si è svolta l'attività di conversione non è disponibile.
- bundle (se disponibile) è il campo dell'oggetto app contenente un valore stringa del nome del bundle o dell'ID App Store del Play Store.
- device è l'oggetto JSON che rappresenta il dispositivo su cui si è verificata l'attività di conversione.
- ua è il campo dell'oggetto dispositivo che rappresenta la stringa user agent dell'app in cui è stata registrata un'attività. Questo parametro è obbligatorio.
- ip (se disponibile) è l'indirizzo IPv4 del dispositivo assegnato al dispositivo. Questo parametro è obbligatorio.
- didmd5 è la stringa di hash MD5 del valore IDFA con lettere maiuscole o ID pubblicità di Google Play.
- lmt è un numero intero con valore 1 se l'utente ha attivato l'opzione"Limita il monitoraggio degli annunci"con IDFA/AdID o 0, se non è impostata.
DDM risponde con una risposta JSON che indica se l'evento di conversione è attribuito a una visualizzazione o a un clic pubblicato da DCM e, se &SÌ, "ulteriori informazioni sull'evento (ultima visualizzazione o clic):
```
- Ad ID
- Site ID
- Placement ID
- Creative ID
- Timestamp
```
Un esempio di risposta JSON potrebbe avere il seguente aspetto:
```
{"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"}
```
dove:
- attributed è il valore 1 (se la conversione può essere attribuita a un'impressione o un clic) o 0 (se non attribuibile).
- last_impression_ad_id (se attribuito = 1) è l'ID annuncio dell'ultima impressione.
- last_impression_site_id (se attribuito = 1) è l'ID sito dell'ultima impressione.
- last_impression_placement_id (se attribuito = 1) è l'ID posizionamento dell'ultima impressione.
- last_impression_creative_id (se attribuito = 1) è l'ID creatività dell'ultima impressione.
- last_click_ad_id (se attribuito è = 1 e un clic è stato attribuito) è l'ID annuncio dell'ultimo clic.
- last_click_site_id (se attribuito è 1 e un clic è stato attribuito) è l'ID sito dell'ultimo clic.
- last_click_placement_id (se attribuito = 1 e un clic è stato attribuito) è l'ID posizionamento dell'ultimo clic.
- last_click_creative_id (se attribuito è 1 e un clic è stato attribuito) è l'ID creatività dell'ultimo clic.
- last_click_exclid corrisponde a un ID clic univoco completato tramite la macro %eiid!
con codici di errore HTTP, per i seguenti scenari:
- HTTP 204 se è stata superata la quota di richiesta.
- HTTP 400 quando la richiesta è considerata non valida (ad es. parametri obbligatori mancanti) e il server utilizza il monitoraggio dei pixel.
- HTTP 401 se il token di autorizzazione non è valido.
- HTTP 404 per tutte le richieste errate.
L'inserzionista potrà visualizzare i rapporti sulle campagne nel sistema; l'inserzionista potrà anche visualizzare i rapporti sulle conversioni in DCM con gli stessi parametri descritti in precedenza.