Diese Seite wurde von der Cloud Translation API übersetzt.

Conversion-Tracking

Übersicht

Beim Conversion-Tracking werden Conversions erfasst, die über eine unserer Action Center-Integrationen von Google initiiert wurden. Die Integration muss ordnungsgemäß funktionieren, da sie sich auf das Ranking bestimmter Seiten auswirken kann. Jedes Mal, wenn Google eine action_link generiert, wird die entsprechende URL so geändert, dass sie einen eindeutigen Suchparameter enthält: rwg_token. Sie können das Token speichern und die entsprechenden Werte zurückgeben, wenn ein Nutzer eine Buchung abschließt.

So schließen Sie die Integration ab:

rwg_token analysieren und speichern
Die Händlerinformationen werden analysiert und gespeichert.
Gibt die Werte für rwg_token und merchant_changed zurück.
Testen und bestätigen Sie das Conversion-Tracking.

`rwg_token` parsen und speichern

Um die Integration abzuschließen, müssen Sie die rwg_token bis zu 30 Tage nach der ersten Google-Weiterleitung erfassen und speichern. Der rwg_token-Wert ist ein codierter String, der Metadaten zum Link und die Händlerinformationen enthält, die diesen rwg_token generiert haben.action_link

Token parsen

Wenn ein Nutzer auf Ihre Buchungsseite weitergeleitet wird, wird der angegebenen URL eine neue rwg_token angehängt. Auf Ihrer Buchungsseite müssen Sie den Tokenwert parsen.

Im folgenden Beispiel wird gezeigt, wie die rwg_token für das Tracking auf Geräteebene über einen Browser geparst wird.

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;
  }
}

Das an deine URL angehängte Token ist verschlüsselt. Siehe das folgende Beispiel für eine rwg_token. Verwenden Sie dieses Beispieltoken, um sicherzustellen, dass Sie das Token und alle Sonderzeichen wie = richtig parsen.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Token speichern

Wenn Sie die rwg_token speichern, können Sie Conversion-Tracking auf zwei Ebenen implementieren:

Auf Geräteebene
Nutzerebene

Sie können das Token auf jeder Ebene speichern, aber es muss 30 Tage nach der ursprünglichen Verweisquelle gespeichert werden.

Das folgende Beispiel zeigt das Conversion-Tracking auf Geräteebene. Sie können die Tokenwerte in einem Browser mit dem eigenen Cookie speichern. In diesem Beispiel wird davon ausgegangen, dass Sie den Tokenwert 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=/";
}

Jedes Mal, wenn Google eine action_link generiert, die Sie über die Feeds angegeben haben, wird die URL so geändert, dass sie einen eindeutigen Suchparameter enthält: rwg_token. Sie müssen dieses Token speichern und als Teil des Conversion-Ereignisses zurückgeben.

Auf Geräteebene speichern

Die Geräteebene umfasst die Verwendung von Browser-Cookies, lokalen Speichern, lokalen App-Speichern oder anderen Methoden, mit denen das Token für die 30-tägige Attributionsdauer beibehalten werden kann. Das Token wird lokal auf dem Gerät des Nutzers gespeichert. Das Conversion-Ereignis kann also nicht richtig zugeordnet werden, wenn der Nutzer

Ändert das verwendete Gerät.
Löscht den lokalen Speicher oder die Cookies.
Sie verwenden einen privaten Browser oder den Inkognitomodus.

Wenn Sie das Conversion-Tracking auf Geräteebene verwenden, müssen Sie das Conversion-Ereignis auf allen unterstützten Geräten neu implementieren, einschließlich Mobilgeräten.

Auf Nutzerebene speichern

Auf Nutzerebene wird das Token über ein serverseitiges Analysesystem oder andere serverseitige Systeme in Ihrer Anwendungsdatenbank gespeichert. Das Token wird auf der Serverseite gespeichert. Das Conversion-Ereignis wird also auch dann korrekt zugeordnet, wenn sich der Nutzer wieder anmeldet.

Wenn Sie Conversion-Tracking auf Nutzerebene basierend auf Ihrer Systemarchitektur verwenden, können Sie das Conversion-Ereignis einmal auf Ihrer Serverseite implementieren und auf allen unterstützten Geräten wiederverwenden.

Token aktualisieren

Wenn Google einen Nutzer an denselben Händler weiterleitet, wird das vorhandene Token, das bereits gespeichert ist, durch das neue Token aus der letzten Weiterleitung ersetzt. Nach dem Token-Ersetzen wird das 30-tägige Attributionsfenster des Tokenspeichers zurückgesetzt und alle neuen Conversions für diesen Händler werden dem neuesten Token zugeordnet.

Weitere Informationen finden Sie unter Anforderungen an die Conversion-Attribution.

Händlerinformationen analysieren und speichern

