Bağlılık kayıt ve oturum açma özelliği, kullanıcıların bağlılık programınızı aramasına ve Google Cüzdan'ı kullanarak hesaplarına katılmasına veya hesaplarında oturum açmasına olanak tanır. Kullanıcılar işlemi tamamlamaları için mobil uyumlu web sitenize yönlendirilir. Ardından, kartlarını Google Cüzdan'a ekleyebilirler.
Bu kılavuzda, bağlılık programınızı bu özellik için etkinleştirmek üzere gereken uygulama adımlarına genel bir bakış sunulmaktadır.
Genel bakış
Başlamak için daha önce projenizi oluşturduğunuzdan ve Google Cüzdan API'sine erişebildiğinizden emin olun.
Bağlılık programınıza kayıt ve oturum açma özelliğini uygulamak için şu dört adımı uygulamanız gerekir:
- Kayıt/oturum açma akışlarınızı test etmek için Google Cüzdan'da bir test sınıfı oluşturun.
- Google Cüzdan
SharedDataType
kullanan kayıt/oturum açma sayfaları geliştirin. - Bağlılık kartının kayıt/oturum açma işleminin ardından Google Cüzdan'a geri gönderilmesini sağlayın.
- Doğrulama ve etkinleştirme isteğinde bulunun.
Google Cüzdan'da bir 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 uygun değerleri ayarlamak için loyaltyclass
içindeki iç içe yerleştirilmiş discoverableProgram
alanlarını kullanın.
Kayıt/oturum açma özelliğinin etkinleştirildiği bağlılık programınızın taslak sürümünü oluşturmak için discoverableProgram
bölümündeki değerleri ayarlayın. Bunun test kullanıcılarının görebildiğinden emin olmak için test kullanıcılarının Google Pay ve Cüzdan Konsolunuza erişebildiğini doğrulayın. Google Pay ve Cüzdan Konsolunuzun erişimini diğer kullanıcılarla nasıl paylaşacağınız hakkında ayrıntılı bilgi için Kullanıcılar sayfası hakkında bilgi edinin.
Geliştirme sürecinde uygulamanızın işlevselliğinin doğrulanmasını tamamlamak için Google Pay ve Cüzdan Konsolu'ndaki iletişim desteği widget'ını kullanarak bize ulaşın. Konsoldayken konuda Google Cüzdan API'yi ve alt konuda Bağlılık oturumu açma/kayıt'ı seçin.
Google Cüzdan kullanıcı verilerinin kullanıldığı kayıt ve oturum açma sayfaları geliştirme
Bağlılık programınıza kaydolmayı veya oturum açmayı seçen kullanıcılar, kayıt ya da oturum açma sürecini tamamlamak için web sitenizde özelleştirilmiş bir sayfaya yönlendirilir. Bir kullanıcı kaydolmayı seçerse Google Cüzdan, kullanıcıdan kullanıcı verilerinin sizinle paylaşılmasını onaylamasını ister.
Kullanıcıların bu işlemleri tamamlamasına olanak tanıyan iki sayfadan birini veya her ikisini de sağlamanız gerekir.
- Kullanıcının mevcut bir hesapta oturum açabileceği bir oturum açma URL'si.
- Kullanıcının yeni hesap oluşturabileceği bir kayıt URL'si.
Oturum açma ve kayıt sayfalarınız aşağıdaki gereksinimleri 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 sayfada tamamlamasına izin verin.
- Kullanıcı verilerinin güvenli bir şekilde aktarılması için geçerli bir sertifikayla
HTTPS
şifrelemesi kullanın. - Oturum açma ve kayıt sayfalarınızın en az% 99,9 kesintisiz çalışmasını sağlayın.
Yukarıdaki gerekliliklere ek olarak, kullanıcıların herhangi bir form doldurmadan veya sayfayı yalnızca hizmet şartlarını kabul ettiğiniz şekilde bırakmadan bağlılık programınıza kaydolmalarına izin vermenizi öneririz.
SharedDataType
içinde sağlanan kullanıcı verilerinden yararlanarak hesap oluşturabilir ve bağlılık kartını hemen geri çekebilirsiniz.- Ardından kullanıcıya tek kullanımlık bir şifreyi veya şifresini ve isteğe bağlı hesap ayrıntılarını yapılandırmak için bir bağlantıyı e-postayla gönderebilirsiniz.
- Her ilave adım, daha fazla ayrılmaya neden olabileceğinden, bu sayede kullanıcıların kayıt işlemini terk etme olasılığı azalır.
Google Cüzdan, oturum açma veya kayıt sayfasını sunarken bir Android Web Görünümü oluşturur ve sağladığınız URL'ye POST
isteği gönderilir. Kullanıcı verileri,
application/x-www-form-urlcoding içerik türü ve UTF-8
kodlaması kullanılarak POST
isteğine dahil edilen SharedDataType
parametresinde sağlanır. SharedDataType
parametresinin değeri, Base64 olarak kodlanmış JSON nesnesidir.
Kullanıcı tarafından seçilen işleme ve kullanıcıdan istemek için 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 | ✓ |
state | ✓ |
posta kodu | ✓ |
country | ✓ |
telefon | ✓ |
SharedDataType
içinde yer alan kodu çözülmüş bir örnek JSON nesnesi için aşağıya bakın.
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ın hemen Google Cüzdan'a geri gönderilmesi
Kimlik doğrulaması yapıldıktan (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 göndermelidir.
Aşağıdaki yapıya uygun bir bağlantıya yönlendirerek bağlılık kartınızı Google Cüzdan'a geri aktarabilirsiniz.
https://pay.google.com/gp/v/save/{jwt_generated}
Bir URL'nin güvenli uzunluğu 2000 karakterdir. Bağlantılarınız bu sınırın altında kalmalıdır. JWT'lerde kodlanan nesneler küçük olmalı ve yalnızca kullanıcıya özel veriler içermelidir. JWT'yi yapmadan önce çoğu veriyi nesnenin sınıfında tutmaya çalışın. Sınıra uymayan daha büyük nesneler için öncelikle nesneyi Google Cüzdan API'sinde oluşturmayı ve JWT'de yalnızca nesne kimliğini göndermeyi düşünün.
Tipik İletişim Akışı
Kayıt veya oturum açma işlemini tamamlayan bir kullanıcının iletişim akışı aşağıdaki resimde gösterilmektedir. "Sunucunuz" arasındaki tüm işlemleri uygulama sorumluluğu size aittir.
Doğrulama ve etkinleştirme iste
Geliştirme çalışmasını tamamlayıp kayıt/oturum açma akışlarınızı test ettikten sonra Google Pay ve Cüzdan Konsolu iletişim destek widget'ını kullanarak bir istek gönderin.
Uygulamanızın Google Cüzdan uygulamasıyla birlikte doğru işlevselliği onayladığı tam olarak incelendikten sonra, bağlılık programınız için bağlılık kayıt/oturum açma özelliği herkese açık olarak kullanıma sunulacaktır. Bu sayede tüm kullanıcılar programı görebilir ve bu işlevden yararlanabilir.
En iyi kullanıcı deneyimini sağlamak amacıyla özellik gereksinimlerine sürekli uyum sağlamak için kayıt/oturum açma uygulamanız için yinelenen kontroller gerçekleştirilir. Tutarsızlıklar olması durumunda size bilgi verilir. Oturum açma/kayıt işlevi, sorun çözülene kadar devre dışı bırakılabilir.
Sık Sorulan Sorular
- Bağlılık programımda kullanılan resimlerle ilgili herhangi bir koşul var mı?
- Evet, aksi takdirde Google Cüzdan'da görünür olmayacakları için resimleriniz
HTTPS
konumunda barındırılmalıdır.
- Evet, aksi takdirde Google Cüzdan'da görünür olmayacakları için resimleriniz
- JWT'lerin uygulanmasını ve hata ayıklamasını basitleştiren araçlar var mı?
- Evet, www.jwt.io gibi platformlar, geliştirme süreciniz sırasında jetonlarınızın kodunu çözmenizi ve hata ayıklamanızı sağlayarak gönderdiğiniz içeriği doğrulamanıza olanak tanır. Google'ın hiçbir satış ortaklığı yoktur ve bu tür üçüncü tarafları özel olarak önermez.
- Base64 olarak kodlanmış SharedDataType verilerini doğru şekilde nasıl işleriz?
- Süreç boyunca UTF-8 kodlaması kullandığınızdan emin olun. JSON dizesi önce UTF-8, ardından NO_WRAP ve URL_SAFE seçenekleriyle android.util.Base64 kullanılarak kodlanır. Bu, RFC 3548 bölüm 4'e karşılık gelir.