Conversion-Tracking

Abbildung 1. Übersicht zum Conversion-Tracking

Übersicht

Mit dem Conversion-Tracking werden Conversions erfasst, die von Google über eine unserer Action Center-Integrationen initiiert wurden. Es trägt dazu bei, dass Ihre Integration einwandfrei funktioniert, da es sich auf das Ranking auf bestimmten Seiten auswirken kann. Jedes Mal, wenn Google einen action_link generiert, wird die 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 Reservierung abschließt.

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

1. rwg_token parsen und speichern.
2. Händlerinformationen parsen und speichern.
3. Die Werte rwg_token und merchant_changed zurückgeben.
4. Conversion-Tracking testen und überprüfen.

Hinweis: Das Standardverfahren für die Integration erfordert, dass Partner das Conversion-Tracking zur Leistungsmessung implementieren. Die technischen Schritte werden im Abschnitt beschrieben, der später erläutert wird. Die Implementierung des Conversion-Trackings ist für Partner im Gesundheitswesen optional und richtet sich nach den geschäftlichen Anforderungen

rwg_token parsen und speichern

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

Wichtig: Es werden keine personenidentifizierbaren Informationen gespeichert oder verschlüsselt.

Token parsen

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

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

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

Wichtig: Google empfiehlt, das Token als decodierten Wert in Ihrem Cookie zu speichern, da Browser-Cookies bestimmte Verwendungszwecke für Sonderzeichen wie = haben. Achten Sie in jedem Fall darauf, dass die decodierte Version in der Conversion-RPC gesendet wird und alle Sonderzeichen wie = enthält.

Token speichern

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

• Geräteebene
• Nutzerebene

Sie können das Token auf jeder Ebene speichern, müssen es aber 30 Tage nach der ersten Weiterleitung speichern.

Im folgenden Beispiel wird das Conversion-Tracking auf Geräteebene gezeigt. Sie können die Tokenwerte in einem Browser mit dem First-Party-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 (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}

Jedes Mal, wenn Google einen action_link generiert, den Sie über die Feeds bereitgestellt 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

Auf Geräteebene werden Browser-Cookies, lokaler Speicher, lokaler App-Speicher oder eine andere Methode verwendet, mit der das Token für den 30-tägigen Attributionszeitraum gespeichert 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:

• Das verwendete Gerät ändert.
• Den lokalen Speicher oder die Cookies löscht.
• Einen privaten Browser oder den Inkognitomodus verwendet.

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

Auf Nutzerebene speichern

Auf Nutzerebene wird das Token in Ihrer Anwendungsdatenbank, über ein serverseitiges Analysesystem oder andere serverseitige Systeme gespeichert. Das Token wird serverseitig gespeichert. Das Conversion-Ereignis wird also auch nach der erneuten Anmeldung des Nutzers richtig zugeordnet.

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

Hinweis: Sie können je nach Bedarf entscheiden, wo Sie das rwg_token speichern.

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 Ersetzen des Tokens wird der 30-tägige Attributionszeitraum für die Tokenspeicherung 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 für mehr Details.

Händlerinformationen parsen und speichern

Wenn ein Nutzer auf Ihre Reservierungsseite weitergeleitet wird, müssen Sie die Logik implementieren, mit der die Händlerdetails gefunden und erfasst werden können. In der Regel fügen Partner ihren Aktionslinks Händlermetadaten oder eine merchant_id hinzu und verwenden diese, um die Händlerinformationen zu identifizieren und zu speichern.

Wir empfehlen, die merchant_id oder die ausgewählte ID zusammen mit dem rwg_token zu speichern. Wenn ein Nutzer eine Reservierung bestätigt, können Sie auf den Händler verweisen, bevor Sie die vollständige Conversion-Anfrage senden. Ähnlich wie bei der Tokenspeicherung müssen Sie die Händlerdetails 30 Tage nach der ersten Weiterleitung zusammen mit dem Token speichern.

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

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}

Die Werte rwg_token und merchant_changed zurückgeben

Wenn ein Nutzer eine Reservierung abschließt, die über eine Weiterleitung von einem action_link beginnt, 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 das gespeicherte 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": "AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg==",
  "merchant_changed": "2"
}

Das folgende Beispiel enthält das Conversion-Tracking auf Geräteebene mit einem Cookie auf dem Gerät des Nutzers, geschrieben in JavaScript:

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

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      merchant_changed: merchantChanged
    })
  });
}

Achtung: Der einzige akzeptierte MIME Content-Type ist text/plain. Legen Sie im Header keinen anderen Content-Type fest, da dies zu einem CORS-Fehler führt.

Warnung: Achten Sie darauf, dass im Rahmen der Conversion-Daten keine personenbezogenen Daten an Google gesendet werden.

Hinweis: In der Produktionsumgebung dürfen Sie keine Conversion-Ereignisse senden, die nicht dieser Integration zugeordnet sind. Es empfiehlt sich, vor dem Senden des Ereignisses zu prüfen, ob ein gültiger und nicht abgelaufener rwg_token-Wert vorhanden ist.

