Conversion-Tracking

Implementierung

Zusammenfassung

Eine Conversion-Tracking-Implementierung besteht aus drei Teilen:

  • rwg_token und merchant_id von der Landingpage / App-Einstiegspunkt erfassen
  • rwg_token und merchant_id für das entsprechende Attributionsfenster beibehalten.
  • Vergleichen Sie die beibehaltenen merchant_id und merchant_id zum Zeitpunkt der Conversion (Buchung abgeschlossen).
  • Zum Zeitpunkt der Conversion wird ein Conversion-Ereignis gesendet (Buchung abgeschlossen).

Für die Implementierung des Conversion-Trackings müssen Sie weder Google Analytics noch JavaScript-Code 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:

  • Auf Geräteebene ist die Verwendung von Browsercookies, des lokalen Speichers, des lokalen Speichers von Anwendungen oder jeder anderen Methode möglich, mit der das Token für ein 30-tägiges Attributionsfenster beibehalten 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 ändert, seinen lokalen Speicher oder seine Cookies löscht oder den Modus für privates Surfen oder den Inkognitomodus verwendet. Wenn Sie das Conversion-Tracking auf Geräteebene verwenden, müssen Sie dies für jede unterstützte Oberfläche (einschließlich Mobilgeräte) neu implementieren.
  • Zur Nutzerebene gehört die Speicherung in der Anwendungsdatenbank, über ein serverseitiges Analysesystem oder andere serverseitige Systeme. Da das Token serverseitig gespeichert werden würde, wird das Conversion-Ereignis auch nach der erneuten Anmeldung des Nutzers zugeordnet, wenn der Nutzer das verwendete Gerät ändert, seinen lokalen Speicher oder seine Cookies löscht oder ein privates Surfen oder einen Inkognitomodus verwendet. Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, können Sie es je nach Systemarchitektur möglicherweise einmal auf der Serverseite implementieren und auf allen unterstützten Oberflächen wiederverwenden.

rwg_token wird erfasst...

Jedes Mal, wenn Google einen von Ihnen über die Feeds bereitgestellten action_link anzeigt, 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, aber keine Nutzerdaten. Sie sollten dieses Token speichern und als Teil des Conversion-Ereignisses zurückgeben.

Auf jedem Landingpage-/App-Einstiegspunkt musst du den für den Abfrageparameter rwg_token festgelegten Wert parsen und speichern. Die Anforderungen zum Speichern dieses Parameters werden im Schritt rwg_token beibehalten.

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:

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

merchant_id wird erfasst...

Wenn Sie die Conversion-Tracking-Logik im Front-End und auf der Landingpage implementieren, müssen Sie ein benutzerdefiniertes Skript implementieren, das die merchant_id findet und erfasst. Normalerweise ist merchant_id möglicherweise bereits auf der Landingpage oder in der URL vorhanden, sodass Sie es dort erfassen können. Wenn nicht, müssen Sie eine Möglichkeit finden, sie irgendwo verfügbar zu machen, damit sie erfasst werden kann, was wahrscheinlich Back-End-Änderungen bedeuten würde.

Wenn Sie die Conversion-Tracking-Logik im Backend implementieren, finden Sie möglicherweise das merchant_id neben den Daten, die Ihr internes System abfragen, um die Frontend-Seite zu generieren.

Dieser merchant_id muss mit der Angabe übereinstimmen, die Sie in Ihrem Feed für Google freigegeben haben.

rwg_token und merchant_id 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 gespeichert und ohne Änderungen zurückgegeben werden.

Neben dem rwg_token musst du das mit dem Aktionslink verknüpfte merchant_id speichern.

Wenn ein Token von einem vorherigen Besuch beibehalten wurde, sollten die früheren Werte rwg_token und merchant_id ersetzt und das 30-Tage-Fenster für den Speicher zurückgesetzt werden.

Wenn Sie das obige Paar dauerhaft speichern, können Sie die Werte entweder auf Geräte- oder Nutzerebene speichern:

  • Auf Geräteebene ist die Verwendung von Browsercookies, des lokalen Speichers, des lokalen Speichers von Anwendungen oder jeder anderen Methode möglich, mit der das Token für ein 30-tägiges Attributionsfenster beibehalten werden kann.
  • Zur Nutzerebene gehört die Speicherung in der Anwendungsdatenbank, über ein serverseitiges Analysesystem oder andere serverseitige Systeme.

