Yaş sinyalleri yanıtlarını anlama

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

(İsteğe bağlı) Özel yaş gruplarını alma

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

Alternatif olarak, varsayılan yaş grupları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. Google Play Console'da Yaş sinyalleri sayfasına gidin.
  2. Özel yaş grupları sekmesinde uygulamanız için en fazla üç minimum yaş değeri 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ş grupları, varsayılan API yanıtını geçersiz kılar. Örneğin:

  • Google Play Console'da tek bir minimum yaş (15) ayarlarsanız:
    • 0-14 yaş arası bir çocuk ageLower = 0 ve ageUpper = 14 değerlerini döndürür.
    • 15 yaşından büyük bir kullanıcı ageLower = 15 değerini döndürür.
  • İki minimum yaş (13 ve 17) ayarlarsanız:
    • 0-12 yaş arası 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 döndürür.
    • 17 yaşından büyük bir kullanıcı ageLower = 17 değerini döndürür.
  • Üç minimum yaş (11, 13 ve 15) ayarlarsanız:
    • 0-10 yaş arası bir çocuk ageLower = 0 ve ageUpper = 10 değerlerini döndürür.
    • 11 veya 12 yaşındaki bir çocuk ageLower = 11 ve ageUpper = 12 değerlerini döndürür.
    • 13 veya 14 yaşındaki bir kullanıcı ageLower = 13 ve ageUpper = 14 değerlerini döndürür.
    • 15 yaşından büyük bir kullanıcı ageLower = 15 değerini döndürür.

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ş bilgisini Google ile paylaşmıştır. Google bu bilgileri doğrulamış veya doğrulamamış olabilir.
  • TIER_B: Kullanıcının yaşı, ebeveyn veya vasi 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şı, hem resmi kimlik hem selfie değerlendirmesi veya dijital kimlik kullanılarak kontrol edilir.
  • null: ageSignalsStatus, NOT_SHARED veya VERIFICATION_REQUIRED olduğunda döndürülür.
* Yalnızca yaş doğrulamanın zorunlu olduğu, yasal düzenlemelere tabi bölgelerde (ör. ABD-TX) döndürülür.
ageLower Tam sayı
  • 0-18
  • ifadesiz
 Kullanıcının yaş grubunun alt sınırı (dahil). Aralığı belirlemek için ageUpper ile birlikte kullanın.

ageSignalsStatus, 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 üst sınırı (dahil).

En yüksek bant (ör. 18+) için veya ageSignalsStatus, NOT_SHARED ya da VERIFICATION_REQUIRED ise null değerini döndürür.
significantChangeStatus Enum
  • ONAYLANDI
  • BEKLEMEDE
  • REDDEDİLDİ
  • ifadesiz
 Bu, 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) onaylandı.
  • BEKLEMEDE: Anne veya baba, bekleyen bir ya da daha fazla önemli değişikliği henüz onaylamadı.
  • DECLINED: Ebeveynler bir veya daha fazla önemli değişikliği onaylamadı.
  • null: Şu durumlarda döndürülür:
    • Gözetimli olmayan tüm hesaplar
    • Henüz önemli bir değişiklik kaydedilmemiş 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 öğrenmek için `significantChangeStatus` ile birleştirin.
installId Dize
  • Alfa-sayısal
  • ifadesiz
 Google Play tarafından gözetimli kullanıcı yüklemelerine atanan ve iptal edilen uygulama onayını size bildirmek için kullanılan kimlik. İptal edilen uygulama onayları ile ilgili dokümanları inceleyin.

1. Örnek

Yaşını dijital kimlik kullanarak doğrulayan yetişkin bir kullanıcı için aşağıdaki bilgileri alırsınız:

  • Yaş doğrulamanın zorunlu olduğu, yasal düzenlemelere tabi bir bölgedeyseniz:

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

  • Her yer:

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

2. Örnek

Yaşını, yaş tahmini yöntemlerini (ör. selfie değerlendirmesi, kredi kartı veya vergi numarası) kullanarak doğrulayan yetişkin kullanıcılar için aşağıdaki bilgileri alırsınız:

  • Yaş doğrulamanın zorunlu olduğu, yasal düzenlemelere tabi bir bölgedeyseniz:

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

  • Her yer:

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

3. Örnek

Yaş doğrulamanın zorunlu olmadığı bir bölgede bulunan ve yaşını uygulamalarla paylaşan 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.

4. Örnek

Yaşı, uygulamalarla paylaşan bir veli tarafından yönetilen gözetimli reşit olmayan 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.

5. Örnek

Yaş doğrulamanın zorunlu olmadığı bir bölgede yaş paylaşımını kabul etmeyen (veya ebeveyni kabul etmeyen) bir kullanıcı için aşağıdakileri alırsınız:

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

6. örnek

Yaşı bir veli tarafından yönetilen, onaylanmış önemli bir değişikliği ve etkin yükleme takibi olan gözetimli bir reşit olmayan kullanıcı 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).
  • significantChangeStatus SignificantChangeStatus.APPROVED.
  • significantChangeApprovalDate bir tarihtir (ör. "2026-01-15").
  • installId, dize tanımlayıcısıdır (ör. "abc123xyz789").
Önceki
Yaş sinyalleri isteyin
Sonraki
Test yaşı sinyalleri