Diese Seite wurde von der Cloud Translation API übersetzt.

Conversion-Tracking

Implementierung

Zusammenfassung

Eine Conversion-Tracking-Implementierung besteht aus drei Teilen:

rwg_token und merchant_id von der Landingpage / App erfassen Einstiegspunkts hinzufügen.
rwg_token und merchant_id für die entsprechende Attribution beibehalten .
Dauerhafte(s) merchant_id und merchant_id zum Zeitpunkt der Conversion vergleichen (Buchung abgeschlossen).
Zum Zeitpunkt der Conversion wird ein Conversion-Ereignis gesendet (Buchung abgeschlossen).

Für diese Conversion-Tracking-Implementierung müssen Sie oder JavaScript von Drittanbietern verwenden.

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

Die Geräteebene umfasst die Nutzung von Browsercookies, lokalem Speicher, lokaler Apps oder eine andere Methode verwenden, mit der das Token 30 Tage lang aufbewahrt werden kann. Attributionszeitraum. Da das Token lokal auf dem Wenn der Nutzer sein Gerät ändert, werden die lokalen oder Cookies oder den Modus für privates Surfen bzw. den Inkognitomodus verwendet, wird das Conversion-Ereignis möglicherweise nicht richtig zugeordnet. Bei Verwendung des Geräteniveaus Conversion-Tracking einrichten, müssen Sie dies für alle unterstützten (auch für Mobilgeräte) genutzt werden.
Zur Nutzerebene gehört die Speicherung in der Anwendungsdatenbank, durch ein serverseitiges Analysesystem oder andere serverseitige Systeme. Da die wird auf der Serverseite gespeichert, wenn der Nutzer verwendet, löscht den lokalen Speicher oder Cookies oder verwendet ein privates wird das Conversion-Ereignis dennoch einmal als meldet sich der Nutzer wieder an. Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, können Sie dies möglicherweise einmal und auf allen unterstützten Plattformen verwenden können.

`rwg_token` wird erfasst...

Jedes Mal, wenn Google einen action_link anzeigt, den Sie über die Feeds bereitgestellt haben, wird diese URL so geändert, dass sie einen eindeutigen Suchparameter enthält: rwg_token. Die Der Wert rwg_token ist ein codierter String, der einige Metadaten zum Link, 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 muss der für die rwg_token-Abfrageparameter hinzu und speichern Sie ihn. Voraussetzungen für die Speicherung werden im Schritt rwg_token beibehalten.

Ein Beispiel dafür, wie dieses Token für das Tracking auf Geräteebene geparst werden kann: ist der Browser unten enthalten. Alternativ können Sie dieses Token auf die Serverseite senden:

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 Frontend implementieren, wird auf der Landingpage müssen Sie ein benutzerdefiniertes Skript implementieren, das die merchant_id Normalerweise ist merchant_id möglicherweise bereits im Landingpage oder in der URL enthalten, damit Sie sie dort erfassen können. Falls nicht, müssen Sie an einem Ort befestigen, damit es abgefangen werden kann. Änderungen im Back-End.

Wenn Sie die Conversion-Tracking-Logik im Back-End implementieren, finden Sie möglicherweise die merchant_id zusammen mit den Daten, die Ihr internes System abfragen, um der Front-End-Seite.

Dieses Feld (merchant_id) muss mit dem identisch sein, den Sie in diesem Dokument für Google freigegeben haben in Ihrem Feed.

`rwg_token` und `merchant_id` beibehalten

Sie müssen den URL-Parameter rwg_token beibehalten, der an alle von Ihnen bereitgestellten Aktionslinks angehängt wird (Gesamtdauer von 30 Tagen). Der Wert von rwg_token sollte gespeichert und ohne Änderungen zurückgegeben werden.

Zusammen mit rwg_token musst du die verknüpften merchant_id speichern. mit dem Aktionslink.

Wenn ein Token von einem vorherigen Besuch beibehalten wurde, gilt: rwg_token und merchant_id sollten ersetzt werden und das 30-Tage-Fenster für sollte zurückgesetzt werden.

Wenn Sie das obige Paar beibehalten, können Sie die Werte entweder auf dem Gerät speichern oder auf Nutzerebene:

