Antworten auf Signale für das Alter verstehen

In diesem Dokument werden die Antworten auf Signale für das Alter beschrieben, die von der Play Age Signals API zurückgegeben werden.

Optional: Benutzerdefinierte Altersgruppen erhalten

Die Standardaltersgruppen, die von der API zurückgegeben werden, sind 0-12, 13-15, 16-17 und 18+.

Alternativ können Sie die Standardaltersgruppen an das für Ihre App festgelegte Mindestalter anpassen, indem Sie dieses Mindestalter für Ihre App in der Google Play Console auf der Seite Altersangaben angeben.

  1. Rufen Sie in der Play Console die Seite Altersangaben auf.
  2. Geben Sie auf dem Tab Benutzerdefinierte Altersgruppen bis zu drei Mindestalter für Ihre App ein. Die Mindestalter müssen mindestens 2 Jahre auseinanderliegen und können einmal jährlich geändert werden.
  3. Klicken Sie auf Speichern.

Die zurückgegebenen Altersgruppen überschreiben die Standard-API-Antwort. Beispiel:

  • Wenn Sie in der Google Play Console ein Mindestalter (15) festlegen:
    • Bei einem Alter von 0 bis 14 Jahren werden ageLower = 0 und ageUpper = 14 zurückgegeben.
    • Für eine Person, die mindestens 15 Jahre alt ist, wird ageLower = 15 zurückgegeben.
  • Wenn Sie zwei Mindestalter festlegen (13 und 17):
    • Bei einem Kind im Alter von 0 bis 12 Jahren werden ageLower = 0 und ageUpper = 12 zurückgegeben.
    • Bei einem 13- bis 16-Jährigen werden ageLower = 13 und ageUpper = 16 zurückgegeben.
    • Bei einem Alter von 17 Jahren oder mehr wird ageLower = 17 zurückgegeben.
  • Wenn Sie drei Mindestalter festlegen (11, 13 und 15):
    • Bei einem Alter von 0 bis 10 Jahren werden ageLower = 0 und ageUpper = 10 zurückgegeben.
    • Bei einem 11- oder 12-jährigen Kind werden ageLower = 11 und ageUpper = 12 zurückgegeben.
    • Bei einem 13- oder 14-Jährigen werden ageLower = 13 und ageUpper = 14 zurückgegeben.
    • Für eine Person, die mindestens 15 Jahre alt ist, wird ageLower = 15 zurückgegeben.

Antwortfelder für Alterssignale

Die Antwort der Play Age Signals API (Beta) enthält die folgenden Felder und Werte. Sie sind dafür verantwortlich, mithilfe dieser Signale altersgerechte Inhalte anzubieten.

Antwortfeld Typ Werte Beschreibung
ageRangeSource Enum
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: Der Nutzer hat sein Alter selbst angegeben.
  • TIER_B: Das Alter des Nutzers wird von einem Elternteil oder Erziehungsberechtigten verwaltet.
  • TIER_C: Das Alter des Nutzers wird anhand einer Kreditkarte, E-Mail-Adresse, Selfie-Bewertung, eines amtlichen Ausweises oder einer Steuernummer ermittelt.
  • TIER_D: Das Alter des Nutzers wird anhand einer Kombination aus amtlichem Ausweis und Selfie-Bewertung oder digitalem Ausweis überprüft.
  • null: Wird zurückgegeben, wenn ageSignalsStatus NOT_SHARED oder VERIFICATION_REQUIRED ist.
ageLower Ganzzahl
  • 0 bis 18
  • null
Die inklusive Untergrenze der Altersgruppe des Nutzers. Kombinieren Sie sie mit ageUpper, um die Altersgruppe zu bestimmen.

Gibt null zurück, wenn ageSignalsStatus NOT_SHARED oder VERIFICATION_REQUIRED ist.

ageUpper Ganzzahl
  • 2 bis 18
  • null
Die inklusive Obergrenze der Altersgruppe des Nutzers.

Gibt null für das höchste Alterssegment (z. B. 18+) zurück oder wenn ageSignalsStatus NOT_SHARED oder VERIFICATION_REQUIRED ist.

significantChangeStatus Enum
  • GENEHMIGT
  • AUSSTEHEND
  • Abgesagt
  • null
