Implementierung
Zusammenfassung
Eine Conversion-Tracking-Implementierung besteht aus drei Teilen:
rwg_token
undmerchant_id
von der Landingpage / App erfassen Einstiegspunkts hinzufügen.rwg_token
undmerchant_id
für die entsprechende Attribution beibehalten .- Dauerhafte(s)
merchant_id
undmerchant_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.