Conversion-Tracking

Implementierung

Zusammenfassung

Die Implementierung des Conversion-Trackings besteht aus drei Teilen:

Erfassung der rwg_token über die Landingpage / den App-Einstiegspunkt.
rwg_token für den entsprechenden Attributionszeitraum beibehalten
Conversion-Ereignis an der Kasse senden

Für diese Conversion-Tracking-Implementierung müssen Sie weder Google Analytics noch JavaScript von Drittanbietern verwenden.

Bevor Sie mit der Implementierung des Conversion-Trackings beginnen, sollten Sie festlegen, ob Sie Conversions auf Geräte- oder Nutzerebene erfassen möchten:

Auf Geräteebene werden Browser-Cookies, lokaler Speicher, lokaler App-Speicher oder andere Methoden verwendet, mit denen das Token für den 30-tägigen Attributionszeitraum gespeichert werden kann. Da das Token lokal auf dem Gerät des Nutzers gespeichert wird, kann das Conversion-Ereignis möglicherweise nicht richtig zugeordnet werden, wenn der Nutzer das verwendete Gerät wechselt, seinen lokalen Speicher/seine Cookies löscht oder einen privaten Browsing- oder Inkognitomodus verwendet. Wenn Sie das Conversion-Tracking auf Geräteebene verwenden, müssen Sie es auf allen unterstützten Oberflächen (einschließlich Mobilgeräte) neu implementieren.
Die Nutzerebene umfasst das Speichern in der Datenbank Ihrer Anwendung über ein serverseitiges Analysesystem oder andere serverseitige Systeme. Da das Token serverseitig gespeichert wird, kann das Conversion-Ereignis weiterhin zugeordnet werden, wenn der Nutzer das verwendete Gerät wechselt, seinen lokalen Speicher bzw. seine Cookies löscht oder einen privaten Browsermodus bzw. den Inkognitomodus verwendet, sobald er sich wieder anmeldet. Wenn Sie das Conversion-Tracking auf Nutzerebene verwenden, können Sie es je nach Architektur Ihres Systems einmal serverseitig implementieren und auf allen unterstützten Oberflächen wiederverwenden.

`rwg_token` erheben

Jedes Mal, wenn Google eine von Ihnen über die Feeds bereitgestellte action_link präsentiert, 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. Sie speichern dieses Token und geben es als Teil des Conversion-Ereignisses zurück.

Auf jeder Landingpage bzw. jedem App-Einstiegspunkt müssen Sie den für den Abfrageparameter rwg_token festgelegten Wert parsen und speichern. Die Anforderungen für das Speichern dieses Parameters werden im Schritt rwg_token beibehalten beschrieben.

Ein Beispiel dafür, wie dieses Token für das Tracking auf Geräteebene über den Browser geparst werden kann, finden Sie unten. Alternativ können Sie dieses Token serverseitig erfassen, wenn Sie auf die Anfrage antworten:

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

`rwg_token` beibehalten

Hinweis:Das Speichern von rwg_token ist entscheidend für die korrekte Implementierung des erforderlichen Attributionszeitraums. Weitere Informationen zu den Attributionsanforderungen finden Sie unten im Abschnitt Anforderungen an die Conversion-Attribution.

Sie müssen den URL-Parameter rwg_token, der an alle von Ihnen bereitgestellten Aktionslinks angehängt wird, für insgesamt 30 Tage beibehalten. Der Wert von rwg_token sollte ohne Änderungen gespeichert und zurückgegeben werden. Wenn ein vorhandenes Token aus einem früheren Besuch gespeichert ist, sollte das alte Token ersetzt und der 30‑Tage-Zeitraum für die Speicherung zurückgesetzt werden.

Wenn Sie das Token beibehalten, können Sie es entweder auf Geräte- oder auf Nutzerebene speichern:

Auf Geräteebene werden Browser-Cookies, lokaler Speicher, lokaler App-Speicher oder andere Methoden verwendet, mit denen das Token für den 30-tägigen Attributionszeitraum beibehalten werden kann.
Die Nutzerebene umfasst das Speichern in Ihrer Anwendungsdatenbank über ein serverseitiges Analysesystem oder andere serverseitige Systeme.

