Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, treten Sie dem offiziellen Ad Manager-Discord-Kanal auf dem Server der Google Advertising and Measurement Community bei.
In dieser Anleitung werden die Schritte beschrieben, die erforderlich sind, um die Mitteilung zu Bestimmungen von US-Bundesstaaten im Rahmen des UMP SDK zu unterstützen. Ergänzen Sie diese Anleitung mit dem Startleitfaden, in dem beschrieben wird, wie Sie Ihre App mit dem UMP SDK zum Laufen bringen und Ihre Mitteilung einrichten. Die folgenden Hinweise beziehen sich speziell auf die Mitteilung gemäß Verordnungen von US-Bundesstaaten.
Vorbereitung
Führen Sie die folgenden Schritte aus, bevor Sie fortfahren:
Aktualisieren Sie auf die neueste Version des UMP SDK.
Für die Unterstützung von Meldungen zu den Verordnungen der US-Bundesstaaten empfehlen wir die Verwendung von Version
2.1.0
oder höher.
Führen Sie die Schritte unter Jetzt starten aus.
Achten Sie darauf, einen Einstiegspunkt für Datenschutzoptionen zu implementieren und ihn bei Bedarf zu rendern. Wenn Sie diese Anleitung durcharbeiten, haben Sie einen Einstiegspunkt, um Ihren Nutzern Mitteilungen gemäß Verordnungen von US-Bundesstaaten zu präsentieren.
Wenn Sie die Mitteilung gemäß Verordnungen von US-Bundesstaaten zusammen mit anderen Mitteilungen verwenden, lesen Sie den Abschnitt Verfügbare Nutzermitteilungstypen, um zu erfahren, wann Ihren Nutzern die verschiedenen Mitteilungen angezeigt werden.
Tag für minderjährige Nutzer festlegen
Legen Sie
tagForUnderAgeOfConsent (TFUA) fest, um anzugeben, ob ein Nutzer das gesetzlich vorgeschriebene Mindestalter noch nicht erreicht hat. Wenn Sie TFUA auf true festlegen, wird mit dem UMP SDK keine Einwilligung vom Nutzer eingeholt. Wenn Ihre App eine gemischte Zielgruppe hat, legen Sie diesen Parameter für Kinder fest, damit keine Einwilligung eingeholt wird.
Es liegt in Ihrer Verantwortung, diesen Parameter festzulegen, wenn dies zur Einhaltung der COPPA-Bestimmungen und anderer relevanter Vorschriften erforderlich ist.
Im folgenden Beispiel wird TFUA in einer UMP-Einwilligungsanfrage auf „true“ gesetzt:
Swift
// Create a UMPRequestParameters object.letparameters=RequestParameters()// Indicate the user is under age of consent.parameters.isTaggedForUnderAgeOfConsent=true// Request an update for the consent information.ConsentInformation.shared.requestConsentInfoUpdate(with:parameters){[weakself]requestConsentErroringuardletselfelse{return}// ...}
Objective-C
// Create a UMPRequestParameters object.UMPRequestParameters*parameters=[[UMPRequestParametersalloc]init];// Indicate the user is under age of consent.parameters.tagForUnderAgeOfConsent=YES;// Request an update for the consent information.[UMPConsentInformation.sharedInstancerequestConsentInfoUpdateWithParameters:parameterscompletionHandler:^(NSError*_NullablerequestConsentError){// ...}];
Einwilligungsentscheidungen lesen
Nachdem der Nutzer eine Entscheidung gemäß den Verordnungen von US-Bundesstaaten getroffen hat, können Sie seine Auswahl gemäß der Spezifikation der Global Privacy Platform (GPP) aus dem lokalen Speicher lesen. Weitere Informationen finden Sie unter In-App-Details.
Das UMP SDK füllt nur die Schlüssel IABGPP_GppSID und IABGPP_HDR_GppString aus.
Mitteilungen gemäß Verordnungen von US-Bundesstaaten testen
Wenn Sie Mitteilungen gemäß den Verordnungen der US-Bundesstaaten testen möchten, verwenden Sie die UMPDebugGeographyRegulatedUSStatedebugGeography, um das UMP SDK zu zwingen, Ihr Testgerät so zu behandeln, als ob es sich in einem US-Bundesstaat mit entsprechenden Verordnungen befände. Sie können auch UMPDebugGeographyOther verwenden, um das Unterdrücken von Mitteilungen gemäß Verordnungen von US-Bundesstaaten zu erzwingen. Weitere Informationen zu debugGeography finden Sie unter Geografie erzwingen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-06 (UTC)."],[[["\u003cp\u003eThis guide explains how to integrate the US state regulations message into your iOS app using the User Messaging Platform (UMP) SDK.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, update to UMP SDK v2.1.0 or higher, set up a privacy options entrypoint, create a US state regulations message in Ad Manager, and review message display logic.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003etagForUnderAgeOfConsent\u003c/code\u003e parameter in your UMP request to indicate users under the age of consent, crucial for complying with COPPA and other regulations.\u003c/p\u003e\n"],["\u003cp\u003eAccess user consent choices after they interact with the US state regulations message by reading data stored according to the Global Privacy Platform (GPP) specifications.\u003c/p\u003e\n"],["\u003cp\u003eUtilize \u003ccode\u003edebugGeography\u003c/code\u003e settings, such as \u003ccode\u003eUMPDebugGeographyRegulatedUSState\u003c/code\u003e, to simulate different locations and test your implementation thoroughly.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/privacy/us-iab-support \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/privacy/us-iab-support \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/privacy/us-iab-support \"View this page for the Unity platform docs.\")\n\n\u003cbr /\u003e\n\nThis guide outlines the steps required to support the US states regulations\nmessage as part of the UMP SDK. Pair these instructions with\n[Get started](/ad-manager/mobile-ads-sdk/ios/privacy), which details how to get your app running\nwith the UMP SDK and set up your message. The following guidance is specific to\nthe US states regulations message.\n\nPrerequisites\n\nBefore continuing, ensure you do the following:\n\n- Update to the latest version of the UMP SDK. For US states regulations messaging support, we recommend you to use version 2.1.0 or higher.\n- Complete [Get started](/ad-manager/mobile-ads-sdk/ios/privacy). Be sure to implement a privacy options entrypoint and render it if required. By completing this guide, you have an entrypoint to serve your US states regulations message to your users.\n- [Create a US state regulations message](//support.google.com/admanager/answer/10115735) for apps.\n- If you're using the US states regulations message alongside other messages, consult [Available user message types](//support.google.com/admanager/answer/10075998) to understand when different messages are displayed to your users.\n\nSet the tag for under age of consent\n\nTo indicate whether a user is under the age of consent, set\n`\n`[tagForUnderAgeOfConsent](/ad-manager/mobile-ads-sdk/ios/privacy/api/reference/Classes/UMPRequestParameters#tagforunderageofconsent) (TFUA). When you set TFUA to `true`, the UMP SDK\ndoesn't request consent from the user. If your app has a mixed audience, set\nthis parameter for child users to ensure consent is not requested.\nIt is your\nresponsibility for setting this parameter where necessary to comply with COPPA\nand other relevant regulations.\n| **Important:** The UMP SDK does not forward the TFUA tag set on consent requests to the Google Mobile Ads SDK. You must explicitly set the `tagForUnderAgeOfConsent` or `tagForChildDirectectedTreatment` on ad requests. If you don't set the `tagForUnderAgeOfConsent` or `tagForChildDirectectedTreatment` on ad requests, the UMP SDK does not collect any information that allows Google to determine whether or not users under the age of consent use your app. For more information about data processing restrictions for these users, see [Tag an ad request for child-directed treatment](//support.google.com/admanager/answer/3671211).\n\nThe following example sets TFUA to true on a UMP consent request: \n\nSwift \n\n // Create a UMPRequestParameters object.\n let parameters = RequestParameters()\n // Indicate the user is under age of consent.\n parameters.isTaggedForUnderAgeOfConsent = true\n\n // Request an update for the consent information.\n ConsentInformation.shared.requestConsentInfoUpdate(with: parameters) {\n [weak self] requestConsentError in\n guard let self else { return }\n\n // ...\n }\n\nObjective-C \n\n // Create a UMPRequestParameters object.\n UMPRequestParameters \\*parameters = \\[\\[UMPRequestParameters alloc\\] init\\];\n // Indicate the user is under age of consent.\n parameters.tagForUnderAgeOfConsent = YES;\n\n // Request an update for the consent information.\n [UMPConsentInformation.sharedInstance\n requestConsentInfoUpdateWithParameters:parameters\n completionHandler:^(NSError *_Nullable requestConsentError) {\n // ...\n }];\n\nRead consent choices\n\nAfter the user has made a US states regulations decision, you can read\ntheir choice from local storage following the Global Privacy Platform (GPP)\nspec. For more details see,\n[In-App Details](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Core/CMP%20API%20Specification.md#in-app-details).\nNote that the UMP SDK only populates the `IABGPP_GppSID` and\n`IABGPP_HDR_GppString` keys.\n\nTest your US states regulations messaging\n\nTo test your US states regulations messaging, use the\n`UMPDebugGeographyRegulatedUSState` `debugGeography` to force the UMP\nSDK to treat your test device as if the device were located in a regulated US\nstate. You can also use `UMPDebugGeographyOther` to force suppression of US\nstates regulations messages. For more details on `debugGeography`, see\n[Force a geography](/ad-manager/mobile-ads-sdk/ios/privacy#force_a_geography).\n| **Note:** `UMPDebugGeographyRegulatedUSState` is only available in UMP version 2.7.0 or higher."]]