Yaş sinyalleri yanıtlarını anlama

Bu belgede, Play Age Signals API tarafından döndürülen yaş sinyali yanıtları açıklanmaktadır.

(İsteğe bağlı) Özel yaş aralıkları alma

API'nin döndürdüğü varsayılan yaş aralıkları 0-12, 13-15, 16-17 ve 18+'dür.

Dilerseniz varsayılan yaş aralıklarını uygulamanızın minimum yaşlarına göre özelleştirmek için Google Play Console'daki Yaş sinyalleri sayfasında uygulamanızın minimum yaşlarını belirtebilirsiniz.

  1. Play Console'da Yaş sinyalleri sayfasına gidin.
  2. Özel yaş aralıkları sekmesinde uygulamanız için en fazla üç minimum yaş girin. Minimum yaşlar arasında en az 2 yıl fark olmalıdır ve bu ayar yılda yalnızca bir kez değiştirilebilir.
  3. Kaydet'i tıklayın.

Döndürülen yaş aralıkları, varsayılan API yanıtını geçersiz kılar. Örneğin:

  • Google Play Console'da tek bir minimum yaş (15) belirlediyseniz:
    • 0-14 yaş aralığındaki bir kullanıcı ageLower = 0 ve ageUpper = 14 değerlerini döndürür.
    • 15 yaşından büyük kullanıcılar ageLower = 15.
  • İki minimum yaş (13 ve 17) belirlediyseniz:
    • 0-12 yaş aralığındaki bir çocuk için ageLower = 0 ve ageUpper = 12 döndürülür.
    • 13-16 yaş arası bir kullanıcı ageLower = 13 ve ageUpper = 16 değerlerini döndürür.
    • 17 yaşından büyük bir kullanıcı ageLower = 17 döndürür.
  • Üç minimum yaş (11, 13 ve 15) belirlediyseniz:
    • 0-10 yaş aralığındaki bir kullanıcı ageLower = 0 ve ageUpper = 10 değerlerini döndürür.
    • 11 veya 12 yaşındaki çocuklar ageLower = 11 ve ageUpper = 12 uygulamalarına geri döner.
    • 13 veya 14 yaşındaki bir çocuk ageLower = 13 ve ageUpper = 14 için geri döner.
    • 15 yaşından büyük kullanıcılar ageLower = 15.

Yaş sinyalleri yanıt alanları

Google Play Age Signals API (Beta) yanıtı aşağıdaki alanları ve değerleri içerir. Bu sinyalleri kullanarak yaşa uygun deneyimler sunmak sizin sorumluluğunuzdadır.

Yanıt alanı Tür Değerler Açıklama
ageRangeSource Enum
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • ifadesiz
  • TIER_A: Kullanıcı, yaşını kendisi beyan etmiştir.
  • TIER_B: Kullanıcının yaşı, ebeveyn veya veli tarafından yönetilir.
  • TIER_C: Kullanıcının yaşı, kredi kartı, e-posta adresi, selfie değerlendirmesi, resmi kimlik veya vergi numarası kullanılarak değerlendirilir.
  • TIER_D: Kullanıcının yaşı, resmi kimlik ve selfie değerlendirmesi ya da dijital kimlik kullanılarak kontrol edilir.
  • null: ageSignalsStatus, NOT_SHARED veya VERIFICATION_REQUIRED olduğunda döndürülür.
ageLower Tam sayı
  • 0-18
  • ifadesiz
Kullanıcının yaş grubunun alt sınırı (dahil). Yaş aralığını belirlemek için ageUpper ile birlikte kullanın.

ageSignalsStatus değeri NOT_SHARED veya VERIFICATION_REQUIRED ise null değerini döndürür.

ageUpper Tam sayı
  • 2-18
  • ifadesiz
Kullanıcının yaş grubunun dahil edici üst sınırı.

En yüksek bant (ör. 18 yaş ve üzeri) için veya ageSignalsStatus değeri NOT_SHARED ya da VERIFICATION_REQUIRED ise null değerini döndürür.

