Conversion-Tracking

Implementierung

Zusammenfassung

Die Conversion-Tracking-Implementierung besteht aus drei Teilen:

  1. Erfassen Sie die rwg_token auf der Landingpage bzw. dem App-Einstiegspunkt.
  2. rwg_token für das entsprechende Attributionszeitraum beibehalten
  3. Senden eines Conversion-Ereignisses an der Kasse

Für die Implementierung des Conversion-Trackings ist weder Google Analytics noch JavaScript-Code von Drittanbietern erforderlich.

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

  • Auf Geräteebene können Browsercookies, lokaler Speicher, lokaler App-Speicher oder eine andere Methode verwendet werden, mit der das Token für die Dauer von 30 Tagen 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/Cookies löscht oder den Modus zum privaten Surfen oder Inkognitomodus verwendet. Wenn Sie das Conversion-Tracking auf Geräteebene verwenden, müssen Sie es auf jeder unterstützten Plattform (auch auf Mobilgeräten) neu implementieren.
  • Die Nutzerebene umfasst die Aufbewahrung in der Anwendungsdatenbank, über ein serverseitiges Analysesystem oder über andere serverseitige Systeme. Da das Token serverseitig gespeichert wird, wird das Conversion-Ereignis auch dann zugeordnet, wenn der Nutzer das verwendete Gerät wechselt, den lokalen Speicher/Cookies löscht oder den Modus zum privaten Surfen oder den Inkognitomodus verwendet, sobald sich der Nutzer wieder anmeldet. Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, können Sie es je nach Systemarchitektur einmal serverseitig implementieren und für alle unterstützten Oberflächen wiederverwenden.

rwg_token wird erfasst

Jedes Mal, wenn Google eine action_link anzeigt, die du über die Feeds bereitgestellt 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 / App-Einstiegspunkt muss der Wert, der für den Abfrageparameter rwg_token festgelegt wurde, geparst und gespeichert werden. 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

Der URL-Parameter rwg_token wird insgesamt 30 Tage lang an alle von Ihnen bereitgestellten Aktionslinks angehängt. Der Wert von rwg_token sollte ohne Änderungen gespeichert und zurückgegeben werden. Wenn ein vorhandenes Token von einem vorherigen Besuch beibehalten wird, sollte das alte Token ersetzt und das 30-Tage-Zeitfenster für die Speicherung zurückgesetzt werden.

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

  • Auf Geräteebene können Browsercookies, lokaler Speicher, lokaler App-Speicher oder eine andere Methode verwendet werden, mit der das Token für den Attributionszeitraum von 30 Tagen beibehalten werden kann.
  • Die Nutzerebene umfasst die Aufbewahrung in der Anwendungsdatenbank, entweder über ein serverseitiges Analysesystem oder über andere serverseitige Systeme.

Im Folgenden finden Sie ein Beispiel für 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 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 Link für eine Google Place Action-Aktion 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 eine gültige 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 Conversion-Tracking auf Geräteebene (mithilfe eines Cookies auf dem Gerät des Nutzers) in JavaScript, das zeigt, wie diese Anfrage gesendet 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 das Conversion-Tracking auf Nutzerebene verwenden, sollten Sie das mit dem Nutzer verknüpfte Token (unabhängig von der Oberfläche, auf der er sich befindet) von Ihrem serverseitigen Speichermechanismus abrufen und das Token über dieselben Produktions- oder Sandbox-Endpunkte senden.

Anforderungen für die Conversion-Zuordnung

Der erforderliche Standard für die Conversion-Attribution von Google ist ein 30-tägiger Attributionszeitraum für jede Interaktion mit einem Place Link in jedem 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 ortsbezogene Aktionen und gibt in derselben Sitzung eine Bestellung auf.
  • Ein Nutzer folgt einem „Place Action“-Link und kehrt innerhalb von 30 Tagen von einem anderen Kanal zurück, um eine Bestellung aufzugeben.
  • Ein Nutzer folgt einem „Place Action“-Link 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 Web-Apps
  • 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 speichern), müssen Sie eine geräteübergreifende Attribution bereitstellen. 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 für jedes Gerät ein separates Token gespeichert, wenn der Nutzer auf diesem Gerät einem Aktionslink gefolgt wäre. Jedes Gerät würde die Attributionsregeln separat befolgen.