Ürünlerimiz hakkında görüşlerinizi paylaşmak ve geri bildirimde bulunmak için Google Advertising and Measurement Community sunucusundaki resmi Ad Manager Discord kanalına katılın.
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu kılavuzda, UMP SDK'sının bir parçası olarak ABD eyalet tüzükleri mesajının desteklenmesi için gereken adımlar özetlenmektedir. Bu talimatları, uygulamanızı UMP SDK ile çalıştırma ve mesajınızı ayarlama hakkında ayrıntılı bilgi veren Başlangıç ile birlikte kullanın. Aşağıdaki yönergeler, ABD eyalet yönetmelikleri mesajına özeldir.
Ön koşullar
Devam etmeden önce aşağıdakileri yaptığınızdan emin olun:
UMP SDK'sının en son sürümüne güncelleyin.
ABD eyaletlerindeki düzenlemelerle ilgili mesajlaşma desteği için 2.1.0 veya daha yeni bir sürümü kullanmanızı öneririz.
Başlayın bölümündeki adımları tamamlayın.
Gizlilik seçenekleri giriş noktası uyguladığınızdan ve gerekirse oluşturduğunuzdan emin olun. Bu rehberi tamamlayarak ABD eyalet tüzükleri mesajınızı kullanıcılarınıza sunmak için bir giriş noktası elde edersiniz.
ABD eyalet yönetmelikleri mesajını diğer mesajlarla birlikte kullanıyorsanız farklı mesajların kullanıcılarınıza ne zaman gösterileceğini anlamak için Kullanılabilen kullanıcı mesajı türleri başlıklı makaleyi inceleyin.
Reşit olma yaşının altındakiler için etiketi ayarlama
Bir kullanıcının reşit olma yaşının altında olup olmadığını belirtmek için
setTagForUnderAgeOfConsent (TFUA) değerini ayarlayın. TFUA'yı true olarak ayarladığınızda UMP SDK
kullanıcıdan izin istemez. Uygulamanızın karma bir kitlesi varsa izin istenmemesi için çocuk kullanıcılar için bu parametreyi ayarlayın.
COPPA ve diğer ilgili düzenlemelere uymak için bu parametreyi gerektiğinde ayarlamak sizin sorumluluğunuzdadır.
başlıklı makaleyi inceleyin.
Aşağıdaki örnekte, UMP izin isteğinde TFUA değeri true olarak ayarlanır:
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){// ...}];
İzin seçeneklerini okuma
Kullanıcı ABD eyalet yönetmelikleriyle ilgili bir karar verdikten sonra, Global Privacy Platform (GPP) spesifikasyonuna uygun olarak yerel depolama alanından kullanıcının seçimini okuyabilirsiniz. Daha fazla bilgi için Uygulama İçi Ayrıntılar bölümüne bakın.
UMP SDK'sının yalnızca IABGPP_GppSID ve IABGPP_HDR_GppString anahtarlarını doldurduğunu unutmayın.
ABD eyalet yönetmelikleri mesajlaşmanızı test etme
ABD eyaletleri düzenlemeleri mesajlaşmanızı test etmek için UMP SDK'sını test cihazınızı düzenlemelere tabi bir ABD eyaletindeymiş gibi değerlendirmeye zorlamak üzere UMPDebugGeographyRegulatedUSStatedebugGeography kullanın. ABD eyalet yönetmelikleri mesajlarının bastırılmasını zorlamak için UMPDebugGeographyOther de kullanabilirsiniz. debugGeography hakkında daha fazla bilgi için Coğrafi konum zorlama başlıklı makaleyi inceleyin.
[null,null,["Son güncelleme tarihi: 2025-08-31 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 you begin, update to the latest UMP SDK, complete the Get Started guide for the UMP SDK, create a US state regulations message in Ad Manager, and review the available user message types.\u003c/p\u003e\n"],["\u003cp\u003eYou can set a tag to indicate if a user is under the age of consent, preventing consent requests for children and ensuring compliance with COPPA.\u003c/p\u003e\n"],["\u003cp\u003eAfter users interact with the message, you can access their choices by reading from local storage following the Global Privacy Platform (GPP) specification.\u003c/p\u003e\n"],["\u003cp\u003eFor testing, use the \u003ccode\u003edebugGeography\u003c/code\u003e setting to simulate your device's location and trigger or suppress US state regulations messages.\u003c/p\u003e\n"]]],[],null,["This 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](/interactive-media-ads/docs/sdks/ios/client-side/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](/interactive-media-ads/docs/sdks/ios/client-side/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`[setTagForUnderAgeOfConsent](/admob/android/privacy/api/reference/com/google/android/ump/ConsentRequestParameters.Builder#public-consentrequestparameters.builder-settagforunderageofconsent-boolean-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\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](/interactive-media-ads/docs/sdks/ios/client-side/privacy#force_a_geography).\n| **Note:** `UMPDebugGeographyRegulatedUSState` is only available in UMP version 2.7.0 or higher."]]