Unten sehen Sie ein Beispiel für das Conversion-Tracking auf Geräteebene, bei dem dieses Token in einem Webbrowser über ein eigenes Cookie gespeichert wird. In diesem Beispiel wird davon ausgegangen, dass Sie den Tokenwert wie im Beispiel oben in eine Variable geparst haben. Wenn Sie dieses Beispiel verwenden möchten, müssen Sie „rootdomain“ durch Ihre Domain ersetzen.

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

Wenn Sie das Conversion-Tracking auf Nutzerebene verwenden, muss die rwg_token auf dem Server gespeichert und dem Nutzer zugeordnet werden.

Conversion-Daten senden

Wenn ein Nutzer eine Transaktion abschließt, die einem Google Place Action-Link zugeordnet ist, 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

Der Beitragstext sollte ein JSON-codiertes Objekt im folgenden Format sein:

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

Sowohl in der Sandbox- als auch in der Produktionsumgebung müssen Sie beim Senden eines Conversion-Ereignisses eine gültige rwg_token angeben. Für Testzwecke in der Sandbox-Umgebung können Sie das folgende Test-Token verwenden.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Hinweis:In der Produktion sollten Sie keine Conversion-Ereignisse senden, die nicht dieser Integration zugeordnet sind. Prüfen Sie vor dem Senden des Ereignisses, ob ein gültiger und nicht abgelaufener rwg_token-Wert vorhanden ist.

Ein vollständiges Beispiel für das Conversion-Tracking auf Geräteebene (mit einem Cookie auf dem Gerät des Nutzers) in JavaScript, wie diese POST-Anfrage gestellt wird, finden Sie unten:

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

Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, sollten Sie das Token, das dem Nutzer zugeordnet ist (unabhängig von der Oberfläche, auf der er sich befindet), aus Ihrem serverseitigen Speichermechanismus abrufen und das Token über dieselben Produktions- oder Sandbox-Endpunkte senden.

Hinweis:Conversion-Ereignisse können von einem Web- oder App-Client oder vom Server gesendet werden. Sie können diese Entscheidung entsprechend Ihren Anforderungen und dem Speicherort des Tokens treffen, sofern ein Conversion-Ereignis genau einmal pro Conversion gesendet wird und einen gültigen rwg_token-Wert enthält.

Anforderungen an die Conversion-Attribution

Der von Google geforderte Standard für die Conversion-Zuordnung ist ein 30-Tage-Tracking-Zeitraum für jede Interaktion mit einem Ortslink in einem beliebigen Geschäft.

Das bedeutet, dass ein Conversion-Ereignis in den folgenden Fällen gesendet werden sollte:

Ein Nutzer folgt einem Link für eine Ortsaktion und gibt in derselben Sitzung eine Bestellung auf.
Ein Nutzer folgt einem Link für Ortsaktionen und kehrt dann innerhalb des 30-Tage-Zeitraums über einen anderen Kanal zurück, um eine Bestellung aufzugeben.
Ein Nutzer folgt einem Link für eine Ortsaktion und gibt dann in einem anderen Geschäft eine Bestellung auf, entweder in derselben Sitzung oder in einer anderen Sitzung innerhalb von 30 Tagen.

Außerdem erwarten wir, dass Conversion-Ereignisse von allen Oberflächen gesendet werden, auf denen ein Nutzer über einen Link für ortsbezogene Aktionen landen kann. Einschließlich:

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

Wenn das Token auf Nutzerebene gespeichert wird (siehe Token beibehalten), wird erwartet, dass Sie die geräteübergreifende Zuordnung bereitstellen. Wenn ein Nutzer beispielsweise einem Aktionslink auf dem Computer folgt und die Transaktion dann auf einem Mobilgerät (mit demselben Nutzerkonto) abschließt, sollte ein Conversion-Ereignis ausgelöst werden.

Wenn das Token ausschließlich auf Geräteebene gespeichert wird, z. B. in Browser-Cookies, müssen Sie keine geräteübergreifende Zuordnung vornehmen. In diesem Fall hätte jedes Gerät ein separates Token, das gespeichert wird, wenn der Nutzer auf diesem Gerät einem Aktionslink gefolgt ist. Außerdem würde jedes Gerät den Attributionsregeln separat folgen.