Wenn ein Nutzer zu Ihrer Buchungsseite weitergeleitet wird, müssen Sie die Logik implementieren, mit der die Händlerdetails gefunden und erfasst werden können. Normalerweise fügen Partner ihren Aktionslinks Händlermetadaten oder merchant_id hinzu, um die Händlerinformationen 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 vollständige Conversion-Anfrage senden. Ähnlich wie beim Tokenspeicher müssen Sie die Händlerdetails 30 Tage nach der ursprünglichen Verweisaktion speichern.

Im folgenden Beispiel wird die zuvor gespeicherte rwg_token geändert. Es wird davon ausgegangen, dass Sie die Händlerinformationen aus den Metadaten in der angegebenen URL geparst und entweder als merchant_id gespeichert oder mit einer vorhandenen merchant_id abgeglichen haben.

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

`rwg_token`- und `merchant_changed`-Werte zurückgeben

Wenn ein Nutzer eine Buchung abschließt, die über eine action_link-Vermittlung erfolgt, müssen Sie eine HTTP-POST-Anfrage an den Conversion-Endpunkt senden. Es gibt zwei Endpunkte:

Produktionsumgebung: https://www.google.com/maps/conversion/collect
Sandbox-Umgebung: https://www.google.com/maps/conversion/debug/collect

Wenn Sie ein Conversion-Ereignis senden, müssen Sie den gespeicherten rwg_token und einen merchant_changed-Wert von 1 oder 2 angeben. Weitere Informationen zu merchant_changed 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 folgenden 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 Werts von merchant_changed wird ermittelt, ob der Händler vom ursprünglichen Weiterleitungshändler geändert wurde. Ein Wechsel des Händlers ist häufig, wenn sich Ihre Landingpage auf einer Plattform befindet, die auch andere Händler umfasst. Wenn ein Nutzer in diesem Fall von Google zu Ihrer Plattform weitergeleitet wird und sich entscheidet, zu einem anderen Händler zu wechseln, um eine Buchung abzuschließen, müssen Sie wissen, dass eine Conversion bei einem anderen Händler erfolgt ist. Sie können einen booleschen Wert verwenden, um die Händleränderung zu identifizieren, aber nicht die Händlerdetails.

Wenn Sie entscheiden, welchen Wert Sie der merchant_changed zuweisen möchten, müssen Sie den ursprünglichen Händler berücksichtigen, der unter Händlerinformationen parsen und speichern gespeichert ist. Prüfen Sie, ob sich der Händler geändert hat, und weisen Sie den Wert entsprechend zu.

Anforderung: Wenn ein Nutzer die Website des ursprünglichen Händlers verlässt und einen Kauf über Ihre Plattform bei einem anderen Händler abschließt.
- Wert der Händleränderung: 1
Anforderung: Wenn der Nutzer eine Transaktion über den ursprünglichen Händler abschließt.
- Wert der Händleränderung: 2

Conversion-Tracking testen und bestätigen

In den folgenden Testfällen werden Testtokens verwendet, die im Abschnitt Testtokens bereitgestellt werden. Sie sollen Ihnen dabei helfen, die verschiedenen Szenarien zu verstehen, die zu einem Conversion-Ereignis führen können. So wird sichergestellt, dass das Token richtig gespeichert, der merchant_changed-Wert korrekt festgelegt und das Conversion-Ereignis bei Bedarf gesendet wird.

Verwenden Sie die in Ihren Feeds angegebenen URLs für den Aktionslink oder die Buchungsseite und führen Sie jeden Testfall aus, indem Sie die Test-Tokens an das Ende der URL anhängen. Verwenden Sie ein privates Browserfenster. Dadurch werden alle vorhandenen Tokens gelöscht, die mit dem aktuellen Nutzer verknüpft sind.

Testfall	Testbeschreibung	Nutzerfluss	Erwartetes Ergebnis
1	Ein Nutzer führt eine Buchung durch, die nicht auf Google gestartet wurde.	Ein Nutzer gelangt direkt zur Buchungsseite, ohne von Google weitergeleitet zu werden oder ohne einen bestehenden Verweis. Das sollte zu keinem Conversion-Ereignis führen.	Kein Conversion-Ereignis, da der Nutzer die Buchungsseite zuvor nicht besucht hat oder nicht über Google weitergeleitet wurde.
2	Ein Nutzer schließt eine Buchung ab, die auf Google gestartet wurde.	Ein Nutzer findet Ihren Händler über Google, wird zu Ihrer Buchungsseite weitergeleitet und bucht einen Termin.	*Es wird ein Conversion-Ereignis mit Token A* und dem Wert 2 für Händler geändert gesendet**, da der Nutzer von Google zur Buchungsseite weitergeleitet wurde.
3	Ein Nutzer (aus Google stammend) beginnt mit dem Buchungsvorgang, beendet die Sitzung jedoch, bevor die Buchung abgeschlossen ist. Hinweis: Lassen Sie diese Sitzung für Test 4 und 5 geöffnet.	Ein Nutzer wird auf Ihre Buchungsseite weitergeleitet, die Sitzung endet jedoch und er schließt keine Buchung ab.	Keine Conversion, da der Nutzer die Buchung nicht abgeschlossen hat. Token B sollte jedoch 30 Tage lang gespeichert werden.
4	Ein Nutzer kehrt zur Buchungsseite zurück, ohne von Google weitergeleitet worden zu sein, und schließt eine Buchung ab. Hinweis: Die URL des Buchungsvorgangs darf kein rwg_token enthalten.	Ein Nutzer kehrt nach Test 4 zur Buchungsseite zurück. Token B sollte 30 Tage lang gespeichert werden. Für jede Conversion innerhalb dieses Zeitraums sollte ein Conversion-Ereignis zurückgegeben werden.	*Es wird ein Conversion-Ereignis mit Token B* und dem Wert 2 für Händler geändert gesendet**, da der Nutzer nach einer vorherigen Verweisweiterleitung von Google zur Buchungsseite zurückkehrt.
5	Ein Nutzer führt nach Test 4 eine neue Buchung aus Google aus.	Wenn ein Nutzer nach einer vorherigen Google-Weiterleitung über eine Google-Weiterleitung zu Ihrer Buchungsseite zurückkehrt, wird sein 30-tägiger Speicherzeitraum zurückgesetzt und das alte Token Token B wird durch ein neues Token Token C ersetzt. Alle zukünftigen Conversions werden dann Token C zugeordnet.	*Es wird ein Conversion-Ereignis mit Token C* und dem Wert 2 für Händler geändert gesendet**, da der Nutzer die Buchung abgeschlossen hat und das neue Token das zuvor gespeicherte Token ersetzt hat.

