Recall API, oyunların kendilerine eşlik eden Play Oyun Hizmetleri'ni (PGS) diğer mevcut oturum açma mekanizmalarını kullandığınızdan emin olun oyuncularının İlk katılımda uygulamayı kullanmayı bırakan kullanıcı sayısını azaltmak için cihazlarında oturum açma bilgileri ve 1 gün elde tutma oranını artırabilirsiniz. API, kullanıcının Play Games Hizmetleri (PGS) hesabı ile geri çağırma jetonlarını Google sunucularında depolayarak oyun içi hesaplarını kullanma. Buradan Recall API'nin nasıl kullanılabileceğine dair örnek senaryo:
Kullanıcı, geliştiricinin takip edecek bir kimlik sistemine sahip olduğu bir oyun oynuyor ve PGS'yi diğer kimlik doğrulama yöntemleriyle birlikte kullanarak Kullanıcıların oyunlarına giriş yapmalarını sağlar. Bu örnekte, bir kullanıcı PGS'sine giriş yapmıştır. Laura'nın hesabını oluşturur ve geliştiricinin hesabı ile Racer94 adlı kimlik sistemi. Kullanıcı oyunu oynarken oyun sunucusu, ilerleme durumunu senkronize eder.
Geliştirici ayrıca Google'a bir geri çağırma jetonu da kaydeder. kullanıcının oyun içi hesabına karşılık gelir. Google otomatik olarak depolar bu geri çağırma jetonunu kullanıcının PGS profiline karşılayın.
Kullanıcı artık oyunu Google Play Games'de PC'de gerekir. Kullanıcı, PGS hesabıyla otomatik olarak oturum açar ve Oyun istemcisi, bu PGS'de ilerleme olup olmadığını kontrol eder. belirtir. Ardından oyun sunucusu, bu oyun için jeton olup olmadığını görmek üzere Google'ı sorgular bu PGS hesabına ait. Geri çağırma jetonu bulunduğundan Google, geri çağırma jetonunu geri gönderir ve Oyun sunucusu, kullanıcının ilişkili hesabını bulmak için bu jetonu kullanır. Racer94 ve ilerleme durumlarını geri yükle. PGS ile oturum açmak herhangi bir sorun yaşamadan, kullanıcının ilerlemesi uygulama tarafından geri yüklenir. kullanıcı adı veya şifre girmesine gerek yoktur. Ayrıca, geliştirici Mevcut kimlik sistemleriyle PGS oturum açma özelliğini kullanabilir ve Google'a güvenebilir. oyuncunun ilerleme durumu ile PGS hesabı arasındaki bağlantıyı kaydetme.
Yukarıdaki örnekte görüldüğü gibi, Google Analytics 4'te gerçekleştirilen geri çağırma API'si:
- Bir kullanıcı oyun içindeki öğelerden biriyle giriş yaptığında jetonu Google'da saklama hesaplar.
- Bir kullanıcının oyun içi uygulamasını geri yüklemek için jetonu alma hesaplar.
Recall API, geri çağırma jetonlarına ek olarak kararlı bir tanımlayıcı da gerektirir. karakter olarak bilinen oyun içi hesaba karşılık gelen kardinalite kısıtlamaları. Aklınıza bir karakter kullanıcının oyun içi hesabını temsil eden ve geri çağırma jetonunu, geri çağırma jetonunu kullanıcının oyun içi hesabını oyunla ilişkilendirin. Karakter ve jeton değerleri yeniden kullanılmamalıdır farklı platformlarda PGS projeleri. Ayrıca, geri çağırma jetonları zaman içinde değişse de karakterin kararlı olması gerekir. kullanıcının oyun içi hesabına göre.
Kardinalite kuralları
Recall API, PGS profilleri ve oyun içi arasında bire bir ilişki uygular kardinalite kuralları olarak adlandırılır; burada bir karakterin bir PGS profiline bağlı olup bir PGS profili yalnızca bir tanesine bağlanabilir çok önemlidir. Karakter, oyun içi hesap için sabit bir tanımlayıcı olarak kullanılır. çünkü geri çağırma jetonları zamanla değişebileceğinden.
PGS profiline bağlı karakter de zaman içinde değiştirilebilir (farklı Oyun içi hesapların PGS profiline bağlı olması gerekir).
Depolama ve yükleme işlemleri için ayrıntılı teknik akış geri çağırma jetonlarını alma
Bu bölümde oyun istemcisi, oyun sunucusu, sunucu ve ve geri çağırma jetonlarını depolayıp alırken Google'ın sunucuları için geçerlidir:
1. Adım: PGS kullanıcısında oturum açın ve oturum kimliğini alın
Oyun, PGS SDK'sını başlatır ve kullanıcının PGS ile oturum açmasını sağlamaya çalışır.
Kullanıcının oturum açmış olduğunu varsayarsak ve Google'ın OAuth arka ucundan OAuth 2.0 jetonu isteyin. İlgili içeriği oluşturmak için kullanılan oturum kimliği ve OAuth 2.0 jetonları, Google Games ile iletişim kurmak için kullanılır. arka uçta olması gerekir.
2. Adım: Kullanılabilir geri çağırma jetonlarını alın
PGS kullanıcısının hesabıyla ilişkili herhangi bir geri çağırma jetonu isteğinde bulunun. Jeton varsa 3a Adımına geçin ve ilerleme durumunu geri yükleyin. Aksi takdirde, bu yeni bir kullanıcıysa ve jetonu yoksa 3b adımına geçip yeni bir jeton depolayın.
Adım 3a: Jeton mevcutsa ilerleme durumunu geri yükleyin
Jeton varsa jetonu alıp şifresini çözün ve kullanıcı verilerini geri yükleyin.
3b Adımı: Jeton yoksa bir jeton depolayın
Jeton bulunmadığından ilerleme durumu geri yüklenmez. Kullanıcı oturum açar kimlik sistemiyle giriş yapmalı veya bunu yapmazsa yeni bir hesap bulunur.
Kullanıcının oyun içi hesabını kodlayan şifrelenmiş bir geri çağırma jetonu oluşturma ve oturum kimliği ve OAuth 2.0 jetonuyla birlikte Google'a gönderin. Bu noktada Google, gönderilen geri çağırma jetonu ile oyuncunun PGS hesabına ait.
PGS profili olmayan kullanıcılar için akışlar
Henüz PGS profili oluşturmamış bir kullanıcının geri çağırma jetonlarını şu şekilde depolayabilirsiniz: profilsiz modu kullanabilirsiniz. Ancak bu konuda dikkat edilmesi gereken iki önemli nokta vardır:
- PGS profili olmayan bir kullanıcı için jeton alamazsınız. Profil Kullanıcı, oyununuza giriş yapmaya çalıştığında otomatik olarak oluşturma istemi Play Games Hizmetleri ile ikinci bir cihazda.
- Ek yönergelere uymanız gerekir
ve aşağıdaki öğeleri açıklayan uygun bir bildirimin bulunduğundan emin olun:
uygun son kullanıcıdan izin almanız gerekir:
- Play Games hesabını etkinleştirmek için verileri Google ile paylaşmanız bağlama özelliğini kullanabilirsiniz.
- Bu paylaşımın yönetilmesini sağlayan ayarların (ör. Play Games) kullanılabilirliği Ayarlar'da devre dışı bırakabilirsiniz.
- Bu tür verilerin Google Gizlilik Politikası Politika.
Jeton ve karakter çifti depolama
- PGS profili olmayan bir kullanıcı, profiliz geri çağırmaya sahip bir oyunu açtığında etkin.
- Games SDK'sı otomatik oturum açmayı tetikler. Bu durum, kullanıcı PGS profili yok.
- Games SDK'sında, kullanıcıya oyunun şu anda sunulmadığını bildiren bir atıştırmalık çubuğu gösteriliyor. Google ile entegrasyon. Bu atıştırmalık çubuğu eyleme dönüştürülebilir. Kullanıcı devre dışı bırakabilir bir profil oluşturulana kadar geri çağırmaya devam eder.
- Oyun, geri çağırma erişimi istiyor. PGS'nin geri çağırma erişim isteklerini reddettiğini unutmayın cihazda PGS profilleri olduğunda veya Google Cihazdaki hesaplar. Bu durumda, oyun şunu kullanmadan devam etmelidir: Play Oyun Hizmetleri.
- Kullanıcı oyun içi hesapla giriş yaptıktan sonra oyun, bir jeton oluşturur ve kullanıcının oyun içi hesabına karşılık gelen karakter çiftidir. Maç bu çifti Google'da saklar. Oyun daha sonra aşağıdaki durumlarda daha fazla jeton depolayabilir: Kullanıcı diğer oyun içi hesaplara giriş yaptığında
Yeni bir cihazda oyun başlatma
- PGS profili olmayan bir kullanıcı, profilsiz geri çağırmanın etkinleştirildiği bir oyunu açar elde edersiniz.
- Oyun, Jetonu depolama bölümünde açıklandığı gibi profiliz bir geri çağırma jetonu kaydediyor ve karakter çifti içermelidir.
- Kullanıcı, aynı hesaba sahip farklı bir cihazda aynı oyunu açar kurulumu.
- Oyunlar SDK'sı profil oluşturma işlemini tetikler. Kullanıcı inceleyebilir ve reddedebilir önceden depolanan geri çağırma jetonlarıdır. Kullanıcı, bu aşamada bir PGS profili oluşturur.
- PGS'de otomatik oturum açma işlemi tamamlanır ve oyun, durumunu kontrol edin.
- Oyun, kullanıcı için her zamanki gibi geri çağırma jetonları alır.
Sonraki adımlar
Recall API'sini istemciniz ve oyun sunucunuzla entegre etmek için aşağıdaki talimatları uygulayın: bu uygulama kılavuzuna başvurun.