Antworten auf Signale für das Alter verstehen

In diesem Dokument werden die Antworten auf Signale für das Alter erläutert, 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 kannst du die Standardaltersgruppen an das für deine App festgelegte Mindestalter anpassen, indem du dieses Mindestalter in der Google Play Console auf der Seite Signale für das Alter angibst.

  1. Rufen Sie in der Play Console die Seite Alterssignale 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:
    • Für ein Kind im Alter von 0 bis 14 Jahren werden ageLower = 0 und ageUpper = 14 zurückgegeben.
    • Für ein Alter von 15 Jahren oder älter wird ageLower = 15 zurückgegeben.
  • Wenn Sie zwei Mindestalter festlegen (13 und 17):
    • Für ein Kind im Alter von 0 bis 12 Jahren werden ageLower = 0 und ageUpper = 12 zurückgegeben.
    • Für einen 13- bis 16-Jährigen werden ageLower = 13 und ageUpper = 16 zurückgegeben.
    • Für Personen ab 17 Jahren wird ageLower = 17 zurückgegeben.
  • Wenn Sie drei Mindestalter festlegen (11, 13 und 15):
    • Für ein Kind im Alter von 0 bis 10 Jahren werden ageLower = 0 und ageUpper = 10 zurückgegeben.
    • Für ein 11- oder 12-jähriges Kind werden ageLower = 11 und ageUpper = 12 zurückgegeben.
    • Für 13- oder 14-Jährige werden ageLower = 13 und ageUpper = 14 zurückgegeben.
    • Für ein Alter von 15 Jahren oder älter wird ageLower = 15 zurückgegeben.

Antwortfelder für Signale für das Alter

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 Google sein Alter mitgeteilt. Google hat diese Informationen möglicherweise nicht bestätigt.
  • TIER_B: Das Alter des Nutzers wird von einem Elternteil oder Erziehungsberechtigten verwaltet.
  • TIER_C*: Das Alter des Nutzers wird anhand einer Kreditkarte, einer E‑Mail-Adresse, eines Selfies, eines amtlichen Ausweises oder einer Steuernummer ermittelt.
  • TIER_D*: Das Alter des Nutzers wird anhand einer Kombination aus amtlichem Ausweis und Selfie-Prüfung oder digitalem Ausweis überprüft.
  • null: Wird zurückgegeben, wenn ageSignalsStatus den Wert NOT_SHARED oder VERIFICATION_REQUIRED hat.
* Wird nur in regulierten Regionen zurückgegeben, in denen ein Altersnachweis obligatorisch ist (z. B. US-TX).
ageLower Ganzzahl
  • 0 bis 18
  • null
Die inklusive Untergrenze der Altersgruppe des Nutzers. Kombinieren Sie es mit ageUpper, um die Altersgruppe zu bestimmen.

Gibt null zurück, wenn ageSignalsStatus den Wert NOT_SHARED oder VERIFICATION_REQUIRED hat.

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

Gibt null für die höchste Altersgruppe (z. B. ab 18 Jahren) zurück oder wenn ageSignalsStatus den Wert NOT_SHARED oder VERIFICATION_REQUIRED hat.

significantChangeStatus Enum
  • GENEHMIGT
  • AUSSTEHEND
  • Abgesagt
  • null
In diesem Fall wird nur in Ländern, in denen wesentliche Änderungen gelten, ein Wert ungleich null zurückgegeben.
  • APPROVED: Die letzte wesentliche Änderung (und alle vorherigen Änderungen) wurde genehmigt.
  • PENDING: Die Eltern haben eine oder mehrere ausstehende wesentliche Änderungen noch nicht genehmigt.
  • DECLINED: Die 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, für die noch keine wesentlichen Änderungen erfasst wurden.
significantChangeApprovalDate Datum
  • DateStamp
  • null
Das Datum des Inkrafttretens der letzten genehmigten wesentlichen Änderung. Alle Änderungen mit einem Datum des Inkrafttretens vor diesem Datum werden ebenfalls genehmigt. Gibt null zurück, wenn keine Änderungen vorhanden sind.

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

installId String
  • Alphanumerisch
  • null
Eine ID, die von Google Play Installationen von Nutzern mit Elternaufsicht zugewiesen wird und dazu dient, Sie über den Widerruf der App-Genehmigung zu informieren. Lesen Sie die Dokumentation zu widerrufenen App-Genehmigungen.

Beispiel 1

Für einen erwachsenen Nutzer, der sein Alter mit einem digitalen Ausweis bestätigt hat, erhalten Sie Folgendes:

  • In einer regulierten Region, in der ein Altersnachweis obligatorisch ist:

    • ageRangeSource ist AgeRangeSource.TIER_D.
    • ageLower ist eine Zahl (z. B. 18).
    • ageUpper ist null.
    • Andere Antwortfelder sind null.
  • In allen anderen Ländern:

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

Beispiel 2

Für einen erwachsenen Nutzer, der sein Alter mit Methoden zur Alterseinschätzung (z. B. Selfie-Bewertung, Kreditkarte oder Steuernummer) bestätigt hat, erhalten Sie Folgendes:

  • In einer regulierten Region, in der ein Altersnachweis obligatorisch ist:

    • ageRangeSource ist AgeRangeSource.TIER_C.
    • ageLower ist eine Zahl (z. B. 18).
    • ageUpper ist null.
    • Andere Antwortfelder sind null
  • In allen anderen Ländern:

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

Beispiel 3

Für Nutzer, die sich in einer Region befinden, in der ein Altersnachweis nicht obligatorisch ist, und die ihn mit Apps teilen, erhalten Sie Folgendes:

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

Beispiel 4

Für einen minderjährigen Nutzer mit Elternaufsicht, dessen Alter von einem Erziehungsberechtigten verwaltet wird, der es mit Apps geteilt 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 5

Für Nutzer, die der Weitergabe des Alters nicht zugestimmt haben (oder deren Eltern nicht zugestimmt haben), erhalten Sie in einer Region, in der der Altersnachweis nicht obligatorisch ist, Folgendes:

  • ageRangeSource ist null.
  • ageLower ist null.
  • 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 aktiven Installationen 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-ID (z. B. „abc123xyz789“).