Häufig gestellte Fragen

Gibt es Einschränkungen für das, was ich hochladen kann?

Es gibt einige Einschränkungen, die Sie beachten sollten:

  • Einzelne batchinsert- und batchupdate-Anfragen sind auf 1.000 Conversions beschränkt.
  • Der Zeitstempel einer Conversion darf beim Einreichen höchstens 28 Tage alt sein.
  • Sie können Conversions nur an eine Floodlight-Konfiguration senden, auf die Ihr Campaign Manager 360-Nutzerprofil Zugriff hat.
Soll ich Campaign Manager 360 oder Search Ads 360 zum Hochladen von Conversions verwenden?

In der Search Ads 360-Hilfe finden Sie einen detaillierten Vergleich der Funktionen beider Produkte.

Was passiert, wenn ich dieselbe Conversion sowohl in Campaign Manager 360 als auch in Search Ads 360 einfüge?

Wenn Sie dieselbe Conversion sowohl in Campaign Manager 360 als auch in Search Ads 360 einfügen, werden die Einträge nicht dedupliziert. Verwenden Sie in diesem Fall separate Floodlight-Aktivitäten.

Welche API sollte ich zum Hochladen von Offline-Conversions verwenden?

Wir empfehlen, die Data Manager API zu verwenden, um die Entwicklerfreundlichkeit zu verbessern und auf zusätzliche Funktionen zugreifen zu können.

Was ist ein Ordinalwert und wie wird er verwendet?

Ordinalwerte steuern, wie doppelte Conversions verarbeitet werden. Wenn mehrere Conversions mit derselben Floodlight-Aktivität, Floodlight-Konfigurations-ID, Nutzer-ID und demselben Conversion-Zeitstempel eingefügt werden, wird anhand der Ordinalzahl Folgendes bestimmt:

  • Die Conversions werden dedupliziert und nur eine bleibt erhalten. Das passiert, wenn alle Conversions denselben Ordinalwert haben.
  • Die Conversions werden einzeln verarbeitet und alle bleiben erhalten. Das ist der Fall, wenn alle Conversions einen anderen Ordinalwert haben.

Die Werte selbst müssen nicht aussagekräftig sein. Im Allgemeinen wird die Deduplizierung aktiviert, wenn Sie für alle Conversions einen festen Wert (z. B. 1) verwenden. Wenn Sie für jede Conversion einen zufälligen oder eindeutigen Wert verwenden, wird die Funktion deaktiviert.

Wie sollte ich mit Fehlern in der API-Antwort umgehen und welche Fehler sollte ich wiederholen?

batchinsert und batchupdate verarbeiten Konvertierungen nach dem Best-Effort-Prinzip: Eine Batchanfrage kann eine HTTP-200 OK-Antwort zurückgeben, während einzelne Konvertierungen innerhalb des Batches fehlschlagen. Prüfen Sie immer hasFailures in der Antwort und die Liste errors[] für jedes ConversionStatus-Objekt:

  • INTERNAL (Wiederholen): Bei der Verarbeitung der Konvertierung ist in den Systemen von Google ein vorübergehender Fehler aufgetreten. Die Conversion wurde nicht eingefügt oder aktualisiert. Wiederholen Sie fehlgeschlagene Conversions mit exponentiellem Backoff (z. B. nach einigen Minuten und dann über mehrere Stunden hinweg). Verwenden Sie dabei genau dieselben Werte für ordinal, timestampMicros, floodlightActivityId und die Nutzer- oder Klick-ID.
  • NOT_FOUND (Wiederholen mit Verzögerung): Die Kennung (gclid, dclid, matchId oder mobileDeviceId) oder die vorhandene Conversion, die bearbeitet wird, konnte noch nicht gefunden werden. Da die Verarbeitung und Indexierung von Online-Klicks, Floodlight-Tags und Conversions 1 bis 2 Stunden dauern kann, sollten Sie NOT_FOUND-Conversions regelmäßig wiederholen (z. B. alle 1 bis 3 Stunden, bis zu 6 Stunden lang). Wenn NOT_FOUND nach 6 Stunden weiterhin besteht, finden Sie in den folgenden Abschnitten häufige Ursachen nach Kennungstyp.
  • INVALID_ARGUMENT und PERMISSION_DENIED (keine Wiederholung): Die Conversion-Daten sind ungültig (z. B. ein Conversion-Zeitstempel, der älter als 28 Tage ist, oder ein fehlerhaftes Feld) oder Ihr Nutzerprofil hat keine Berechtigung für die Floodlight-Zielkonfiguration. Wiederholen Sie diese Konvertierungen nicht, ohne das zugrunde liegende Problem zu beheben.

Wenn die gesamte HTTP-Anfrage mit einem 5xx-Serverfehler oder einem 429-Kontingent-/Ratenbegrenzungsfehler fehlschlägt, wiederholen Sie die Anfrage mit exponentiellem Backoff.