significantChangeStatus Enum
  • ONAYLANDI
  • BEKLEMEDE
  • REDDEDİLDİ
  • ifadesiz
Bu işlev yalnızca önemli değişikliklerin geçerli olduğu yargı alanlarında boş olmayan bir değer döndürür.
  • ONAYLANDI: En son önemli değişiklik (ve önceki tüm değişiklikler) onaylanmıştır.
  • BEKLEMEDE: Ebeveyn, bekleyen önemli değişikliklerden birini veya daha fazlasını henüz onaylamamıştır.
  • REDDEDİLDİ: Ebeveynler, bir veya daha fazla önemli değişikliği onaylamadı.
  • null: Şu öğe için döndürüldü:
    • Gözetimsiz tüm hesaplar
    • Henüz önemli bir değişiklik kaydedilmemiş olan, gözetimli hesaplar.
significantChangeApprovalDate Tarih
  • DateStamp
  • ifadesiz
En son onaylanan önemli değişikliğin geçerlilik tarihi. Geçerlilik tarihi bu tarihten önce olan tüm değişiklikler de onaylanır. Değişiklik yoksa null değerini döndürür.

Bu önemli değişikliğin onay durumunu almak için `significantChangeStatus` ile birleştirin.

installId Dize
  • Alfa-sayısal
  • ifadesiz
Google Play tarafından denetimli kullanıcı yüklemelerine atanan ve uygulama onayının iptal edildiği konusunda sizi bilgilendirmek için kullanılan kimlik. İptal edilen uygulama onayları ile ilgili dokümanları inceleyin.

1. Örnek

Yaşını dijital kimlik kullanarak doğrulayan ve bu kimliği uygulamalarla paylaşan bir kullanıcı için aşağıdakileri alırsınız:

  • ageRangeSource AgeRangeSource.TIER_D.
  • ageLower bir sayıdır (örneğin, 18).
  • ageUpper null.
  • Diğer yanıt alanları null.

2. Örnek

Yaşını beyan eden (kendi beyanı) ve uygulamalarla paylaşan yetişkin bir kullanıcı için aşağıdakileri alırsınız:

  • ageRangeSource AgeRangeSource.TIER_A.
  • ageLower bir sayıdır (örneğin, 18).
  • ageUpper null.
  • Diğer yanıt alanları null.

3. Örnek

Yaşı, uygulamalarla paylaşan bir veli tarafından yönetilen gözetimli küçük kullanıcılar için aşağıdakileri alırsınız:

  • ageRangeSource AgeRangeSource.TIER_B.
  • ageLower bir sayıdır (örneğin, 13).
  • ageUpper bir sayıdır (örneğin, 15).
  • Diğer yanıt alanları null.

4. Örnek

Yaş paylaşımını kabul etmeyen (veya ebeveyni tarafından kabul edilmeyen) bir kullanıcı için:

  • ageRangeSource null.
  • ageLower null.
  • ageUpper null.
  • Diğer yanıt alanları null.

5. Örnek

Yaş tahmini yöntemleri (ör. selfie değerlendirmesi, kredi kartı veya vergi numarası) kullanılarak yaşı doğrulanmış ve bu bilgiyi uygulamalarla paylaşan yetişkin kullanıcılar için aşağıdakileri alırsınız:

  • ageRangeSource AgeRangeSource.TIER_C.
  • ageLower bir sayıdır (örneğin, 18).
  • ageUpper null.
  • Diğer yanıt alanları null.

6. örnek

Yaşı bir veli tarafından yönetilen, gözetimli küçük kullanıcılar için onaylanmış önemli bir değişiklik ve etkin yükleme izleme özelliğiyle birlikte aşağıdakileri alırsınız:

  • ageRangeSource AgeRangeSource.TIER_B.
  • ageLower bir sayıdır (örneğin, 13).
  • ageUpper bir sayıdır (örneğin, 15).
  • significantChangeStatus SignificantChangeStatus.APPROVED.
  • significantChangeApprovalDate bir tarihtir (örneğin, "2026-01-15").
  • installId, dize tanımlayıcıdır (örneğin, "abc123xyz789").