Registrierung für das Nutzer-Treuepunkteprogramm

Mit der Funktion zum Registrieren und Anmelden für das Treuepunkteprogramm können Nutzer nach Ihrem Treuepunkteprogramm zu sichern und sich über Google Wallet in ihrem Konto anzumelden. Nutzer werden auf Ihre für Mobilgeräte optimierte Website weitergeleitet, um den Anschließend kann er seine Karte zu Google Wallet hinzufügen.

Dieser Leitfaden bietet einen Überblick über die erforderlichen Implementierungsschritte. um Ihr Treuepunkteprogramm für diese Funktion zu aktivieren.

Übersicht

Stellen Sie zuerst sicher, dass Sie Ihr Projekt eingerichtet und Zugriff auf Google Wallet API

Führen Sie die folgenden vier Schritte aus, um die Registrierungs- und Anmeldefunktion zu implementieren. für Ihr Treuepunkteprogramm:

  1. Richte in Google Wallet einen Testkurs ein, um deine Registrierungs-/Anmeldeabläufe zu testen.
  2. Erstelle Registrierungs-/Anmeldeseiten, die Google Wallet SharedDataType verwenden.
  3. Implementieren Sie die Rückgabe der Kundenkarte in Google Wallet nach der Registrierung/Anmeldung.
  4. Fordern Sie die Bestätigung und Aktivierung an.

Testkurs in Google Wallet einrichten

Bestimme die Registrierungs- und Anmelde-URLs, dein Programmlogo und die ausgewählten Nutzerfelder. Gehen Sie dann so vor: Verwenden Sie die verschachtelten Felder discoverableProgram in der loyaltyclass zum Festlegen des geeignete Werte.

Legen Sie die Werte in discoverableProgram fest, um einen Entwurf Ihrer Treuepunkteprogramm mit aktivierter Registrierung/Anmeldung. Damit dies für Tester sichtbar ist, musst du prüfen, Die Tester haben Zugriff auf deine Google Pay & Wallet Console. Weitere Informationen zum Teilen Ihrer Informationen zum Zugriff von Google Pay und Wallet Console mit anderen Personen finden Sie unter Weitere Informationen zur Seite „Nutzer“

Um die Überprüfung der Funktionalität Ihrer Implementierung während der Entwicklung abzuschließen kannst du dich über das Kontakt-Support-Widget in der Google Pay and Wallet Console an uns wenden. Im wählen Sie in der Console als Thema Google Wallet API und dann Anmeldung/Anmeldung für Treuepunkteprogramm aus. untergeordnetes Thema.

Registrierungs- und Anmeldeseiten erstellen, auf denen Google Wallet-Nutzerdaten verwendet werden

Wenn sich ein Nutzer für Ihr Treuepunkteprogramm anmeldet oder werden sie auf eine angepasste Seite Ihrer Website weitergeleitet, Registrierung oder Anmeldung. Wenn sich ein Nutzer anmeldet, wird Google Wallet fordert den Nutzer auf, die Freigabe seiner Daten für Sie zu genehmigen.

Sie müssen eine der beiden Seiten oder beide Seiten bereitstellen, über die Nutzer diese Aktionen ausführen können.

  1. Eine Anmelde-URL, unter der sich ein Nutzer in einem bestehenden Konto anmelden kann.
  2. Eine Registrierungs-URL, unter der ein Nutzer ein neues Konto erstellen kann.

Ihre Anmelde- und Registrierungsseiten müssen die folgenden Anforderungen erfüllen:

  • Bieten Sie eine für Mobilgeräte optimierte Nutzererfahrung.
  • Minimieren Sie die Anzahl der Pflichtfelder während der Registrierung.
  • Nutzer können sich auf einer einzigen Seite anmelden oder registrieren.
  • Verwenden Sie die HTTPS-Verschlüsselung mit einem gültigen Zertifikat, damit Nutzerdaten sicher sind sicher übertragen werden.
  • Sorgen Sie für eine Verfügbarkeit Ihrer Anmelde- und Registrierungsseiten zu mindestens 99,9 %.

Zusätzlich zu den oben genannten Anforderungen sollten Sie Nutzern erlauben, um sich für Ihr Treuepunkteprogramm anzumelden, ohne nur die Nutzungsbedingungen akzeptieren.

  • Mithilfe der im SharedDataType bereitgestellten Nutzerdaten können Sie ein Konto erstellen und sofort ihre Kundenkarte ablehnen.
  • Anschließend können Sie dem Nutzer per E-Mail ein Einmalpasswort oder einen Link senden. um ihr Passwort und optionale Kontodetails zu konfigurieren.
  • So verringern Sie die Wahrscheinlichkeit, dass Nutzer den Registrierungsprozess abbrechen. da jeder weitere Schritt zu einem weiteren Ausstieg führen kann.

