Diese Seite wurde von der Cloud Translation API übersetzt.

DDM-Integration für das Tracking von Drittanbieter-Apps

Im folgenden End-to-End-Ablauf werden sowohl die Einrichtung durch den Werbetreibenden als auch die Implementierung durch den Drittanbieter beschrieben, die erforderlich sind, um eine Kampagne in DoubleClick-Buy-Side-Produkten mit einer App-Tracking-Lösung eines Drittanbieters auszuführen.

Weitere Informationen zu DoubleClick Digital Marketing im Allgemeinen sowie eine Übersicht über die Funktionen zur In-App-Attribution finden Sie auf der Hintergrundseite zu DoubleClick Digital Marketing.

Der Werbetreibende richtet in DDM ein Conversion-Ereignis ein, das die Installation oder Conversion darstellt (nur Bid Manager – Conversion-Pixel) (Campaign Manager – Floodlight-Aktivität).
Der Werbetreibende „verknüpft“ das DDM-Conversion-Ereignis in der Drittanbieterschnittstelle und stellt wichtige Variablen bereit, die einen Werbetreibenden und eine Gruppe von Conversion-Aktivitäten 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, ... (falls verfügbar) sind die benutzerdefinierten Schlüssel/Wert-Paare der Floodlight-Variablen.
Der Werbetreibende fügt Variablen hinzu, um die Einwilligung gemäß DMA zu erfassen.
- eea wird verwendet, um Nutzer im EWR zu identifizieren.
  - eea=0 gibt an, dass der Nutzer nicht aus dem EWR stammt.
  - eea=1 gibt an, dass der Nutzer aus dem EWR stammt.
- ad_user_data ist das Einwilligungsflag für die Verwendung von Nutzerdaten zu Werbezwecken.
  - Muss nur festgelegt werden, wenn eea=1
  - ad_user_data=0 gibt an, dass der Nutzer die Einwilligung für die Übermittlung von Daten auf Nutzerebene an Google zu Werbezwecken verweigert hat.
  - ad_user_data=1 gibt an, dass der Nutzer die Einwilligung zur Übermittlung von Daten auf Nutzerebene an Google zu Werbezwecken erteilt hat.
- npa wird für personalisierte Werbeinhalte verwendet.
  - npa=0 gibt an, dass der Nutzer der Personalisierung zustimmt.
  - npa=1 gibt an, dass der Nutzer nicht in die Personalisierung eingewilligt hat.
- test_request_reason=dma kann zum Testen von DMA-Parametern verwendet werden.
  - Prüft alle DMA-Parameter und gibt Warnungen zurück.
  - Gibt eine Mehrfachantwort mit gefälschten Klicks zurück.
  - Die Conversions werden als Test-Conversions protokolliert.
Außerdem muss der Werbetreibende Dritten sein spezifisches Autorisierungstoken zur Verfügung stellen:

token ist ein werbetreibendenspezifischer alphanumerischer String, der bei jeder Serveranfrage an DDM übergeben werden muss.
Der Werbetreibende führt eine In-App-Anzeigenkampagne mit Anzeigen-Tags aus, die von DBM auf Echtzeitgebotsplattformen oder von DCM auf direkt gekauften Media ausgeliefert werden.
Der Endnutzer sieht Anzeigen und klickt darauf. Diese werden von DDM protokolliert.
Wenn ein Endnutzer die App installiert oder ein Conversion-Ereignis wie „gameplay“ ausführt, senden Drittanbieter-Server bei jeder App-Aktivität einen „Ping“ an DDM:

Beispiel-URL für Nutzer außerhalb des EWR
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
Beispiel-URL für Nutzer im EWR
```
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
```
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.
- eea gibt an, ob sich der Nutzer im EWR befindet.
- ad_user_data gibt an, ob der Nutzer in die Verwendung von Cookies und die Analyse einwilligt.
- npa gibt an, ob der Nutzer der Personalisierung zustimmt.
mit zusätzlichen Parametern, die über eine JSON-Nutzlast in einem HTTP-POST gesendet werden:
```
{
  "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
  }
}
```
und das Autorisierungstoken des Werbetreibenden wird im HTTP-Autorisierungsheader übergeben:
```
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. Verwenden Sie app: {}, wenn die App, in der die Conversion-Aktivität stattgefunden hat, nicht verfügbar ist.
- bundle (falls verfügbar) ist das App-Objektfeld, das einen Stringwert mit dem Play Store-Paketnamen 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 Geräteobjektfeld, 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 dem Gerät zugewiesene IPv4-Adresse. Das ist ein erforderlicher Parameter.
- didmd5 ist der MD5-Hash-String des in Großbuchstaben geschriebenen IDFA- oder Google Play-Werbe-ID-Werts.
- lmt ist eine Ganzzahl mit dem Wert „1“, wenn der Nutzer die Option „Anzeigen-Tracking einschränken“ mit IDFA oder AdID aktiviert hat, oder „0“, wenn sie nicht festgelegt ist.
DDM antwortet mit einer JSON-Antwort, in der angegeben wird, ob das Conversion-Ereignis einer von DCM ausgelieferten Impression oder einem von DCM ausgelieferten Klick zugeordnet wird. Wenn „YES“ (JA), werden zusätzliche Informationen zum Ereignis (letzte Impression oder letzter Klick) angegeben:
- Anzeigen-ID
- Website-ID
- Placement-ID
- Creative-ID
- Zeitstempel
Eine Beispiel-JSON-Antwort könnte so aussehen:
```
{
  "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>],
}
```
Dabei gilt:
- attributed ist der Wert 1 (wenn die Conversion einem Impression oder Klick zugeordnet werden kann) oder 0 (wenn dies nicht möglich ist).
- last_impression_ad_id (wenn attributed = 1) ist die Anzeigen-ID für die letzte Impression.
- last_impression_site_id (wenn „attributed“ = 1) ist die Website-ID für die letzte Impression.
- last_impression_placement_id (wenn „attributed“ = 1) ist die Placement-ID für die letzte Impression.
- last_impression_creative_id (wenn „attributed“ = 1) ist die Creative-ID für die letzte Impression.
- last_click_ad_id (wenn „attributed“ = 1 und ein Klick zugeordnet wurde) ist die Anzeigen-ID für den letzten Klick.
- last_click_site_id (wenn „attributed“ = 1 und ein Klick zugeordnet wurde) ist die Website-ID für den letzten Klick.
- last_click_placement_id (if attributed = 1 and a click was attributed) ist die Placement-ID für den letzten Klick.
- last_click_creative_id (wenn „attributed“ = 1 und ein Klick zugeordnet wurde) ist die Creative-ID für den letzten Klick.
- last_click_exclid entspricht einer eindeutigen Klick-ID, die mit dem Makro %eiid! eingefügt wird.
Ab der Durchsetzung des GDM im März 2024 sind auch die folgenden Felder verfügbar:
- cps gibt an, zu welchem Core Platform Service das Ereignis gehört.
  - a : Anzeigen
  - m : Maps
  - p : Play Store
  - s : Suche
  - h : Shopping
  - y : YouTube
- ad_events ist ein Array von ad_event-Objekten, das alle Conversion-Ereignisse enthält.
  - Das Objekt ad_event hat die folgenden Felder:
  - product_type ist ein String, der das Produkt angibt, das für die Conversion verantwortlich ist. Dies ist entweder DCM oder DBM.
  - interaction_type ist der Interaktionstyp, der zum Ereignis geführt hat. Entweder impression oder click.
  - conversion_metric ist der Conversion-Messwert, der für die Attribution verwendet wird. Entweder conversion oder view_through_conversion.
  - timestamp ist der UNIX-Zeitstempel des Anzeigenereignisses mit einer Genauigkeit bis auf Mikrosekunden. Dieser Wert sollte für die Attribution des letzten Klicks verwendet werden.
  - campaign_type gibt den Kampagnentyp an, der das Anzeigenereignis ausgelöst hat.
  - line_item_id (nur DBM) ist die DBM-Werbebuchungs-ID, die das Anzeigenereignis ausgelöst hat.
  - line_item_name (nur DBM) ist der Name der DBM-Werbebuchung, die das Anzeigenereignis ausgelöst hat.
  - placement_id (nur DCM) ist die ID des DCM-Placement-Tags, mit dem das Anzeigenereignis ausgelöst wurde.
  - placement_name (nur DCM) ist der Name des DCM-Placement-Tags, mit dem das Anzeigenereignis ausgelöst wurde.
  - external_customer_id ist die Werbetreibenden-ID der Kampagne, die das Anzeigenereignis generiert hat.
    - Wenn product „DBM“ ist, steht dieses Feld für die DBM-Werbetreibenden-ID.
    - Wenn product „DCM“ ist, steht dieses Feld für die DCM-Werbetreibenden-ID.
  - creative_id ist die ID des Creative-Anzeigenblocks, der das Anzeigenereignis ausgelöst hat.
    - Wenn product „DBM“ ist, steht dieses Feld für die DBM-Creative-ID.
    - Wenn product „DCM“ ist, steht dieses Feld für die DCM-Creative-ID.
  - exchange_id (nur DBM) ist die ID der Anzeigenplattform, über die die DBM-Anzeige ausgeliefert wurde.
  - insertion_order_id (nur DBM) ist die DBM-Anzeigenauftrags-ID.
  - site_id (nur DCM) ist die DCM-Website-ID für das Anzeigenereignis.
  - cps gibt an, zu welchem Core Platform Service das Anzeigenereignis gehört. Eine ausführliche Beschreibung des Felds cps finden Sie weiter oben in der Dokumentation.
- warnings ist ein Array von Warnungen, die vom Conversion-Ereignis generiert wurden.
- errors ist ein Array von Fehlern, die durch das Conversion-Ereignis mit HTTP-Fehlercodes für die folgenden Szenarien erzeugt werden:
  - HTTP 204, wenn das Anfragekontingent überschritten wurde.
  - HTTP 400, wenn die Anfrage als ungültig eingestuft wird, z. B. weil erforderliche Parameter fehlen und der Server auf Pixel-Tracking zurückgegriffen hat.
  - HTTP 401, wenn das Autorisierungstoken ungültig ist.
  - HTTP 404 für alle ungültigen Anfragen.
Der Werbetreibende kann Kampagnenberichte in Ihrem System und Conversion-Berichte in DCM mit denselben Parametern aufrufen.

Zusätzliche Beispielantworten nach Inkrafttreten des GDM im März 2024

Ein Beispiel für eine Antwort zum Conversion-Tracking, bei der die Conversion sowohl Such- als auch YouTube-Anzeigeninteraktionen zugeordnet wird, die Einwilligung zur gemeinsamen Nutzung gemäß Paragraf 5(2)(b) + 5(2)(c) zwischen den CPSs für Suche und YouTube jedoch verweigert wird:
```
{
  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
      },
  ]}
```
Beispiel für eine bestätigende Conversion-Tracking-Antwort für eine DBM-Kampagne:
```
{
  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"
  }
]}
```

DDM-Integration für das Tracking von Drittanbieter-Apps Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

DDM-Integration für das Tracking von Drittanbieter-Apps