Diese Seite wurde von der Cloud Translation API übersetzt.

Conversion-Tracking

Zusammenfassung

Mit dem Conversion-Tracking können Sie Conversions erfassen, die über eine unserer Action Center-Integrationen von Google initiiert wurden. Dies ist wichtig, damit die Integration ordnungsgemäß funktioniert. Außerdem kann es sich auf das Ranking auf bestimmten Seiten auswirken. Jedes Mal, wenn Google einen action_link anzeigt, wird diese URL so geändert, dass sie einen eindeutigen Suchparameter enthält: rwg_token. Sie müssen dieses Token speichern und die entsprechenden Werte zurückgeben, wenn ein Nutzer eine Buchung abschließt.

Führen Sie die folgenden Schritte aus, um die Integration abzuschließen:

rwg_token erfassen und speichern
Händler erfassen und speichern
Gibt die Werte für rwg_token und merchant_change zurück.
Testen und bestätigen Sie das Conversion-Tracking.

`rwg_token` erfassen und speichern

Um diese Integration abzuschließen, müssen Sie die rwg_token bis zu 30 Tage nach der ersten Google-Weiterleitung erfassen und speichern. Der Wert „rwg_token“ ist ein codierter String, der einige Metadaten zum Link und zum Händler enthält, der diesen Aktionslink generiert hat. Es werden keine Nutzerdaten im Token gespeichert oder verschlüsselt.

Tokensammlung

Wenn ein Nutzer auf Ihre Buchungsseite weitergeleitet wird, wird der URL der neue Suchparameter rwg_token angehängt. Auf Ihrer Buchungsseite müssen Sie den Wert analysieren. Es wird auch ein Beispiel dafür gezeigt, wie dieses Token für das Tracking auf Geräteebene über den Browser geparst werden kann.

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

Der an Ihre URL angehängte Suchparameter ist ein verschlüsseltes Token. Im folgenden Beispiel sehen Sie ein Beispiel für eine rwg_token. Mit diesem Beispieltoken können Sie prüfen, ob das Token korrekt geparst wird, einschließlich aller Sonderzeichen wie „=“. Im Folgenden finden Sie ein Beispiel für ein typisches Token.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Tokenspeicher

Beim Speichern der rwg_token können Sie Conversion-Tracking auf zwei verschiedenen Ebenen implementieren: auf Geräte- und auf Nutzerebene. Wo Sie das Token speichern, liegt in Ihrem Ermessen. Sie müssen es jedoch 30 Tage lang nach der ursprünglichen Verweisquelle speichern.

Im nächsten Beispiel wird Conversion-Tracking auf Geräteebene verwendet. Dabei werden die Werte mit einem eigenen Cookie in einem Webbrowser gespeichert. In diesem Beispiel wird davon ausgegangen, dass Sie den Tokenwert wie im Beispiel zum Tokenspeicher in eine Variable geparst haben. Ersetzen Sie rootdomain.com durch Ihre Domain.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Berücksichtigen Sie bei der Entscheidung, wo Sie die rwg_token speichern, Folgendes:

Speicherplatz auf Geräteebene

Die Geräteebene umfasst die Verwendung von Browser-Cookies, lokalen Speichern, lokalen App-Speichern oder anderen Methoden, mit denen das Token für den 30-tägigen Attributionszeitraum beibehalten werden kann. Da das Token lokal auf dem Gerät des Nutzers gespeichert wird, kann das Conversion-Ereignis nicht richtig zugeordnet werden, wenn der Nutzer das verwendete Gerät wechselt, den lokalen Speicher oder die Cookies löscht oder den Inkognitomodus verwendet. Wenn Sie das Conversion-Tracking auf Geräteebene verwenden, müssen Sie es auf allen unterstützten Oberflächen (einschließlich Mobilgeräten) neu implementieren.

Speicherplatz auf Nutzerebene

Auf Nutzerebene werden die Daten in Ihrer Anwendungsdatenbank über ein serverseitiges Analysesystem oder andere serverseitige Systeme gespeichert. Da das Token serverseitig gespeichert wird, wird das Conversion-Ereignis auch dann zugeordnet, wenn der Nutzer das verwendete Gerät wechselt, seinen lokalen Speicher oder seine Cookies löscht oder den Inkognitomodus verwendet, nachdem er sich wieder angemeldet hat. Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, können Sie es je nach Systemarchitektur einmal auf Ihrer Serverseite implementieren und für alle unterstützten Oberflächen wiederverwenden.

Jedes Mal, wenn Google einen von Ihnen über die Feeds bereitgestellten „action_link“ anzeigt, wird diese URL so geändert, dass sie einen eindeutigen Suchparameter enthält: rwg_token. Der Wert „rwg_token“ ist ein codierter String, der einige Metadaten zum Link enthält, auf den der Nutzer geklickt hat, aber keine Nutzerdaten. Sie sollten dieses Token speichern und im Rahmen des Conversion-Ereignisses zurückgeben.

