Schritt 3: Conversion-Tracking

Implementierung

Zusammenfassung

Eine Conversion-Tracking-Implementierung besteht aus drei Teilen:

  1. Die rwg_token auf der Landingpage bzw. dem App-Einstiegspunkt erfassen.
  2. rwg_token für den entsprechenden Attributionszeitraum beibehalten
  3. Senden eines Conversion-Ereignisses an der Kasse

Für die Implementierung des Conversion-Trackings ist es nicht erforderlich, Google Analytics oder anderen JavaScript-Code von Drittanbietern zu verwenden.

Bevor Sie das Conversion-Tracking implementieren, sollten Sie sich entscheiden, ob Sie Conversions auf Geräte- oder Nutzerebene erfassen möchten:

  • Die Geräteebene umfasst die Verwendung von Browsercookies, lokalem Speicher, lokalem App-Speicher oder einer anderen Methode, mit der das Token für 30 Tage lang gespeichert werden kann. Da das Token lokal auf dem Gerät des Nutzers gespeichert wird, wird das Conversion-Ereignis möglicherweise nicht korrekt zugeordnet, wenn der Nutzer das verwendete Gerät wechselt, den lokalen Speicher und die Cookies löscht oder den Modus zum privaten Surfen oder den Inkognitomodus verwendet. Wenn Sie das Conversion-Tracking auf Geräteebene verwenden, müssen Sie es auf jeder unterstützten Plattform (auch auf Mobilgeräten) noch einmal implementieren.
  • Zur Nutzerebene gehört auch, dass der Bericht in der Anwendungsdatenbank, über ein serverseitiges Analysesystem oder über andere serverseitige Systeme gespeichert wird. Da das Token serverseitig gespeichert wird, wird das Conversion-Ereignis auch dann zugeordnet, wenn der Nutzer das verwendete Gerät wechselt, den lokalen Speicher und die Cookies löscht bzw. den Modus zum privaten Surfen bzw. Inkognitomodus verwendet. Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, können Sie es je nach Systemarchitektur einmal auf Ihrer Serverseite implementieren und dann für alle unterstützten Oberflächen wiederverwenden.

rwg_token sammeln

Jedes Mal, wenn Google eine action_link anzeigt, die du über Feeds angegeben hast, 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 zu dem 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 rwg_token-Abfrageparameter festgelegten Wert parsen und speichern. Die Anforderungen zum Speichern dieses Parameters werden im Schritt rwg_token beibehalten beschrieben.

Unten sehen Sie ein Beispiel dafür, wie dieses Token für das Tracking auf Geräteebene über den Browser geparst werden kann. 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

Sie müssen den URL-Parameter rwg_token, der an alle von Ihnen bereitgestellten Aktionslinks angehängt wird, für eine Gesamtdauer von 30 Tagen beibehalten. Der Wert von rwg_token sollte ohne Änderungen gespeichert und zurückgegeben werden. Wenn ein vorhandenes Token von einem vorherigen Besuch beibehalten wurde, sollte das alte Token ersetzt und das 30‐tägige Speicherfenster zurückgesetzt werden.

Beim Speichern des Tokens können Sie es entweder auf Geräte- oder auf Nutzerebene speichern:

  • Die Geräteebene umfasst die Verwendung von Browser-Cookies, lokalem Speicher, lokalem App-Speicher oder einer anderen Methode, mit der das Token für 30 Tage lang gespeichert werden kann.
  • Die Nutzerebene beinhaltet, dass der Bericht in Ihrer Anwendungsdatenbank, über ein serverseitiges Analysesystem oder über andere serverseitige Systeme gespeichert wird.

Unten sehen Sie ein Beispiel für 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 obigen Beispiel in eine Variable geparst haben. Wenn Sie dieses Beispiel verwenden möchten, müssen Sie „rootdomain“ auf Ihre Domain aktualisieren. 

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

Wird das Conversion-Tracking auf Nutzerebene verwendet, sollte die rwg_token auf dem Server gespeichert und dem Nutzer zugeordnet werden.

Senden von Conversion-Daten

Wenn ein Nutzer eine Transaktion abschließt, 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 Post-Text 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 musst du einen gültigen rwg_token angeben, wenn ein Conversion-Ereignis gesendet wird. Zu Testzwecken in der Sandbox-Umgebung kannst du das folgende Testtoken verwenden. 

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

Ein vollständiges Beispiel für das Conversion-Tracking auf Geräteebene (Verwendung eines Cookies auf dem Gerät des Nutzers) in JavaScript zeigt, wie eine Übermittlungsanfrage gestellt 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 mit dem Nutzer verknüpft ist (unabhängig von der Oberfläche, auf der er sich befindet) von Ihrem serverseitigen Speichermechanismus abrufen und das Token mit denselben Produktions- oder Sandbox-Endpunkten senden.

Anforderungen für die Conversion-Attribution

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

Dieser Attributionszeitraum bedeutet, dass in den folgenden Szenarien davon auszugehen ist, dass ein Conversion-Ereignis gesendet wird:

  • Ein Nutzer folgt einem Link für eine ortsbezogene Aktion und gibt in derselben Sitzung eine Bestellung auf.
  • Ein Nutzer folgt einem „Place Action“-Link und kehrt dann innerhalb von 30 Tagen von einem anderen Kanal zurück, um eine Bestellung aufzugeben.
  • Ein Nutzer folgt einem Link für ortsbezogene Aktionen und gibt dann innerhalb einer Sitzung oder einer anderen Sitzung innerhalb von 30 Tagen eine Bestellung in einem anderen Geschäft auf.

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

  • Desktop- oder mobile Webanwendungen
  • Mobile Apps, entweder über einen App-Deeplink oder einen registrierten App-Intent für Ihre Domain

Wenn das Token auf Nutzerebene gespeichert wird (siehe Token beibehalten), muss die geräteübergreifende Attribution erfolgen. Ein Conversion-Ereignis sollte also ein Conversion-Ereignis auslösen, wenn ein Nutzer auf dem Computer einem Aktionslink folgt und die Transaktion dann auf einem Mobilgerät mit demselben Nutzerkonto abschließt.

Wenn das Token ausschließlich auf Geräteebene gespeichert wird, z. B. in Browsercookies, ist keine geräteübergreifende Attribution zu erwarten. In diesem Fall würde auf jedem Gerät ein separates Token bestehen bleiben, wenn der Nutzer auf diesem Gerät einem Aktionslink gefolgt wäre. Jedes Gerät würde die Attributionsregeln separat befolgen.

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