Es wird nur in Gerichtsbarkeiten, in denen erhebliche Änderungen anwendbar sind, ein Wert zurückgegeben, der nicht null ist.
  • GENEHMIGT: Die letzte wesentliche Änderung (und alle vorherigen Änderungen) wurde genehmigt.
  • AUSSTEHEND: Ein Elternteil hat eine oder mehrere ausstehende wesentliche Änderungen noch nicht genehmigt.
  • DECLINED: Eltern haben die Genehmigung für eine oder mehrere wesentliche Änderungen verweigert.
  • null: Wird zurückgegeben für:
    • Alle Konten ohne Elternaufsicht
    • Konten mit Elternaufsicht, in denen noch keine wesentlichen Änderungen aufgezeichnet wurden.
significantChangeApprovalDate Datum
  • DateStamp
  • null
Das Datum des Inkrafttretens der zuletzt genehmigten wesentlichen Änderung. Alle Änderungen mit Gültigkeitsdaten vor diesem Datum werden ebenfalls genehmigt. Gibt null zurück, wenn keine Änderungen vorhanden sind.

Kombinieren Sie sie mit `significantChangeStatus`, um den Freigabestatus für diese wichtige Änderung abzurufen.

installId String
  • Alphanumerisch
  • null
Eine ID, die von Google Play Installationen von Apps durch Nutzer mit Elternaufsicht zugewiesen wird und mit der Sie über den Widerruf der App-Genehmigung informiert werden. Lesen Sie die Dokumentation zu widerrufenen App-Genehmigungen.

Beispiel 1

Wenn ein Nutzer sein Alter mit einem digitalen amtlichen Ausweis bestätigt und diesen mit Apps teilt, erhalten Sie Folgendes:

  • ageRangeSource ist AgeRangeSource.TIER_D.
  • ageLower ist eine Zahl (z. B. 18).
  • ageUpper ist null.
  • Andere Antwortfelder sind null.

Beispiel 2

Für einen erwachsenen Nutzer, der sein Alter angegeben (selbst deklariert) und mit Apps geteilt hat, erhalten Sie Folgendes:

  • ageRangeSource ist AgeRangeSource.TIER_A.
  • ageLower ist eine Zahl (z. B. 18).
  • ageUpper ist null.
  • Andere Antwortfelder sind null.

Beispiel 3

Für einen minderjährigen Nutzer mit Elternaufsicht, dessen Alter von einem Erziehungsberechtigten verwaltet wird, der es an Apps weitergegeben hat, erhalten Sie Folgendes:

  • ageRangeSource ist AgeRangeSource.TIER_B.
  • ageLower ist eine Zahl (z. B. 13).
  • ageUpper ist eine Zahl (z. B. 15).
  • Andere Antwortfelder sind null.

Beispiel 4

Für Nutzer, die der Weitergabe des Alters nicht zugestimmt haben (oder deren Eltern nicht zugestimmt haben), erhalten Sie Folgendes:

  • ageRangeSource ist null.
  • ageLower ist null.
  • ageUpper ist null.
  • Andere Antwortfelder sind null.

Beispiel 5

Wenn ein erwachsener Nutzer, dessen Alter mithilfe von Methoden zur Alterseinschätzung (z. B. Selfie-Analyse, Kreditkarte oder Steuernummer) bestätigt wurde, sein Alter für Apps freigibt, erhalten Sie Folgendes:

  • ageRangeSource ist AgeRangeSource.TIER_C.
  • ageLower ist eine Zahl (z. B. 18).
  • ageUpper ist null.
  • Andere Antwortfelder sind null.

Beispiel 6

Für einen minderjährigen Nutzer mit Elternaufsicht, dessen Alter von einem Erziehungsberechtigten verwaltet wird, mit einer genehmigten wesentlichen Änderung und aktivem Installations-Tracking erhalten Sie Folgendes:

  • ageRangeSource ist AgeRangeSource.TIER_B.
  • ageLower ist eine Zahl (z. B. 13).
  • ageUpper ist eine Zahl (z. B. 15).
  • significantChangeStatus ist SignificantChangeStatus.APPROVED.
  • significantChangeApprovalDate ist ein Datum (z. B. „2026-01-15“).
  • installId ist eine String-Kennung (z. B. „abc123xyz789“).