Token aktualisieren

Wenn ein Nutzer von Google zum selben Händler weitergeleitet wird und ein vorhandenes Token gespeichert ist, wird das Token durch das neue Token aus der letzten Weiterleitung ersetzt. Wenn das Token ersetzt wird, wird der 30-tägige Speicherzeitraum des Tokens zurückgesetzt und alle neuen Conversions für diesen Händler sollten dem neuesten Token zugeordnet werden.

Weitere Informationen finden Sie in unseren Anforderungen an die Conversion-Attribution.

Händler erfassen und speichern

Wenn ein Nutzer zu Ihrer Buchungsseite weitergeleitet wird, müssen Sie eine Logik implementieren, mit der der Händler gefunden und erfasst wird. Normalerweise fügen Partner ihren Aktionslinks Händlermetadaten oder merchant_id hinzu, um den Händler zu identifizieren und zu speichern. Wir empfehlen, die merchant_id (oder die ausgewählte Kennung) zusammen mit der rwg_token zu speichern. Wenn ein Nutzer eine Buchung bestätigt, können Sie sich an den Händler wenden, bevor Sie die abgeschlossene Conversion-Anfrage senden. Ähnlich wie beim Speicherzeitraum für das Token muss der Händler 30 Tage nach der ursprünglichen Verweisaktion mit dem Token gespeichert werden.

In den folgenden Beispielen wird die zuvor gespeicherte rwg_token angepasst. Dabei wird davon ausgegangen, dass Sie den Händler aus den Metadaten in der angegebenen URL parsen und entweder als merchant_id speichern oder mit einem vorhandenen merchant_id abgleichen.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Gibt die Werte für `rwg_token` und `merchant_change` zurück.

Wenn ein Nutzer eine Buchung abschließt, die über einen Action Link-Verweis gestartet wurde, müssen Sie eine HTTP-POST-Anfrage an den Conversion-Endpunkt senden. Es gibt zwei Endpunkte, einen für die Produktionsumgebung und einen für die Sandbox-Umgebung.

Produktion:https://www.google.com/maps/conversion/collect
Sandbox:https://www.google.com/maps/conversion/debug/collect

Wenn Sie ein Conversion-Ereignis senden, müssen Sie den gespeicherten rwg_token und einen merchant_change-Wert von 1 oder 2 angeben. Weitere Informationen zu merchant_change finden Sie unter Wert für Händleränderung zurückgeben.

Der POST-Text muss ein JSON-codiertes Objekt im folgenden Format sein:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

Im nächsten Beispiel wird Conversion-Tracking auf Geräteebene mit einem Cookie auf dem Gerät des Nutzers verwendet. Es ist in JavaScript geschrieben:

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

Wert der Händleränderung zurückgeben

Anhand des merchant_changed-Werts wird ermittelt, ob der Händler vom ursprünglichen Weiterleitungshändler geändert wurde. Es ist üblich, den Händler zu wechseln, wenn sich Ihre Landingpage auf einer Plattform befindet, die auch andere Händler umfasst. Wenn ein Nutzer in diesem Fall von Google auf Ihre Plattform weitergeleitet wurde und zu einem anderen Händler weitergeleitet wurde, um dort eine Buchung abzuschließen, möchten wir wissen, dass eine Conversion stattgefunden hat, aber mit einem anderen Händler. Wir müssen den Händler nicht kennen, nur dass ein Conversion-Ereignis stattgefunden hat und der Händler anders war. Wir verwenden einen booleschen Wert, um festzustellen, ob sich ein Händler geändert hat.

Wenn Sie festlegen möchten, welchen Wert Sie merchant_change zuweisen möchten, müssen Sie den ursprünglichen Händler, der unter Händler erfassen und speichern gespeichert ist, prüfen, ob sich der Händler geändert hat, und dann den Wert anhand der folgenden Tabelle zuweisen.

Wenn sich Ihre Buchungsseite nicht auf einer Plattform befindet oder Nutzer nicht zu einem anderen Händler wechseln können, können Sie den Wert dieser Anfragen auf 2 hartcodieren. Das ist häufig der Fall bei Partnern, die ihre Buchungsseiten in die Website ihres Händlers einbinden oder benutzerdefinierte Landingpages für die Verarbeitung von Buchungen haben.

Wert der Händleränderung	Anforderung
1	Dieser Wert sollte verwendet werden, wenn ein Nutzer die Website des ursprünglichen Händlers verlassen und über Ihre Plattform einen Kauf bei einem anderen Händler abgeschlossen hat.
2	Dieser Wert sollte verwendet werden, wenn der Kunde eine Transaktion über die ursprüngliche Entität (Händler) abgeschlossen hat.

Testen und bestätigen Sie das Conversion-Tracking.

Um sicherzustellen, dass die Implementierung des Conversion-Trackings korrekt ist, müssen Sie den folgenden Test ausführen. Verwenden Sie Action-Links, die mit Ihren Händlern verknüpft sind, und stellen Sie sicher, dass die Anfragen in einem privaten oder Inkognitofenster erfolgen, damit alle vorherigen Tokens, die mit diesem Nutzer verknüpft sind, gelöscht werden.

