Daten zu Conversions hochladen

Wenn ein Kunde eine vordefinierte Aktion auf der Website eines Werbetreibenden ausführt, z. B. einen Artikel kauft oder weitere Informationen anfordert, wird in Search Ads 360 eine Conversion erfasst.

Manche Conversions beginnen online und werden offline abgeschlossen. Beispiel: Ein Nutzer startet eine Suche nach einem Produkt online, klickt auf eine Anzeige und telefoniert dann mit einem Callcenter, um den Kauf abzuschließen. Oder ein Verbraucher mit einem Smartphone tippt in einer Anzeige auf den Button „Jetzt anrufen“ und kauft einen Artikel über das Telefon. Für diese Conversions werden in Search Ads 360 automatisch Daten zum Onlineteil erfasst. Wenn Sie Daten zum Offlineteil berücksichtigen möchten, um Berichte zu verbessern, die Daten für automatisierte Regeln zu verwenden oder eine Gebotsstrategie zu optimieren, können Sie sie in Search Ads 360 hochladen.

In einigen Fällen müssen Sie möglicherweise den Wert einer vorhandenen Conversion ändern. Beispielsweise können Sie einen Conversion-Wert bearbeiten, um Rabatte zu berücksichtigen, die nach einem Onlinekauf angewendet wurden (z. B. ein Mail-in-Rabatt), Rückgaben, die mit einer Rücknahmegebühr verbunden waren, oder Gutschriften, die nach dem Kauf angewendet wurden.

Nachdem Sie Ihre Client-App wie unter Meine erste App beschrieben eingerichtet haben (einschließlich der Aktivierung des Conversion-Dienstes), können Sie die folgenden Conversion-bezogenen Anfragen an die Search Ads 360 API senden:

Einfügen

Fügt neue Conversions hinzu.

Aktualisieren

Ändert vorhandene Conversions.

Synchrone Anfragen

Alle Konvertierungsanfragen sind synchron. Sie können in einem einzelnen Client parallele synchrone Anfragen stellen (bis zum Limit Ihres Projekts).

Search Ads 360-IDs und ‑Conversions

Jede Conversion muss dem Besuch oder dem Keyword zugeordnet werden, der bzw. das dazu geführt hat. In Ihrer Anfrage wird auf eine der folgenden Arten angegeben, worauf die Conversion zurückzuführen ist:

  • Nach Klick-ID: In Search Ads 360 wird die Klick-ID verwendet, um das Konto, die Kampagne, die Anzeigengruppe, das Keyword und die Anzeige zu finden, die für den Besuch verantwortlich sind. Sie müssen in der Anfrage keine andere Search Ads 360-ID angeben.

  • Nach Keyword: Keyword-IDs sind nur innerhalb einer Anzeigengruppe eindeutig. Sie müssen daher alle IDs angeben, die das Keyword identifizieren: customerId, campaignId, adGroupId und criterionId.

Die Search Ads 360 API verwendet die IDs der neuen Search Ads 360-Version. In den Antworten wird das Konto jeder Conversion anhand der customerId (Kundennummer des Kundenkontos im Format 123-456-7890) identifiziert. Außerdem enthalten sie die IDs der Kampagne, Anzeigengruppe, des Keywords und der Anzeige in der neuen Search Ads 360-Version. Antworten enthalten nicht die agencyId, advertiserId und engineAccountId der vorherigen Search Ads 360-Version. Weitere Informationen finden Sie unter Neue Search Ads 360-Version.

Search Ads 360-IDs abrufen

Wenn Sie die IDs ermitteln möchten, mit denen ein Keyword identifiziert wird, rufen Sie die folgenden Felder über die neue Search Ads 360-Version Reporting API ab:

Klick-IDs

Mit einer Klick-ID wird ein Klick auf eine Anzeige erfasst. Sie können damit eine Conversion einem bestimmten Besuch zuordnen, anstatt die gesamte Hierarchie von IDs für Search Ads 360-Objekte anzugeben. In Search Ads 360 wird die Klick-ID verwendet, um das entsprechende Keyword und die entsprechende Anzeige zu finden und zuzuordnen.

Bei Klick-IDs wird zwischen Groß- und Kleinschreibung unterschieden. Achten Sie daher darauf, dass Ihre Webprotokolle und Ihre Tracking-Software keine Änderungen an der Groß- und Kleinschreibung der Klick-ID vornehmen.

Klick-ID generieren

Die Klick-ID wird entweder von Search Ads 360 oder von Google Ads generiert.

Wenn in einem Google Ads-Konto automatisches Tagging aktiviert ist, wird in Google Ads eine Klick-ID generiert, sobald eine Anzeige ausgeliefert wird. Wenn ein Nutzer mehrmals auf eine bestimmte Anzeigenimpression klickt, werden diese Klicks deshalb nur einer Klick-ID zugeordnet. Landingpage-Besuche für dieselbe Impression haben dieselbe Klick-ID.

In Search Ads 360 kann eine Klick-ID generiert werden, wenn Sie den Conversion-API-Dienst aktivieren. Wenn ein Klick von Google Ads weitergeleitet wird und Google Ads bereits eine Klick-ID generiert hat, verwendet Search Ads 360 die Google Ads-ID, anstatt eine neue zu generieren. Wenn ein Klick von einer anderen unterstützten Suchmaschine weitergeleitet wird, generiert Search Ads 360 die ID.

Klick-ID-Parameter

Jede Klick-ID besteht aus zwei Parametern. Beispiel:

gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds

Der Parameter gclid enthält eine ID für den Klick, bei der die Groß-/Kleinschreibung beachtet wird. In Search Ads 360 werden die Attributionsinformationen (z. B. Keyword, Anzeige, Kampagne, Anzeigengruppe) für jede generierte Klick-ID gespeichert.

Der Parameter gclsrc gibt die Quelle der Klick-ID an. Derzeit kann es einen der folgenden Werte haben:

  • gclsrc=ds: Die Klick-ID wurde von Search Ads 360 generiert. Außerdem erfolgte der Klick entweder auf eine andere Suchmaschine als Google oder auf Google, aber im Google Ads-Konto wird kein automatisches Tagging verwendet.

  • gclsrc=aw.ds: Die Klick-ID wurde von Google Ads generiert, wobei das automatische Tagging verwendet wird. Der Klick wurde über den Search Ads 360-Klickserver geleitet.

  • gclsrc=: Der Parameter ist leer, wenn die Klick-ID von Google Ads generiert wurde, aber die Conversion API in Search Ads 360 zum Zeitpunkt des Klicks nicht aktiviert war.