Integrationsleitfaden
Integrieren Sie das Umfrage-Opt-in-Modul
Das Umfrage-Opt-in-Modul ermöglicht Kunden die Wahl, ob sie an Google Kundenrezensionen teilnehmen möchten, und übermittelt auch die erforderlichen Transaktionsinformationen an Google. Dieses Modul ist auf allen Bestellbestätigungsseiten erforderlich, um an Google Kundenrezensionen teilzunehmen. Wenn Sie Probleme bei der Integration des Umfrage-Opt-in-Moduls haben, versuchen Sie es mit der Fehlerbehebung .
Dieser Abschnitt umfasst die folgenden Themen:
Wenn ein Nutzer zustimmt, sendet Google ihm nach dem voraussichtlichen Liefertermin seiner Bestellung eine Umfrage. Weitere Informationen finden Sie in der Google-Umfrage zu Kundenrezensionen .
Das Umfrage-Opt-in funktioniert auf dem Desktop und auf Mobilgeräten. Stellen Sie sicher, dass Sie das Opt-in-Code-Snippet sowohl auf Ihren Desktop- als auch auf Ihren mobilen Websites hinzufügen.
Integrationshinweise
Um das Umfrage-Opt-in-Modul auf der Bestellbestätigungsseite einzufügen, müssen Sie:
Der Code des Opt-in-Moduls für die Umfrage sollte auf der Bestellbestätigungsseite Ihrer Checkout-Abläufe platziert werden. Alle Bestätigungsseiten müssen HTTPS (nicht HTTP) verwenden.
Da dieses Modul das Opt-in für die Umfrage von Google Kundenrezensionen (GCR) auslöst, müssen die Bestelldetails in diesem Modul so genau wie möglich sein.
Wenn Ihr Checkout-Prozess einen Drittanbieter verwendet, muss dieser zurück zur Bestätigungsseite Ihrer Domain umleiten.
Verdecken Sie das Opt-in-Modul für die GCR-Kundenumfrage nicht mit anderen Inhalten auf Ihrer Bestellbestätigungsseite.
Aktualisieren Sie den DOCTYPE
Stellen Sie sicher, dass die Bestätigungsseite den HTML5-DOCTYPE verwendet:
<!DOCTYPE html>
Dieser Dokumenttyp muss das erste Zeilenelement im HTML-Code auf Ihrer Seite sein. Die Verwendung des HTML5-DOCTYPE stellt sicher, dass Webbrowser Ihre Seiten im Standardmodus statt im Quirks-Modus darstellen. Der Quirks-Modus bezieht sich auf eine Technik, die von einigen Webbrowsern verwendet wird, um die Abwärtskompatibilität mit Webseiten aufrechtzuerhalten, die für ältere Browser entwickelt wurden, anstatt die W3C- und IETF-Standards im Standardmodus strikt einzuhalten.
Fügen Sie den Opt-in-Code hinzu
Um Ihren Kunden die Möglichkeit zu geben, eine Bewertung ihrer Erfahrungen mit dem Kauf bei Ihnen abzugeben, fügen Sie das Opt-in-Modul zu Ihrer Bestellbestätigungsseite hinzu.
So fügen Sie das Umfrage-Opt-in-Modul zu Ihrer Bestellbestätigungsseite hinzu:
1. Fügen Sie das folgende HTML-Snippet in Ihre Bestellbestätigungsseite ein:
<!-- BEGIN GCR Opt-in Module Code -->
<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"
async defer>
</script>
<script>
window.renderOptIn = function() {
window.gapi.load('surveyoptin', function() {
window.gapi.surveyoptin.render(
{
// REQUIRED
"merchant_id": " MERCHANT_ID ",
"order_id": " ORDER_ID ",
"email": " CUSTOMER_EMAIL ",
"delivery_country": " COUNTRY_CODE ",
"estimated_delivery_date": " JJJJ-MM-TT ",
// OPTIONAL
"products":[{"gtin":" GTIN1 "}, {"gtin":" GTIN2 ">}],
"opt_in_style": " OPT_IN_STYLE "
});
});
}
</script>
<!-- END GCR Opt-in Module Code -->
Platzieren Sie den Code direkt vor dem schließenden </BODY>-Tag. Wenn Sie den Umfragemodulcode mit dem Abzeichencode platzieren, spielt die Reihenfolge keine Rolle: Der Umfragemodulcode kann vor oder nach dem Abzeichencode stehen.
2. Ersetzen Sie die Variablen durch Ihre standortspezifischen, dynamischen Werte. Die folgende Tabelle beschreibt die verfügbaren Einstellungen:
Variable | Erforderlich? | Beschreibung |
MERCHANT_ID (Händler-ID) | Erforderlich | Ihre Merchant Center-ID. Diesen Wert erhalten Sie im Google Merchant Center. |
AUFTRAGSNUMMER (Auftragsnummer) | Erforderlich | Eine eindeutige ID für die Bestellung. |
KUNDEN-EMAIL (Kunden-eMail) | Erforderlich | Die E-Mail-Adresse des Kunden im Format name@domain.com. |
COUNTRY_CODE (Landesvorwahl) | Erforderlich | Der aus zwei Buchstaben bestehende Ländercode gibt an, wohin die Bestellung des Kunden geliefert wird. Dieser Wert muss im Format ISO 3166-1 Alpha-2 vorliegen. Verwenden Sie für dieses Feld nicht „ZZ". Zum Beispiel „USA". |
VORAUSSICHTLICHES LIEFERDATUM (Voraussichtliches Lieferdatum) | Erforderlich | Das voraussichtliche Lieferdatum für die Bestellung, wobei JJJJ das Jahr, MM der Monat und TT der Tag ist. Beispiel: „2016-09-13". |
GTIN1, GTIN2 (GTIN) | Optional | Numerische GTIN-Werte . |
OPT_IN_STYLE (Opt-in-Stil) | Optional | Gibt an, wie das Dialogfeld des Opt-in-Moduls angezeigt wird. Mögliche Werte sind: "CENTER_DIALOG": Wird als Dialogfeld in der Mitte der Ansicht angezeigt. "BOTTOM_RIGHT_DIALOG": Wird als Dialogbox unten rechts in der Ansicht angezeigt. "BOTTOM_LEFT_DIALOG": Wird als Dialogbox unten links in der Ansicht angezeigt. "TOP_RIGHT_DIALOG": Wird als Dialogbox oben rechts in der Ansicht angezeigt. "TOP_LEFT_DIALOG": Wird als Dialogfenster oben links in der Ansicht angezeigt. "BOTTOM_TRAY": Wird unten in der Ansicht angezeigt. Der Standardwert ist "CENTER_DIALOG". |
Geben Sie die Sprache an, die das Opt-in-Modul verwenden soll, indem Sie das folgende Code-Snippet in Ihre Webseite einfügen:
<!-- BEGIN GCR Language Code -->
<script>
window.___gcfg = {
lang: ' SPRACHE '
};
</script>
<!-- END GCR Language Code -->
Platzieren Sie den Code direkt vor dem schließenden </BODY>-Tag auf der Seite. Bei Platzierung mit dem Opt-in-Code spielt die Reihenfolge keine Rolle.
Legen Sie den Wert des lang-Parameters fest, indem Sie LANGUAGE durch eine der folgenden unterstützten Sprachen ersetzen:
- af
- ar
- bg
- ca
- cs
- da
- de
- El
- en
- de-AU
- de-DE
- de-US
- es
- es-419
- Fa
- fi
- fil
- fr
- ga
- Hi
- Std
- hu
- Ausweis
- Es
- iw
- ja
- k.o
- lt
- lv
- MS
- nl
- NEIN
- pl
- pt-BR
- pt-PT
- ro
- Ru
- sk
- sl
- sr
- sv
- te
- th
- tr
- Vereinigtes Königreich
- vi
- zh-CN
- zh-TW
Wenn Sie keinen Wert für den lang-Parameter angeben, verwendet das Umfragemodul eine Spracheinstellung basierend auf den Browsereinstellungen des Benutzers.
Beispiel-Umfrage-Opt-in-Code
Die Variablenwerte werden normalerweise auf Ihrer Bestellbestätigungsseite durch serverseitigen Code ersetzt. Das folgende Beispiel zeigt, wie Sie den Opt-in-Modul-Code mit PHP implementieren könnten:
<!-- BEGIN GCR Opt-in Module Code -->
<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"
async defer>
</script>
<script>
window.renderOptIn = function() {
window.gapi.load('surveyoptin', function() {
window.gapi.surveyoptin.render(
{
"merchant_id": 42,
"order_id": "<?php echo $order_id ?>",
"email": "<?php echo $email_address ?>",
"delivery_country": "<?php echo $user_country ?>",
"estimated_delivery_date": "<?php echo $delivery_date ?>",
"products": [{"gtin":"<?php echo $gtin_1 ?>"}, {"gtin":"<?php echo $gtin_2 ?>"}],
"opt_in_style": "BOTTOM_LEFT_DIALOG"
});
});
}
</script>
<!-- END GCR Opt-in Module Code -->
<!-- BEGIN GCR Language Code -->
<script>
window.___gcfg = {
lang: 'en_US'
};
</script>
<!-- END GCR Language Code -->
Wenn das Opt-in-Modul nicht auf Ihrer Seite angezeigt wird oder beim Laden der Seite Fehler auftreten, versuchen Sie es mit der Fehlerbehebung .
No comments:
Post a Comment