Schritt 3: Conversion-Tracking

Implementierung

Zusammenfassung

Die Implementierung von Conversion-Tracking umfasst drei Schritte:

  1. rwg_token wird über den Einstiegspunkt der Landingpage oder App erfasst.
  2. rwg_token für den entsprechenden Attributionszeitraum speichern
  3. 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 entscheiden, ob Sie Conversions auf Geräte- oder Nutzerebene erfassen möchten:

  • 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 gespeichert 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.
  • Auf Nutzerebene werden die Daten in der 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 möglicherweise einmal auf Ihrer Serverseite implementieren und für alle unterstützten Oberflächen wiederverwenden.

rwg_token erfassen

Jedes Mal, wenn Google eine action_link anzeigt, die Sie über die Feeds angegeben haben, wird diese URL so geändert, dass sie einen eindeutigen Suchparameter enthält: rwg_token. Der Wert rwg_token ist ein codierter String, der 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 und jedem App-Einstiegspunkt müssen Sie den für den Abfrageparameter rwg_token festgelegten Wert analysieren und speichern. Die Anforderungen zum Speichern dieses Parameters werden im Schritt rwg_token speichern beschrieben.

Unten finden Sie ein Beispiel dafür, wie dieses Token für das Tracking auf Geräteebene über den Browser geparst werden kann. Alternativ kannst du dieses Token auf Serverseite erfassen, wenn du auf die Anfrage antwortest: 

<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

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 Token aus einem vorherigen Besuch vorhanden ist, sollte das alte Token ersetzt und der Speicherzeitraum von 30 Tagen zurückgesetzt werden.

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

  • 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 gespeichert 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 über ein eigenes Cookie in einem Webbrowser 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 Conversion-Tracking auf Nutzerebene verwenden, sollte die rwg_token auf dem Server gespeichert und dem Nutzer zugeordnet werden.

Conversion-Daten senden

Wenn ein Nutzer eine Transaktion ausführt, die einem Google Place Action-Link zugeordnet werden kann, 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 Inhalt der Nachricht muss 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 ein gültiges rwg_token angeben. Für Tests in der Sandbox-Umgebung können Sie das folgende Testtoken verwenden. 

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Unten finden Sie 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 gesendet wird: 

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.

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 Ortslink in einem Geschäft.

In diesem Attributionsfenster wird ein Conversion-Ereignis in einem der folgenden Szenarien gesendet:

  • Ein Nutzer folgt einem Link zu einer Aktion für einen Ort und gibt in derselben Sitzung eine Bestellung auf.
  • Ein Nutzer folgt einem Link zu einer Place Action und kehrt innerhalb von 30 Tagen über einen anderen Kanal zurück, um eine Bestellung aufzugeben.
  • Ein Nutzer folgt einem Link zu einer Aktion für einen Ort und gibt dann in einem anderen Geschäft eine Bestellung auf, entweder innerhalb derselben Sitzung oder in einer anderen Sitzung innerhalb eines Zeitraums von 30 Tagen.

Außerdem erwarten wir, dass Conversion-Ereignisse von allen Oberflächen gesendet werden, auf die Nutzer über einen Link für ortsbezogene Aktionen gelangen. 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 dauerhaft speichern), müssen Sie geräteübergreifende Attributionen bereitstellen. Wenn ein Nutzer also auf einem Computer auf einen Aktionslink klickt 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, 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 einem Aktionslink gefolgt ist. Für jedes Gerät gelten dann die Attributionsregeln separat.

Zurück
Schritt 2: Feeds
Weiter
Schritt 4: Pilotprojekt und Einführung