Wenn Nutzer auf Ihrer Plattform beim Bezahlen zu einem anderen Händler weitergeleitet werden, führen Sie die folgenden Tests durch.

Testfall	Testbeschreibung	Nutzerfluss	Erwartetes Ergebnis
6	Ein Nutzer wird von Google auf Ihre Buchungsseite weitergeleitet und tätigt eine Buchung bei einem anderen Händler.	Ein Nutzer wird von Google auf Ihre Buchungsseite weitergeleitet. Dabei wird Token A verwendet. Bevor er die Buchung abschließt, wechselt er jedoch zu einer anderen Seite und führt die Buchung bei einem Händler durch, der sich von dem ursprünglichen Verweis unterscheidet.	Es wird ein Conversion-Ereignis gesendet, da der Nutzer eine Buchung abgeschlossen hat, die über eine Verweisquelle von Google mit Token A und dem Wert 1 für Händler geändert aufgerufen wurde, weil der Nutzer die Buchung bei einem anderen Händler als dem Verweis abgeschlossen hat.

Senden Sie während des Tests die HTTP-POST-Anfrage an den Conversion-Endpunkt. Es gibt zwei Endpunkte:

Produktionsumgebung: https://www.google.com/maps/conversion/collect
Sandbox-Umgebung: https://www.google.com/maps/conversion/debug/collect

Testtokens

Wenn Sie das Conversion-Tracking testen möchten, fügen Sie am Ende der Aktionslinks oder Buchungsseiten-URLs, die Sie in Ihren Feeds angeben, eines der folgenden Testtokens hinzu.

Token A:

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

Token B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Token C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Wenn Sie die erfolgreichen Conversion-Ereignisse gesendet haben, werden sie im Action Center im Conversion-Tracking-Dashboard zusammengefasst.

conversion-tracking-dashboard

Anforderungen an die Conversion-Zuordnung

Der von Google für die Conversion-Attribution geforderte Standard ist ein Attributionszeitraum von 30 Tagen für jede Interaktion mit einem Link zu einer Place Action in einem beliebigen Geschäft.

In diesem Attributionsfenster kann Google davon ausgehen, 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. Wert für Händleränderung = 2.
Ein Nutzer folgt einem Link zu einer Place Action und kehrt innerhalb des 30-tägigen Attributionszeitraums über einen anderen Kanal zurück, um eine Bestellung beim selben Händler aufzugeben. Wert für Händleränderung = 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 Attributionszeitraums von 30 Tagen. Wert für Händleränderung = 1.

Außerdem erwartet Google, dass Conversion-Ereignisse von jedem Gerät gesendet werden, auf das ein Nutzer über einen Place Actions-Link zugreifen kann. Dazu gehören:

Computer- oder mobile Webanwendungen
Mobile Apps, entweder über einen App-Deeplink oder eine registrierte App-Intent für Ihre Domain.

Wenn das Token auf Nutzerebene gespeichert ist, müssen Sie geräteübergreifende Attribution bereitstellen. Weitere Informationen finden Sie unter Daten auf Nutzerebene speichern. In diesem Fall muss ein Nutzer, der auf einem Computer einem Aktionslink folgt und dann die Transaktion mit demselben Nutzerkonto auf einem Mobilgerät abschließt, 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 kann für jedes Gerät ein separates Token gespeichert werden, wenn der Nutzer auf diesem Gerät einem Aktionslink folgt. Außerdem können für jedes Gerät die Attributionsregeln separat angewendet werden.

Zurück

Feeds

Weiter

Integrationsüberprüfung