Buchungen mit nur einem Aktionslink abschließen
- Bei direkten Buchungen ohne Verweis oder zuvor gespeicherte Tokens sollten keine Anfragen an Google gesendet werden.
Schließen Sie eine Buchung über einen Link mit einer angehängten rwg_token ab.
- Prüfen, ob die Anfrage erfolgreich war und mit den Werten rwg_token und merchant_change von 2 gesendet wurde
- Achten Sie darauf, dass Sie die rwg_token 30 Tage lang speichern.
Schließen Sie eine neue Buchung mit demselben Händler mit einer neuen rwg_token ab.
- Prüfen Sie, ob die Anfrage erfolgreich war und mit den neuen Werten rwg_token und merchant_change von 2 gesendet wurde.
- Achten Sie darauf, dass das Attributionsspeicherfenster des Tokens 30 Tage lang aktualisiert wird.
Rufen Sie direkt die Buchungsseite des Händlers auf, den Sie getestet haben, und führen Sie eine neue Buchung ohne angehängte rwg_token durch.
- Achten Sie darauf, dass die Anfrage mit dem zuvor gespeicherten rwg_token gesendet wird und der merchant_change-Wert 2 ist.

Wenn Sie eine Plattform haben, auf der Nutzer den Bezahlvorgang über einen anderen Händler abschließen können, führen Sie die folgenden Tests durch.

Rufen Sie die Buchungsseite des Händlers über einen Link mit einer angehängten rwg_token auf und rufen Sie dann einen anderen Händler auf, um eine Buchung vorzunehmen.
- Die Anfrage muss mit den rwg_token- und merchant_change-Werten 1 gesendet werden.

Senden Sie beim Testen die HTTP-POST-Anfrage an den Conversion-Endpunkt. Es gibt zwei Endpunkte, einen für die Produktionsumgebung und einen für die Sandbox-Umgebung.

Produktion:https://www.google.com/maps/conversion/collect
Sandbox:https://www.google.com/maps/conversion/debug/collect

Fügen Sie Ihrem Aktionslink oder Ihrer URL das folgende Token hinzu:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Verwenden Sie das folgende Token für Tests, für die zusätzliche Tokens erforderlich sind.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Nachdem Sie die erfolgreichen Conversion-Ereignisse gesendet haben, werden sie im Steuerfeld unter dem Conversion-Tracking-Dashboard zusammengefasst. Es kann bis zu einer Stunde dauern, bis Conversions im Dashboard angezeigt werden.

conversion-tracking-dashboard

Anforderungen an die Conversion-Zuordnung

Der von Google für die Conversion-Attribution erforderliche Standard ist ein Attributionszeitraum von 30 Tagen für jede Interaktion mit einem Ortslink in einem beliebigen Geschäft.

In diesem Attributionsfenster erwartet Google, dass ein Conversion-Ereignis in einem der folgenden Szenarien gesendet wird:

Ein Nutzer folgt einem Link zu einer Platzierung und tätigt in derselben Sitzung eine Bestellung beim selben Händler. (Merchant Change Value = 2 )
Ein Nutzer folgt einem Link zu einer Place Action und kehrt innerhalb von 30 Tagen über einen anderen Kanal zurück, um eine Bestellung beim selben Händler aufzugeben. (Merchant Change Value = 2 )
Ein Nutzer folgt einem Link zu einer Aktion für einen Ort und gibt dann in einem anderen Geschäft eine Bestellung auf, entweder in derselben Sitzung oder in einer anderen Sitzung innerhalb eines Zeitraums von 30 Tagen. ( Händleränderungswert = 1)

Außerdem erwartet Google, dass Conversion-Ereignisse von allen Oberflächen gesendet werden, auf die Nutzer über einen Link für ortsbezogene Aktionen weitergeleitet werden können. Einschließlich:

Web-Anwendungen für Computer oder Mobilgeräte
Mobile Apps, entweder über einen App-Deeplink oder eine registrierte App-Intent für Ihre Domain

Wenn das Token auf Nutzerebene gespeichert wird (siehe „Token speichern“), müssen Sie geräteübergreifende Attributionen bereitstellen. Das heißt, ein Nutzer, der auf einem Computer auf einen Aktionslink klickt und die Transaktion dann auf einem Mobilgerät mit demselben Nutzerkonto abschließt, sollte ein Conversion-Ereignis auslösen.

Wenn das Token ausschließlich auf Geräteebene gespeichert wird, z. B. in Browser-Cookies, ist keine geräteübergreifende Attribution erforderlich. In diesem Fall würde für jedes Gerät ein separates Token gespeichert, wenn der Nutzer auf diesem Gerät auf einen Aktionslink geklickt hat. Für jedes Gerät gelten dann die Attributionsregeln separat.