Auf der Anmelde- oder Registrierungsseite erstellt Google Wallet eine Android WebView und eine POST-Anfrage wird an die bereitgestellte URL Die Nutzerdaten werden im Parameter SharedDataType bereitgestellt. der in der POST-Anfrage enthalten ist, die Inhaltstyp "application/x-www-form-urlencoded" und UTF-8-Codierung. Der Wert von SharedDataType ist ein Base64-codiertes JSON-Objekt.

Abhängig von der vom Nutzer gewählten Aktion und den von Ihnen angegebenen Feldern vom Nutzer anzufordern, kann das JSON-Objekt die folgenden Felder enthalten.

Feld Registrierung
E-Mail
firstName
lastName
Adresszeile [1–3]
Ort
Bundesstaat
Postleitzahl
country
Telefon

Unten finden Sie ein decodiertes Beispiel-JSON-Objekt. in SharedDataType enthalten.

Ressource

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "jane.doe@example.com",
  "phone": "555-555-5555"
}

Sofortige Rückgabe der Kundenkarte in Google Wallet implementieren

Nach der Authentifizierung (Anmeldung) oder nach der Kontoerstellung (Registrierung) wird Ihre Seite sollte die Kundenkarte des Nutzers sofort an Google Wallet senden.

Sie können die Kundenkarte an Google Wallet senden, indem Sie mit folgender Struktur erstellen:

https://pay.google.com/gp/v/save/{jwt_generated}

Die sichere Länge einer URL beträgt 2.000 Zeichen. Ihre Links sollten bleiben unter dieser Grenze. In JWTs codierte Objekte sollten klein sein und nur die für die Nutzenden spezifisch sind. Versuchen Sie, die meisten Daten in der Klasse des Objekts zu belassen, bevor das JWT erstellt wird. Bei größeren Objekten, die die Begrenzung nicht überschreiten, sollten Sie Erstellen des Objekts in der Google Wallet API und sende nur die Objekt-ID im JWT.

Typischer Kommunikationsablauf

Der Kommunikationsablauf für einen Nutzer, der die Registrierung oder Anmeldung durchführt, ist in der folgenden Bild. Alle Aktionen zwischen „Ihr Server“ für deren Umsetzung Sie verantwortlich sind.

Abläufe für die Anmeldung und Anmeldung

Überprüfung und Aktivierung anfordern

Nachdem Sie die Entwicklungsarbeit abgeschlossen und Ihre Registrierungs-/Anmeldeabläufe getestet haben, senden Sie eine Anfrage. über die Kontakt zum Support über die Google Pay und Wallet Console Widget.

Nach einer vollständigen Überprüfung Ihrer Implementierung, die die korrekte Funktionsweise bestätigt, in Kombination mit der Google Wallet App wird die Registrierung/Anmeldung für das Treuepunkteprogramm für Ihr Treuepunkteprogramm veröffentlicht wurde. Dadurch kann jeder Nutzer die Programmieren und nutzen Sie diese Funktion.

Um eine optimale Nutzererfahrung zu gewährleisten, sollten Sie Ihre Registrierung/Anmeldung regelmäßig überprüfen. Implementierung durchgeführt, um die kontinuierliche Einhaltung der Funktionsanforderungen sicherzustellen. Sie werden im Falle von Abweichungen und der Anmelde-/Registrierungsfunktion benachrichtigt. wird möglicherweise deaktiviert, bis das Problem behoben ist.

Häufig gestellte Fragen

  • Gibt es Anforderungen an die in meinem Treuepunkteprogramm verwendeten Bilder?
    • Ja, Ihre Bilder sollten am Standort HTTPS gehostet werden. da sie ansonsten in Google Wallet nicht sichtbar sind.
  • Gibt es Tools, die die Implementierung und Fehlerbehebung von JWTs vereinfachen?
    • Ja, Plattformen wie www.jwt.io ermöglicht es Ihnen, und Fehler während des Entwicklungsprozesses beheben, der von Ihnen eingereichten Inhalte. Beachten Sie, dass Google weder mit Google Dritten ausdrücklich empfehlen.
  • Wie werden die Base64-codierten SharedDataType-Daten richtig verarbeitet?
    • Verwende während des gesamten Prozesses die UTF-8-Codierung. JSON-String wird zunächst UTF-8-codiert und anschließend mit <ph type="x-smartling-placeholder"></ph> android.util.Base64 mit den Optionen NO_WRAP und URL_SAFE. Dies entspricht RFC 3548, Abschnitt 4.