Implementierung
Zusammenfassung
Eine Conversion-Tracking-Implementierung besteht aus drei Teilen:
-
rwg_token
erfassen von der Landingpage bzw. dem Einstiegspunkt der App aus. -
rwg_token
beibehalten für den entsprechenden Attributionszeitraum aus. - An der Kasse Conversion-Ereignis senden
Diese Conversion-Tracking-Implementierung erfordert keine Google Analytics oder JavaScript von Drittanbietern verwenden.
<ph type="x-smartling-placeholder">Bevor Sie mit der Implementierung des Conversion-Trackings beginnen, sollten Sie sich entscheiden, Wenn Sie Conversions auf Geräte- oder Nutzerebene erfassen möchten:
- Die Geräteebene umfasst die Verwendung von Browsercookies, lokalen lokalen Speicher, App-Speicher und jede andere Methode, Das Token für den 30-tägigen Attributionszeitraum. Da das Token werden lokal auf dem Gerät des Nutzers gespeichert, das verwendete Gerät, löscht den lokalen Speicher/Cookies oder ein privates Surfen oder Inkognitomodus verwendet, wird das Conversion-Ereignis nicht korrekt zugeordnet werden. Bei Verwendung des Geräteniveaus Conversion-Tracking einrichten, müssen Sie dies für alle unterstützten Oberfläche (einschließlich mobiler Geräte) nicht verfügbar sind.
- Zur Nutzerebene gehört die Speicherung in Ihrer Anwendung. über ein serverseitiges Analysesystem oder eine andere serverseitigen Systemen. Da das Token auf dem Ändert der Nutzer das verwendete Gerät, löscht er lokalen Speicher bzw. Cookies oder nutzt ein privates Surfen oder Im Inkognitomodus wird das Conversion-Ereignis meldet sich der Nutzer wieder an. Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, können Sie je nach Systemarchitektur implementieren Sie dies einmal auf Ihrer Serverseite und verwenden es für alle unterstützten Oberflächen.
rwg_token
wird erfasst...
Jedes Mal, wenn Google eine action_link
anzeigt, die Sie über
wird diese URL so geändert, dass sie eine eindeutige Suchanfrage enthält,
Parameter: rwg_token
. Das rwg_token
value ist ein codierter String, der einige Metadaten zum
auf den der Nutzer geklickt hat. Sie speichern dieses Token und geben es als
Teil des Conversion-Ereignisses ist.
Auf jedem Landingpage-/App-Einstiegspunkt muss der festgelegte Wert geparst werden
für den Abfrageparameter rwg_token
und speichern Sie ihn. Anforderungen für
Speicherung dieses Parameters wird im Schritt Das
rwg_token
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 der bei der Antwort auf die Anfrage:
<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
<ph type="x-smartling-placeholder">
Sie müssen den URL-Parameter rwg_token
beibehalten, der
an alle Aktionslinks angehängt, die Sie angegeben haben,
Dauer von 30 Tagen. Der Wert von rwg_token
sollte
werden gespeichert und ohne Änderungen zurückgegeben.
Wenn ein Token von einem vorherigen Besuch beibehalten wurde, wird der
das alte Token ersetzt werden sollte und die 30-Tage-Frist für die Speicherung
zurückgesetzt werden sollte.
Wenn Sie das Token persistieren, können Sie es entweder am Geräteebene oder auf Nutzerebene:
- Die Geräteebene umfasst die Nutzung von Browsercookies, lokalem Speicher, oder eine andere Methode, mit der das Token für den Attributionszeitraum von 30 Tagen.
- 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. Speichern dieses Tokens in einem Webbrowser über eine erste Party-Cookie. In diesem Beispiel wird davon ausgegangen, dass Sie den Tokenwert geparst haben. in eine Variable wie im Beispiel oben. Um dieses Beispiel zu verwenden, 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>
Wenn Sie Conversion-Tracking auf Nutzerebene verwenden, sollte rwg_token
auf dem Server gespeichert und dem Nutzer zugeordnet werden.
Conversion-Daten senden
Wenn ein Nutzer eine Transaktion abschließt, Google Place Action-Link aufrufen möchten, müssen Sie eine HTTP POST-Anfrage an den Conversion-Endpunkt. Es gibt zwei Endpunkte, einen für die Produktion und eine 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 müssen Sie
eine gültige rwg_token
angeben, wenn ein Conversion-Ereignis gesendet wird.
Zu Testzwecken in der Sandbox-Umgebung können Sie Folgendes verwenden:
Test-Token
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==<ph type="x-smartling-placeholder">
Ein vollständiges Beispiel für das Conversion-Tracking auf Geräteebene (Verwendung eines Cookies auf auf dem Gerät des Nutzers) in JavaScript angeben, wie die unten enthalten:
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, Token, das mit dem Nutzer verknüpft ist (unabhängig von der Oberfläche von Ihrem serverseitigen Speichermechanismus und Token mit denselben Produktions- oder Sandbox-Endpunkten.
<ph type="x-smartling-placeholder">Anforderungen an die Conversion-Zuordnung
Der erforderliche Standard für die Conversion-Attribution ist ein 30-tägiger für jede Interaktion mit einem Ortslink, jederzeit speichern.
<ph type="x-smartling-placeholder">Dieser Attributionszeitraum bedeutet, dass wir eine Conversion erwarten, in folgenden Fällen gesendet werden:
- Ein Nutzer folgt einem Place Action-Link und gibt im in derselben Sitzung
- Ein Nutzer folgt einem Place Action-Link und kehrt dann von einem innerhalb von 30 Tagen unterschiedliche Kanäle nutzen.
- Ein Nutzer folgt einem Place Action-Link und gibt dann eine Bestellung in einem in einem anderen Store, entweder innerhalb derselben Sitzung oder in einem anderen in einem Zeitfenster von 30 Tagen.
Außerdem gehen wir davon aus, dass Conversion-Ereignisse von allen die ein Nutzer über einen Link zu einer ortsbezogenen Aktion aufrufen kann. 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 ist (siehe Token beibehalten), ist dies erwartet. die geräteübergreifende Attribution bietet. Das heißt, Nutzende, einem Aktionslink auf dem Desktop folgt und dann Transaktion auf Mobilgerät (über dasselbe Nutzerkonto) sollte ausgelöst werden Conversion-Ereignis.
Wenn das Token nur auf Geräteebene gespeichert wird, z. B. in Browser-Cookies verwenden, ist es nicht zu erwarten, dass Sie Namensnennung. In diesem Fall hätte jedes Gerät ein separates Token. bleibt bestehen, wenn der Nutzer auf diesem Gerät einem Aktionslink gefolgt ist. muss jedes Gerät die Attributionsregeln separat einhalten.