Kullanıcı Bağlılık Programı kaydı

Bağlılık kaydı ve oturum açma özelliği, kullanıcıların bağlılık programına kaydolmalı ve Google Cüzdan'dan hesaplarında oturum açmalı veya katılmalıdır. Kullanıcılar, Bu işlemden sonra kartlarını Google Cüzdan'a ekleyebilirler.

Bu kılavuzda, gerekli uygulama adımlarına genel bir bakış sunulmaktadır. Bu özellik için bağlılık programınızı etkinleştirin.

Genel Bakış

Başlamak için projenizi önceden oluşturduğunuzdan ve Google Cüzdan API'si.

Kayıt ve oturum açma özelliğini uygulamak için şu dört adımı izlemeniz gerekir: şu teklif türünü kullanın:

  1. Kayıt/oturum açma akışlarınızı test etmek için Google Cüzdan'da bir test sınıfı oluşturun.
  2. Google Cüzdan SharedDataType kullanan kayıt/oturum açma sayfaları geliştirin.
  3. Kayıt/oturum açma işleminden sonra bağlılık kartının Google Cüzdan'a gönderimini uygulayın.
  4. Doğrulama ve etkinleştirme isteğinde bulunun.

Google Cüzdan'da test sınıfı oluşturma

Kayıt ve oturum açma URL'lerini, program logonuzu ve seçilen kullanıcı alanlarını belirleyin. Ardından, discoverableProgram iç içe geçmiş alanları ayarlamak için loyaltyclass uygun değerlere sahip olur.

Uygulamanızın taslak sürümünü oluşturmak için discoverableProgram içindeki değerleri ayarlayın kayıt/oturum açma özelliğinin etkin olduğu bağlılık programı. Test kullanıcılarının bunu görebilmesi için şunu doğrulayın: Test kullanıcılarının Google Pay ve Cüzdan Konsolunuza erişimi olmalıdır. Verilerinizi paylaşmayla ilgili ayrıntılı bilgi için Google Pay ve Cüzdan Konsolu'nun diğer kullanıcılarla erişimi, bkz. Kullanıcılar sayfası hakkında bilgi edinin.

Geliştirme sırasında uygulamanızın işlevselliğinin doğrulamasını tamamlamak için işlemi için Google Pay ve Cüzdan Konsolu'ndaki destek ekibi iletişim widget'ını kullanarak bize ulaşın. Şu moddayken: konsolda, konuda Google Cüzdan API'si'ni ve ardından Bağlılık oturumu açma/kayıt işlemini seçin. düşünmelisiniz.

Google Cüzdan kullanıcı verilerinin kullanıldığı kayıt ve oturum açma sayfaları geliştirme

Bir kullanıcı, bağlılık programınızda oturum açmayı veya kaydolmayı seçtiğinde web sitenizde özelleştirilmiş bir sayfaya yönlendirildikten sonra adımları uygulayın. Bir kullanıcı kaydolmayı seçerse, Google Cüzdan kullanıcıdan, kullanıcı verilerinin sizinle paylaşılmasını onaylamasını isteyecektir.

Kullanıcıların bu işlemleri tamamlamasına olanak tanıyan iki sayfadan birini veya her ikisini de sağlamanız gerekir.

  1. Kullanıcının mevcut bir hesapta oturum açabileceği bir oturum açma URL'si.
  2. Kullanıcının yeni hesap oluşturabileceği kayıt URL'si.

Oturum açma ve kayıt sayfalarınız aşağıdaki koşulları karşılamalıdır:

  • Mobil uyumlu bir kullanıcı deneyimi sağlayın.
  • Kayıt işlemi sırasında zorunlu alanların sayısını en aza indirin.
  • Kullanıcının oturum açma veya kayıt işlemini tek bir sayfadan tamamlamasını sağlayın.
  • Kullanıcı verilerininHTTPS iletilmelidir.
  • Oturum açma ve kayıt sayfalarınızın en az% 99,9 oranında çalışır durumda olduğundan emin olun.

Yukarıdaki koşullara ek olarak, hiçbir form doldurmadan veya e-posta göndererek yalnızca hizmet şartlarını kabul ettiğiniz şekilde tutun.

  • SharedDataType kapsamında sağlanan kullanıcı verilerinden yararlanarak bir hesap oluşturabilirsiniz ve bağlılık kartını hemen reddediyor.
  • Ardından, kullanıcıya tek kullanımlık bir şifre veya bağlantı gönderebilirsiniz. adresine giderek şifresini ve isteğe bağlı hesap ayrıntılarını yapılandırabilirsiniz.
  • Bu, kullanıcıların kayıt sürecinden vazgeçme olasılığını azaltır. çünkü her ek adım daha fazla ayrılmaya neden olabilir.