Wert für Händleränderung zurückgeben

Mit dem Wert merchant_changed wird ermittelt, ob der Händler vom ursprünglichen Händler der Weiterleitung abweicht. Ein Händlerwechsel ist üblich, wenn sich Ihre Landingpage auf einer Plattform befindet, die andere Händler umfasst. Wenn ein Nutzer in diesem Fall von Google auf Ihre Plattform weitergeleitet wird und sich entscheidet, zu einem anderen Händler zu wechseln, um eine Reservierung abzuschließen, müssen Sie wissen, dass eine Conversion bei einem anderen Händler stattgefunden hat. 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 dem merchant_changed zuweisen, müssen Sie den ursprünglichen Händler verwenden, der unter Händlerinformationen parsen und speichern gespeichert wurde. Prüfen Sie, ob sich der Händler geändert hat, und weisen Sie den Wert entsprechend Ihren Anforderungen zu.

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

Hinweis: Wenn sich Ihre Reservierungsseite nicht auf einer Plattform befindet oder Nutzer nicht zu einem anderen Händler wechseln können, können Sie den Wert dieser Anfragen fest auf 2 codieren. Dies ist üblich für Partner, die ihre Reservierungsseiten in die Website ihres Händlers integrieren oder benutzerdefinierte Landingpages haben, um eine Reservierung zu verarbeiten.

Conversion-Tracking testen und überprüfen

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

Verwenden Sie die URLs für Aktionslinks oder Reservierungsseiten, die in Ihren Feeds angegeben sind, und führen Sie jeden Testfall aus, indem Sie die Test-Tokens am Ende der URL anhängen. Verwenden Sie ein privates Browserfenster oder den Inkognitomodus, um alle vorhandenen Tokens zu löschen, die mit dem aktuellen Nutzer verknüpft sind.

Testfall	Testbeschreibung	User Flow	Erwartetes Ergebnis
1	Ein Nutzer schließt eine Reservierung ab, die nicht auf Google begonnen hat.	Ein Nutzer ruft die Reservierungsseite direkt auf, ohne von Google weitergeleitet zu werden oder ohne eine vorhandene Weiterleitung. Dies sollte nicht zu einem Conversion-Ereignis führen.	Kein Conversion-Ereignis , da der Nutzer die Reservierungsseite zuvor nicht besucht hat oder nicht von Google weitergeleitet wurde.
2	Ein Nutzer schließt eine Reservierung ab, die auf Google begonnen hat.	Ein Nutzer findet Ihren Händler über Google, wird auf Ihre Reservierungsseite weitergeleitet und schließt eine Reservierung ab.	Ein Conversion-Ereignis wird gesendet mit Token A und dem Wert 2 für merchant changed , da der Nutzer von Google auf die Reservierungsseite weitergeleitet wurde.
3	Ein Nutzer (der von Google kommt) beginnt den Reservierungsvorgang, beendet die Sitzung aber, bevor eine Reservierung abgeschlossen ist. Hinweis: Lassen Sie diese Sitzung für Test 4 und 5 geöffnet.	Ein Nutzer wird auf Ihre Reservierungsseite weitergeleitet, die Sitzung wird aber beendet und er schließt keine Reservierung ab.	Keine Conversion , da der Nutzer keine Reservierung abgeschlossen hat. Token B sollte aber 30 Tage lang gespeichert werden.
4	Ein Nutzer kehrt zur Reservierungsseite zurück, ohne von Google weitergeleitet worden zu sein, und schließt eine Reservierung ab. Hinweis: Die URL des Reservierungsvorgangs darf kein „rwg_token“ enthalten.	Ein Nutzer kehrt nach Test 4 zur Reservierungsseite zurück. Token B sollte 30 Tage lang gespeichert werden und jede Conversion innerhalb dieser 30 Tage sollte ein Conversion-Ereignis zurückgeben.	Ein Conversion-Ereignis wird gesendet mit Token B und dem Wert 2 für merchant changed , da der Nutzer nach einer vorherigen Weiterleitung von Google zur Reservierungsseite zurückkehrt.
5	Ein Nutzer schließt nach Test 4 eine neue Reservierung ab, die auf Google begonnen hat.	Wenn ein Nutzer nach einer vorherigen Weiterleitung von Google über eine Weiterleitung von Google auf Ihre Reservierungsseite zurückkehrt, wird der 30-tägige Speicherzeitraum zurückgesetzt und ein neues Token Token C ersetzt das alte Token B. Alle zukünftigen Conversions werden dann Token C zugeordnet.	Ein Conversion-Ereignis wird gesendet mit Token C und dem Wert 2 für merchant changed , da der Nutzer die Reservierung abgeschlossen hat und das neue Token das zuvor gespeicherte Token ersetzt hat.

Wenn Sie eine Plattform haben, auf der Nutzer bei einem anderen Händler bezahlen können, testen Sie Folgendes.