Unten sehen Sie ein Beispiel für Conversion-Tracking auf Geräteebene, bei dem diese Werte mithilfe eines eigenen Cookies in einem Webbrowser gespeichert werden. 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.com auf Ihre Domain aktualisieren.

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

Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, sollten rwg_token und merchant_id 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 Post-Text sollte ein JSON-codiertes Objekt im folgenden Format sein:

{
  "conversion_partner_id": <partnerId>,
  "rwg_token": <rwg_token_val>,
  "merchant_changed": 1|2
}

Beispiel (unveränderter Händler mit dem Testtoken für Partner 20123456):

{
  "conversion_partner_id": 20123456,
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ",
  "merchant_changed": 2
}

Mit dem Wert „merchant_changed“ wird festgestellt, ob der Händler vom ursprünglichen Weiterleitungshändler geändert wurde. Es gibt zwei Werte, die übergeben werden können

Händlerwert ändern Anforderung
1 Dieser Wert sollte verwendet werden, wenn ein Nutzer die ursprüngliche Händlerwebsite verlassen und einen Kauf über deine Plattform bei einem anderen Händler abgeschlossen hat.
2 Dieser Wert sollte verwendet werden, wenn der Kunde eine Transaktion über die ursprüngliche Entität (Händler) abschließt.

Sowohl in der Sandbox- als auch in der Produktionsumgebung musst du beim Senden eines Conversion-Ereignisses eine gültige rwg_token angeben. Verwenden Sie zu Testzwecken bis zur Markteinführung das folgende Testtoken in beiden Umgebungen:

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Im Folgenden finden Sie ein Beispiel für Conversion-Tracking auf Geräteebene in JavaScript mit einem Cookie auf dem Gerät des Nutzers, das zeigt, wie die Anforderung zum Hochladen 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,
      merchant_changed: merchantChanged
    })
  });
}

Wenn du Conversion-Tracking auf Nutzerebene verwendest, solltest du das Token, das dem Nutzer zugeordnet ist, unabhängig von der Oberfläche, auf der er sich befindet, aus deinem serverseitigen Speichermechanismus abrufen und das Token mit denselben Produktions- oder Sandbox-Endpunkten senden.

Anforderungen an die Conversion-Zuordnung

Der erforderliche Standard für die Conversion-Attribution ist ein 30-tägiger Attributionszeitraum für jede Interaktion mit einem Link zu einem Ort in einem Geschäft.

Dieser Attributionszeitraum bedeutet, dass Google in einem der folgenden Szenarien davon ausgeht, dass ein Conversion-Ereignis gesendet wird:

  • Ein Nutzer folgt einem Place Action-Link und gibt in derselben Sitzung eine Bestellung für denselben Händler auf. (Händleränderungswert = 2 )
  • Ein Nutzer folgt einem Place Action-Link und kehrt innerhalb von 30 Tagen von einem anderen Kanal zurück, um eine Bestellung bei demselben Händler aufzugeben. (Händleränderungswert = 2)
  • Ein Nutzer folgt einem Place Action-Link und gibt dann eine Bestellung in einem anderen Geschäft auf – entweder innerhalb derselben Sitzung oder innerhalb einer anderen Sitzung innerhalb eines 30-Tage-Fensters. ( Händleränderungswert = 1 )

Außerdem gehen wir davon aus, dass Conversion-Ereignisse von allen Oberflächen gesendet werden, die Nutzer über einen Link zu einer ortsbezogenen Aktion aufrufen können. Einschließlich:

  • Webanwendungen für Computer oder mobile 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 beibehalten“), sollten Sie eine geräteübergreifende Attribution bereitstellen. Das heißt, wenn ein Nutzer, der auf dem Computer einem Aktionslink folgt und dann die Transaktion auf einem Mobilgerät ausführt (über dasselbe Nutzerkonto), sollte ein Conversion-Ereignis ausgelöst werden.

Wenn das Token ausschließlich auf Geräteebene gespeichert wird, z. B. in Browsercookies, ist nicht zu erwarten, dass Sie eine geräteübergreifende Attribution bereitstellen. In diesem Fall würde für jedes Gerät ein separates Token beibehalten, wenn der Nutzer einem Aktionslink auf diesem Gerät gefolgt wäre, und jedes Gerät würde den Attributionsregeln separat folgen.