Conversion-Tracking

Implementierung

Zusammenfassung

Eine Conversion-Tracking-Implementierung besteht aus drei Teilen:

  1. rwg_token wird vom Einstiegspunkt der Landingpage / App abgerufen.
  2. Dauerhaft rwg_token für das entsprechende Attributionsfenster beibehalten
  3. An der Kasse ein Conversion-Ereignis senden

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

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 Browsercookies, lokalem Speicher, lokalem App-Speicher oder einer anderen Methode, die das Token für das 30-tägige Attributionsfenster beibehalten 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 ändert, den lokalen Speicher oder die Cookies löscht oder einen privaten Browser- oder Inkognitomodus verwendet. Wenn Sie das Conversion-Tracking auf Geräteebene verwenden, müssen Sie es auf allen unterstützten Plattformen (einschließlich Mobilgeräten) neu implementieren.
  • Die Nutzerebene umfasst die dauerhafte Speicherung in der Anwendungsdatenbank über ein serverseitiges Analysesystem oder andere serverseitige Systeme. Da das Token serverseitig gespeichert wird, wird das Conversion-Ereignis auch dann zugeordnet, wenn sich der Nutzer wieder anmeldet, wenn der Nutzer das verwendete Gerät ändert, den lokalen Speicher oder die Cookies löscht oder einen privaten Browser oder Inkognitomodus verwendet. Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, können Sie dies je nach Systemarchitektur möglicherweise einmal serverseitig implementieren und auf allen unterstützten Oberflächen verwenden.

Der rwg_token wird eingeholt

Jedes Mal, wenn Google eine action_link aus den Feeds anzeigt, wird diese URL so geändert, dass sie einen eindeutigen Abfrageparameter 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.

Für jede Landingpage/jedes App-Einstiegspunkts muss der für den Abfrageparameter rwg_token festgelegte Wert 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

Du musst den URL-Parameter rwg_token beibehalten, der 30 Tage lang an alle von dir bereitgestellten Aktionslinks angehängt wird. Der Wert von rwg_token sollte ohne Änderungen gespeichert und zurückgegeben werden. Wenn bei einem vorherigen Besuch ein bestehendes Token beibehalten wurde, sollte das alte Token ersetzt und das 30-tägige Speicherlimit zurückgesetzt werden.

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

  • Die Geräteebene umfasst die Verwendung von Browsercookies, lokalem Speicher, lokalem App-Speicher oder jeder anderen Methode, die das Token für das 30-tägige Attributionsfenster beibehalten kann.
  • Die Nutzerebene umfasst die dauerhafte Speicherung in der Anwendungsdatenbank über ein serverseitiges Analysesystem oder andere serverseitige Systeme.

Unten sehen Sie ein Beispiel für das Conversion-Tracking auf Geräteebene. Dabei wird dieses Token mithilfe eines eigenen Cookies in einem Webbrowser gespeichert. 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“ auf Ihre Domain aktualisieren. 

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

Bei Verwendung von Conversion-Tracking auf Nutzerebene sollte 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 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 Beitragstext 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 musst du beim Senden eines Conversion-Ereignisses ein gültiges rwg_token angeben. Für Testzwecke in der Sandbox-Umgebung können Sie das folgende Testtoken verwenden. 

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

Im Folgenden finden Sie ein vollständiges Beispiel für Conversion-Tracking auf Geräteebene mit einem Cookie auf dem Gerät des Nutzers in JavaScript, das zeigt, wie Sie diese nach der Anfrage stellen. 

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 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 mit denselben Produktions- oder Sandbox-Endpunkten senden.

Anforderungen an die Attribution von Conversions

Der von Google geforderte Standard für die Conversion-Attribution ist ein 30-tägiger Attributionszeitraum für jede Interaktion mit einer Place Link-Verknüpfung in einem beliebigen Geschäft.

Das bedeutet, dass in den folgenden Fällen 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 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 eine Bestellung in einem anderen Geschäft auf, entweder innerhalb derselben oder einer anderen Sitzung innerhalb von 30 Tagen.

Außerdem sollten 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 über 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 Attribution verwenden. Das heißt, wenn ein Nutzer auf dem Computer einem Aktionslink folgt und dann die Transaktion auf einem Mobilgerät mit demselben Nutzerkonto ausführt, sollte er ein Conversion-Ereignis auslösen.

Wenn das Token ausschließlich auf Geräteebene gespeichert wird, z. B. in Browser-Cookies, ist keine geräteübergreifende Attribution zu erwarten. In diesem Fall wird für jedes Gerät ein separates Token beibehalten, wenn der Nutzer auf diesem Gerät einem Aktionslink gefolgt ist, und für jedes Gerät werden die Attributionsregeln separat angewendet.