Recall API'si

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:

  1. 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.

    Kullanıcı, PGS ve oyun içinde giriş yapmış
hesap

  2. 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.

    Oyun sunucusu geri çağırma jetonunu Google ile saklar
sunucular

  3. 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.

    Oyun sunucusu, geri çağırma özelliğini kullanarak ilerleme durumunu geri yükledi
jeton

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ı, PGS ile oturum açar

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.

Geliştirici oturum isteğinde bulunuyor
Kimlik

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.

Geliştirici geri çağırmayı alır
jeton

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.

Geliştirici, geri çağırmadaki verileri geri yükler
jeton

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ı, oyun içi hesabıyla oturum açar
hesap

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.

Geliştirici mağazaları geri çağırma jetonu

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 kullanıcı bir oyun açar

  1. PGS profili olmayan bir kullanıcı, profiliz geri çağırmaya sahip bir oyunu açtığında etkin.
  2. Games SDK'sı otomatik oturum açmayı tetikler. Bu durum, kullanıcı PGS profili yok.
  3. 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.
  4. 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.
  5. 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

  1. PGS profili olmayan bir kullanıcı, profilsiz geri çağırmanın etkinleştirildiği bir oyunu açar elde edersiniz.
  2. Oyun, Jetonu depolama bölümünde açıklandığı gibi profiliz bir geri çağırma jetonu kaydediyor ve karakter çifti içermelidir.
  3. Kullanıcı, aynı hesaba sahip farklı bir cihazda aynı oyunu açar kurulumu.
  4. 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.
  5. PGS'de otomatik oturum açma işlemi tamamlanır ve oyun, durumunu kontrol edin.
  6. 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.