Oturum açma veya kayıt sayfası gösterilirken Google Cüzdan, bir Android Web Görünümü ve POST isteği gönderilir URL'yi tıklayın. Kullanıcı verileri SharedDataType parametresinde sağlanır Bu değer, POST isteğine application/x-www-form-urlcoding içerik türü ve UTF-8 kodlama. SharedDataType değeri parametresi, Base64 olarak kodlanmış JSON nesnesidir.

Kullanıcının seçtiği işleme ve belirttiğiniz alanlara bağlı olarak JSON nesnesi aşağıdaki alanları içerebilir.

Alan Kayıt
e-posta
firstName
lastName
addressLine [1-3]
şehir
durum
posta kodu
country
telefon

Kodu çözülmüş bir örnek JSON nesnesi için aşağıya bakın SharedDataType içinde yer alır.

Kaynak

{
  "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"
}

Bağlılık kartınızın Google Cüzdan'a anında geri gönderilmesini uygulayın

Kimliğin doğrulanması (oturum açma) veya hesap oluşturulduktan (kayıt) sonra sayfanız, Kullanıcının bağlılık kartını hemen Google Cüzdan'a geri göndermelidir.

Şu kullanıcıya yönlendirerek bağlılık kartınızı Google Cüzdan'a geri aktarabilirsiniz: bağlantısını tıklayın.

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

Bir URL için güvenli uzunluk 2000 karakterdir. Bağlantılarınız olduğunu unutmayın. JWT'lerde kodlanan nesneler küçük olmalıdır ve belirli verilerdir. Çoğu veriyi nesnenin sınıfında tutmaya çalışın, hazırlamayı öğreteceğim. Sınıra uymayan daha büyük nesneler için önce nesneyi Google Cüzdan API'si kullanabilir ve JWT'de yalnızca nesne kimliğini gönderebilir.

Tipik İletişim Akışı

Bir kullanıcının kayıt veya oturum açma işlemini tamamlamasına ilişkin iletişim akışı ekleyebilirsiniz. "Sunucunuz" arasındaki tüm işlemler siz de karar verirsiniz.

Kayıt oturum açma akışları

Doğrulama ve etkinleştirme isteğinde bulunma

Geliştirme çalışmasını tamamlayıp kayıt/oturum açma akışlarınızı test ettikten sonra bir istek gönderin aracılığıyla Google Pay ve Cüzdan Konsolu destek ekibiyle iletişime geçin widget'ını tıklayın.

Uygulamanızın tamamını inceledikten sonra, bağlılık programı kayıt/oturum açma özelliği de dahil, bağlılık programınız için herkese açık şekilde yayınlanır. Bu, tüm kullanıcıların bu işlevden yararlanmak olacaktır.

En iyi kullanıcı deneyimini sunmak için kayıt/oturum açma işleminizi yinelenen şekilde kontrol edin. özellik şartlarına sürekli uygunluğu sağlamak için uygulama süreci de yürütülecektir. Tutarsızlık olduğunda ve oturum açma/kayıt işleviyle ilgili bildirim alırsınız sorun çözülene kadar devre dışı bırakılabilir.

Sık Sorulan Sorular

  • Bağlılık programımda kullanılan resimler için herhangi bir koşul var mı?
    • Evet, resimleriniz HTTPS konumunda barındırılmalıdır Aksi takdirde Google Cüzdan'da görünmeyecektir.
  • JWT'lerin uygulanmasını ve hata ayıklamasını kolaylaştıran araçlar var mı?
    • Evet, www.jwt.io, kullanıcıların kullandığı ve geliştirme süreci sırasında jetonlarınızda hata ayıklayarak çok önemlidir. Google'ın satış ortaklığı olmadığını ve Google'ın bu tür üçüncü tarafları özellikle önermemektedir.
  • Base64 kodlamalı SharedDataType verilerini doğru şekilde nasıl işliyoruz?
    • İşleminiz boyunca UTF-8 kodlaması kullandığınızdan emin olun. JSON dizesi ilk UTF-8 olarak ve daha sonra android.util.Base64 ve (NO_WRAP ve URL_SAFE) seçeneklerine gidin. Bu, RFC 3548 bölüm 4.