Sichere Wiederholungen und Deduplizierung: Wenn Sie eine Konvertierung wiederholen, die mit INTERNAL oder NOT_FOUND fehlgeschlagen ist (oder nach einem HTTP-5xx-Zeitüberschreitungsfehler, bei dem das Ergebnis unbekannt ist), senden Sie immer genau dieselben ordinal und timestampMicros. Wenn eine Conversion bereits erfasst wurde, wird sie in Campaign Manager 360 automatisch anhand der ordinal, der Nutzer-ID, der Floodlight-Aktivität und des Conversion-Datums dedupliziert.

Was bedeutet es, wenn ein mobileDeviceId-Upload aufgrund eines NOT_FOUND-Fehlers fehlschlägt?

Die häufigsten Ursachen für diesen Fehler sind:

  • Der mobileDeviceId ist ungültig.
  • mobileDeviceId ist in Search Ads 360 nicht bekannt. Das bedeutet, dass auf dem Gerät noch keine Anzeige von Campaign Manager 360 ausgeliefert wurde.
Was bedeutet es, wenn ein gclid-Upload aufgrund eines NOT_FOUND-Fehlers fehlschlägt?

Die häufigsten Ursachen für diesen Fehler sind:

  • Der gclid ist ungültig.
  • Die gclid ist nicht mit einer Search Ads 360-Kampagne oder einer YouTube-Werbebuchung in Display & Video 360 verknüpft. Das kann passieren, wenn die gclid über eine Google Ads-Klickweiterleitung erfasst wurde, die nicht über Search Ads 360 geleitet wurde (z.B. Klicks auf Standorterweiterungen), oder über eine YouTube-Anzeigenklickweiterleitung, die nicht mit einer YouTube-Werbebuchung in Display & Video 360 verknüpft ist.
  • Der mit dem gclid verknüpfte Klick liegt zu weit zurück. Conversions können nur für Klicks eingefügt werden, die maximal 60 Tage alt sind.
  • Der mit dem gclid verknüpfte Klick ist zu neu. Wir empfehlen, gclid-basierte Conversion-Uploads um eine Stunde zu verzögern, damit die gclid verarbeitet und für den Abgleich verfügbar ist.
Was bedeutet es, wenn ein dclid-Upload aufgrund eines NOT_FOUND-Fehlers fehlschlägt?

Die häufigsten Ursachen für diesen Fehler sind:

  • Der dclid ist ungültig.
  • Der mit dem dclid verknüpfte Klick liegt zu weit zurück. Conversions können nur für Klicks eingefügt werden, die maximal 60 Tage alt sind.
  • Der mit dem dclid verknüpfte Klick ist zu neu. Wir empfehlen, dclid-basierte Conversion-Uploads um eine Stunde zu verzögern, damit die dclid verarbeitet und für den Abgleich verfügbar ist.
Was bedeutet es, wenn ein matchId-Upload aufgrund eines NOT_FOUND-Fehlers fehlschlägt?

Die häufigsten Ursachen für diesen Fehler sind:

  • Der matchId ist in Campaign Manager 360 nicht bekannt. Das kann passieren, wenn die matchId über einen Floodlight-Aufruf erfasst wurde, der nicht ordnungsgemäß über Campaign Manager 360 weitergeleitet wurde. Prüfen Sie, ob Ihre Floodlight-Aufrufe richtig funktionieren, einschließlich des Tag-Parameters matchId.
  • Der mit dem matchId verknüpfte Floodlight-Aufruf enthielt kein Cookie. Der Floodlight-Aufruf muss ein Cookie oder eine Kennung enthalten, damit Campaign Manager 360 die matchId korrekt speichern kann. Der Nutzer hat möglicherweise Cookies blockiert oder die Erfassung deaktiviert.
  • Der mit der matchId verknüpfte Floodlight-Aufruf liegt zu weit in der Vergangenheit. Offline-Conversions müssen innerhalb von 60 Tagen nach dem Floodlight-Aufruf mit der matchId hochgeladen werden.
  • Der Floodlight-Aufruf, der mit matchId verknüpft ist, ist zu neu. Wir empfehlen, matchId-basierte Conversion-Uploads um 2 Stunden zu verzögern, damit die matchId verarbeitet und für den Abgleich verfügbar ist.
Werden Offline-Conversions mit einem Zeitstempel vor der Erstellung der Floodlight-Aktivität in Berichte aufgenommen?

Der Upload von Offline-Conversions mit einem Zeitstempel vor der Erstellung der Floodlight-Aktivität kann als Floodlight-Impressionen und als nicht zugeordnete/zugeordnete Conversions erfasst werden, bis zu 28 Tage vor dem Zeitpunkt der Einreichung. Dieses Verhalten ist jedoch nicht garantiert und Sie sollten sich nicht darauf verlassen. Am besten erstellen Sie Floodlight-Aktivitäten vor dem frühesten Zeitstempel einer Offline-Conversion.

Welche Einwilligung ist erforderlich, um Offline-Conversions für die Erstellung von Zielgruppenlisten zu verwenden?

Zusätzlich zur Einwilligung in die Verwendung von Nutzerdaten für Anzeigen muss das Feld nonPersonalizedAd explizit auf false gesetzt werden, damit Zielgruppenlisten erstellt werden können.