Diese Seite wurde von der Cloud Translation API übersetzt.

DDM-Integration für App-Tracking durch Drittanbieter

Im folgenden Ablauf werden sowohl die Einrichtung von Werbetreibenden als auch die Implementierung von Drittanbietern beschrieben, die zum Ausführen einer Kampagne auf DoubleClick-Produkten für Käufer mit einer App-Tracking-Lösung eines Drittanbieters erforderlich sind. Weitere Informationen zu DoubleClick Digital Marketing im Allgemeinen und eine Übersicht über die In-App-Attributionsfunktionen finden Sie auf der Hintergrundseite von DoubleClick Digital Marketing.

Der Werbetreibende richtet das Conversion-Ereignis in DDM für die Installation/Conversion ein (nur Bid Manager – Conversion-Pixel) (Campaign Manager – Floodlight-Aktivität).
Werbetreibenden-Conversion-Ereignis „links“ auf der Drittanbieter-Benutzeroberfläche und stellt wichtige Variablen bereit, die einen Werbetreibenden und eine Conversion-Aktivitätsgruppe identifizieren.
- src ist die Werbetreibenden-ID, die Ausgangspunkt der Floodlight-Aktivität ist.
- cat ist der Aktivitäts-Tag-String, mit dem die Floodlight-Server die Aktivitätsgruppe identifizieren, zu der die Aktivität gehört.
- type ist der Gruppen-Tag-String, über den die Aktivitätsgruppe gekennzeichnet wird, mit der die Floodlight-Aktivität verknüpft ist.
- u1, u2, ... (wenn vorhanden) sind die benutzerdefinierten Schlüssel/Wert-Paare der Floodlight-Variablen.
Außerdem muss der Werbetreibende das spezifische Autorisierungstoken an Dritte weitergeben: token ist ein werbetreibenderspezifischer alphanumerischer String, der zusammen mit jeder Serveranfrage an DDM weitergegeben werden muss.
Der Werbetreibende führt eine In-App-Anzeigenkampagne mit Anzeigen-Tags aus, die über DBM auf Anzeigenplattform für Echtzeitgebote oder über DCM auf direkt gekauften Medien ausgeliefert werden.
Der Endnutzer sieht Anzeigen bzw. Klicks auf Anzeigen, die von DDM protokolliert werden.
Wenn der Endnutzer die App installiert und/oder ein Conversion-Ereignis (z. B. Spiel) beendet, werden die Drittanbieterserver bei jeder App-Aktivität zu
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
```
Dabei gilt:
- src ist die Werbetreibenden-ID, die Ausgangspunkt der Floodlight-Aktivität ist.
- cat ist der Aktivitäts-Tag-String, mit dem die Floodlight-Server die Aktivitätsgruppe identifizieren, zu der die Aktivität gehört.
- type ist der Gruppen-Tag-String, über den die Aktivitätsgruppe gekennzeichnet wird, mit der die Floodlight-Aktivität verknüpft ist.
- ord ist eine Zufallszahl, durch die das Floodlight-Tag eindeutig wird.
- u1, u2, ... (falls verfügbar) sind die benutzerdefinierten Schlüssel/Wert-Paare der Floodlight-Variablen.
mit zusätzlichen Parametern, die über die JSON-Nutzlast in einem HTTP-POST gesendet werden:
```
{
  "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
  }
}
```
und das Autorisierungstoken für Werbetreibende im HTTP-Autorisierungsheader übergeben wird:
```
Authorization: Token token="[advertiser authorization token string]"
```
Dabei gilt:
- app (erforderlich) ist das JSON-Objekt, das die App darstellt, in der die Conversion-Aktivität stattgefunden hat. Verwende app: {}, wenn die App, in der die Conversion-Aktivität stattgefunden hat, nicht verfügbar ist.
- bundle (sofern verfügbar) ist das Feld für das App-Objekt, das einen Stringwert des Play Store-Paketnamens oder der App Store-ID enthält.
- device ist das JSON-Objekt, das das Gerät darstellt, auf dem die Conversion-Aktivität stattgefunden hat.
- ua ist das Feld für das Geräteobjekt, das den User-Agent-String der App darstellt, in der eine Aktivität aufgezeichnet wurde. Das ist ein erforderlicher Parameter.
- ip (falls verfügbar) ist die IPv4-Adresse des Geräts, die dem Gerät zugewiesen wurde. Das ist ein erforderlicher Parameter.
- didmd5 ist der MD5-Hash-String des Werts in IDFA oder Google Play mit Großbuchstaben.
- lmt ist eine Ganzzahl mit dem Wert „1“, wenn der Nutzer die Option „Anzeigen-Tracking einschränken“ mit IDFA/AdID aktiviert hat. Ist die Option nicht festgelegt, wird „0“ verwendet.
In DDM wird mit einer JSON-Antwort geantwortet, ob das Conversion-Ereignis einer Ansicht oder einem Klick zugeordnet ist, der von DCM ausgeliefert wurde, und, wenn (JA) zusätzliche Informationen zum Ereignis (letzter Aufruf oder Klick) erfolgen:
```
- Ad ID
- Site ID
- Placement ID
- Creative ID
- Timestamp
```
Hier ein Beispiel für eine JSON-Antwort:
```
{"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"}
```
Dabei gilt:
- attributed ist der Wert „1“, wenn die Conversion einer Impression oder einem Klick zugeordnet werden kann, oder „0“ (wenn nicht zuordenbar).
- last_impression_ad_id (wenn zugeordnete = 1) ist die Anzeigen-ID für die letzte Impression.
- last_impression_site_id (wenn zugeordnete 1) ist die Website-ID für die letzte Impression.
- last_impression_placement_id (wenn zugeordnete 1) ist die Placement-ID für die letzte Impression.
- last_impression_creative_id (wenn zugeordnete 1) ist die Creative-ID für die letzte Impression.
- last_click_ad_id (wenn „1“ zugeordnet und ein Klick zugeordnet war) ist die Anzeigen-ID für den letzten Klick.
- last_click_site_id (wenn „1“ zugeordnet und ein Klick zugeordnet war) ist die Website-ID für den letzten Klick.
- last_click_placement_id (wenn „1“ zugeordnet und ein Klick zugeordnet war) ist die Placement-ID des letzten Klicks.
- last_click_creative_id (wenn „1“ zugeordnet und ein Klick zugeordnet war) ist die Creative-ID für den letzten Klick.
- last_click_exclid entspricht einer eindeutigen Klick-ID, die über das Makro %eiid! eingefügt wird
mit HTTP-Fehlercodes verwendet, wenn
- HTTP 204, wenn das Anfragekontingent überschritten wurde.
- HTTP 400, wenn die Anfrage als ungültig eingestuft wird, z.B. wenn erforderliche Parameter fehlen, und der Server auf das Pixel-Tracking zurückgesetzt wurde.
- HTTP 401, wenn das Autorisierungstoken ungültig ist.
- HTTP 404 für alle ungültigen Anfragen.
Der Werbetreibende kann Kampagnenberichte in Ihrem System sehen. Der Werbetreibende kann außerdem Conversion-Berichte in DCM sehen, die dieselben Parameter wie oben haben.