Wichtig: Wie im Abschnitt Wert für Händleränderung zurückgeben erwähnt, können Sie den Wert dieser Anfragen fest auf 2 codieren, wenn Ihre Reservierungs seiten oder Aktionslinks es Nutzern nicht ermöglichen, den Händler zu wechseln. Dies ist üblich für Partner, die ihre Reservierungsseiten in die Website ihres Händlers integrieren oder benutzerdefinierte Landingpages haben, um eine Reservierung zu verarbeiten. Wenn Sie einer dieser Partner sind, können Sie die folgenden Testfälle überspringen.

Testfall	Testbeschreibung	User Flow	Erwartetes Ergebnis
6	Ein Nutzer wird von Google auf Ihre Reservierungsseite weitergeleitet und schließt eine Reservierung bei einem anderen Händler ab.	Ein Nutzer wird von Google auf Ihre Reservierungsseite weitergeleitet, Token A wird verwendet, aber bevor er eine Reservierung abschließt, wechselt er zu einer anderen Seite und schließt die Reservierung bei einem anderen Händler ab als dem, der in der ursprünglichen Weiterleitung angegeben war.	Ein Conversion-Ereignis wird gesendet , da der Nutzer eine Reservierung abgeschlossen hat, die mit einer Weiterleitung von Google mit Token A begonnen hat, und der Wert für merchant changed ist 1 , da der Nutzer die Reservierung bei einem anderen Händler als dem der Weiterleitung abgeschlossen hat.

Senden Sie beim Testen 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

Test-Tokens

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

Token A :

rwg_token=AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg%3D%3D

Token B :

rwg_token=AE37R_gte8WCEaytMalsIr9agWQRLuN8199RsVhU2WoRKRvcZ0eBTD8cFvnfUZh-GY0IvY-zjS3W9KWAmy3WDiWXbVvQRZyzMQ%3D%3D

Token C :

rwg_token=AE37R_jmAP-UgWNApkxwdlX5M2z1UBGuUzHZ63YWmRWeTjRJKxfSD1mzJ4joLnB11MHrBULuisjP-9I64LnBJDXyCc_CIJSCPg%3D%3D

Wenn Sie die erfolgreichen Conversion-Ereignisse senden, können Sie sie im Action Center unter dem Conversion-Tracking-Dashboard aggregiert sehen.

**Hinweis**: Es kann bis zu einer Stunde dauern, bis Conversions im Dashboard angezeigt werden.

Anforderungen an die Conversion-Attribution

Der von Google geforderte Standard für die Conversion-Attribution ist ein 30-tägiger Attributionszeitraum für jede Interaktion mit einem Aktionslink für einen Ort in einem beliebigen Geschäft.

Dieser Attributionszeitraum bedeutet, dass Google in den folgenden Szenarien ein Conversion-Ereignis erwartet:

• Ein Nutzer folgt einem Link für ortsbezogene Aktion und gibt in derselben Sitzung eine Bestellung für denselben Händler auf. Wert für Händleränderung = 2.
• Ein Nutzer folgt einem Link für ortsbezogene Aktion und kehrt dann innerhalb des 30-tägigen Attributionszeitraums über einen anderen Kanal zurück, um eine Bestellung für denselben Händler aufzugeben. Wert für Händleränderung = 2.
• Ein Nutzer folgt einem Aktionslink für einen Ort und gibt dann entweder in derselben Sitzung oder in einer anderen Sitzung innerhalb eines 30-tägigen Attributionszeitraums eine Bestellung in einem anderen Geschäft auf. Wert für Händleränderung = 1.

Außerdem erwartet Google, Conversion-Ereignisse von jedem Gerät zu senden, auf das ein Nutzer über einen Link für ortsbezogene Aktion zugreifen kann. Dazu gehören:

• Webanwendungen für Computer oder Mobilgeräte.
• Mobile Apps, entweder über einen App-Deeplink oder einen registrierten App-Intent für Ihre Domain.

Wenn das Token auf Nutzerebene gespeichert wird, wird erwartet, dass Sie die geräteübergreifende Attribution bereitstellen. Weitere Informationen finden Sie unter Auf Nutzerebene speichern. In diesem Fall muss ein Nutzer, der einem Aktionslink auf dem Computer folgt und die Transaktion dann auf einem Mobilgerät mit demselben Nutzerkonto abschließt, ein Conversion-Ereignis auslösen.

Wenn das Token ausschließlich auf Geräteebene gespeichert wird, z. B. in Browser-Cookies, wird nicht erwartet, dass Sie die geräteübergreifende Attribution bereitstellen. In diesem Fall kann für jedes Gerät ein separates Token gespeichert werden, wenn der Nutzer auf diesem Gerät einem Aktionslink folgt. Für jedes Gerät können die Attributionsregeln separat angewendet werden.

Hinweis: Dieses Attributionsframework kann sich davon unterscheiden, wie Conversions in Ihrem Analysesystem zugeordnet werden. Dieses System ist so konzipiert, dass es unabhängig von jedem Conversion-Tracking in Ihren Systemen funktioniert und Ihre interne Analyse nicht beeinträchtigt.