Die Geräteebene umfasst die Nutzung von Browsercookies, lokalem Speicher, lokaler Apps oder eine andere Methode verwenden, mit der das Token 30 Tage lang aufbewahrt werden kann. Attributionszeitraum.
Zur Nutzerebene gehört die Speicherung in der Anwendungsdatenbank, durch ein serverseitiges Analysesystem oder andere serverseitige Systeme.

Unten sehen Sie ein Beispiel für Conversion-Tracking auf Geräteebene. in einem Webbrowser mit einem Erstanbieter-Cookie. In diesem Beispiel wird davon ausgegangen, dass Sie das Tokenwert in eine Variable umwandeln, wie im Beispiel oben. Um dieses Beispiel zu verwenden, 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 abschließt, die einem Google Places-Konto zugeordnet werden kann Aktionslink 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 den 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 geändert wurde vom ursprünglichen Weiterleitungs-Händler. 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 aufgerufen und einen Kauf abgeschlossen bei einem anderen Händler über Ihre Plattform
2	Dieser Wert sollte verwendet werden, wenn der Kunde hat eine Transaktion über die ursprüngliche Entität abgeschlossen (Händler).

Sowohl in der Sandbox- als auch in der Produktionsumgebung müssen Sie ein gültigen rwg_token, wenn ein Conversion-Ereignis gesendet wird. Verwenden Sie zu Testzwecken die Methode folgendes Testtoken in beiden Umgebungen bis zur Markteinführung:

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Zum Testen in Sandbox müssen Sie den folgenden URL-Parameter manuell an Ihre Sandbox-Links:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Ein vollständiges Beispiel für das Conversion-Tracking auf Geräteebene (Verwendung eines Cookies auf der Gerät) in JavaScript, das die Vorgehensweise für diese POST-Anfrage zeigt:

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 Sie Conversion-Tracking auf Nutzerebene verwenden, sollten Sie das Token abrufen, das unabhängig von der Oberfläche, auf der sie sich befinden, des serverseitigen Speichermechanismus und Senden des Tokens mit demselben Produktions- oder Sandbox-Endpunkte.

Anforderungen an die Conversion-Zuordnung

Der erforderliche Standard für die Conversion-Attribution ist eine 30-tägige Attribution. für alle Interaktionen mit dem Link eines Ortes in einem Geschäft.

Dieser Attributionszeitraum bedeutet, dass Google in einem der folgenden Szenarien gesendet:

Ein Nutzer folgt einem Place Action-Link und gibt eine Bestellung für denselben Händler auf. in derselben Sitzung. (Händleränderungswert = 2 )
Ein Nutzer folgt einem Place Action-Link und kehrt dann von einem anderen Kanal zurück. innerhalb von 30 Tagen eine Bestellung bei demselben Händler aufgeben können. (Händler) Wert ändern = 2 )
Ein Nutzer folgt einem Place Action-Link und gibt dann eine Bestellung in einem anderen entweder innerhalb derselben Sitzung oder in einer anderen Sitzung innerhalb von 30 Tagen . ( Händleränderungswert = 1 )

Google geht außerdem davon aus, dass Conversion-Ereignisse von allen Oberflächen über einen Place Action-Link weitergeleitet werden können. Einschließlich:

Webanwendungen für Computer oder mobile Apps
Mobile Apps, entweder über einen App-Deeplink oder eine registrierte App-Intent-Datei für Ihre Domain

Wenn das Token auf Nutzerebene gespeichert wird (siehe Token beibehalten), wird es dass Sie geräteübergreifende Attribution bereitstellen. Das heißt, eine nutzende Person, über einen Aktionslink vom Desktop aus und schließt die Transaktion dann auf einem Mobilgerät ab. (unter Verwendung desselben Nutzerkontos) sollte ein Conversion-Ereignis auslösen.

Wenn das Token nur auf Geräteebene gespeichert wird, z. B. im Browser Cookies verwenden, wird nicht erwartet, dass Sie geräteübergreifende Attribution bereitstellen. In dieser würde für jedes Gerät ein separates Token bestehen bleiben, wenn der Nutzer ein Aktionslink auf diesem Gerät erstellt, und jedes Gerät folgt der separat festlegen.