هدف گیری

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

این راهنما توضیح می‌دهد که چگونه اطلاعات هدف‌یابی را به درخواست آگهی ارائه دهید.

برای دیدن هدف‌یابی آگهی در عمل، برنامه iOS API Demo را در Swift یا Objective-C بارگیری کنید.

بارگیری نسخه نمایشی API

پیش‌نیازها

پیش‌از ادامه دادن، Google Mobile Ads SDK را راه‌اندازی کنید.

GADRequestConfiguration

GADRequestConfiguration شیئی است که اطلاعات هدف‌یابی را برای اعمال جهانی ازطریق نمونه هم‌رسانی‌شده GADMobileAds جمع‌آوری می‌کند. با کد زیر می‌توان به آن دسترسی پیدا کرد:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

آبجکتیو-سی

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

برای اطمینان از اینکه همه درخواست‌های آگهی تغییرات پیکربندی درخواست را اعمال می‌کنند، پیکربندی درخواست را قبل‌از مقداردهی اولیه Google Mobile Ads SDK تنظیم کنید.

تنظیم رفتار براساس سن

برای کمک به شما در مدیریت رعایت مقررات حریم خصوصی مربوط به کودکان و نوجوانان، Google Mobile Ads SDK تنظیمات رفتار براساس سن را ارائه می‌دهد. تنظیم رفتار با سن به شما امکان می‌دهد مشخص کنید که آیا Google Mobile Ads SDK باید محافظت‌های خاصی را برای ارائه آگهی به کودکان، نوجوانان، یا سن نامشخص اعمال کند یا نه.

می‌توانید بااستفاده از ویژگی ageRestrictedTreatment در GADRequestConfiguration، رفتار مقتضی با سن را تنظیم کنید.

مثال زیر نشان می‌دهد که درخواست‌های آگهی باید با محتوای مناسب کودکان رفتار شود:

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

برای نشان دادن رفتار با نوجوانان یا سن نامشخص، تنظیم .child را با موارد زیر جایگزین کنید:

• .teen
• .unspecified

آبجکتیو-سی

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

برای نشان دادن رفتار با نوجوانان یا سن نامشخص، تنظیم GADAgeRestrictedTreatmentChild را با موارد زیر جایگزین کنید:

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

هنگام استفاده از این تنظیم، Google Mobile Ads SDK پارامتر tfat را در درخواست‌های آگهی لحاظ می‌کند. برای تعیین سن ذی‌ربط برای کاربرانتان براساس تعهدات قانونی و نظارتی خود، با مشاور حقوقی‌تان مشورت کنید. برای اطلاعات بیشتر، به برچسب‌گذاری درخواست آگهی از برنامه برای رفتار با محدودیت سنی مراجعه کنید.

انتقال به درمان سنی از TFCD و TFUA

تنظیمات رفتار براساس سن جایگزین ویژگی‌های منسوخ‌شده tagForChildDirectedTreatment (TFCD) و tagForUnderAgeOfConsent (TFUA) می‌شود.

جدول زیر تنظیمات tagForChildDirectedTreatment و tagForUnderAgeOfConsent و معادل‌های رفتار مناسب سن آن‌ها را نشان می‌دهد:

TFCD

tagForChildDirectedTreatment	درمان سن
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
مقداری به tagForChildDirectedTreatment اختصاص داده نشده است	GADAgeRestrictedTreatmentUnspecified
بدون معادل	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	درمان سن
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
مقداری به tagForUnderAgeOfConsent اختصاص داده نشده است	GADAgeRestrictedTreatmentUnspecified
بدون معادل	GADAgeRestrictedTreatmentTeen

آشنایی با تعاملات درمان سن با TFCD و TFUA

اگر تنظیمات رفتار با سن و تنظیمات TFCD یا TFUA را تنظیم کنید، Google محافظه‌کارانه‌ترین رفتار را اعمال می‌کند.

توجه: برای کاربرانی که به سیستم «حساب‌های Google» مدیریت‌شده با Family Link وارد شده‌اند، به‌طور خودکار همه محتواها برای همه درخواست‌های آگهی به‌عنوان محتوای مختص کودکان درنظر گرفته می‌شود.

درمان سن پیش‌بر با «واسطه‌گری AdMob»

اگر رفتار با سن را بااستفاده از Google Mobile Ads SDK تنظیم کنید، آداپتورهای میانجی سیگنال رفتار با سن را به کیت‌های توسعه نرم‌افزار طرف سوم میانجی‌شده ارسال می‌کنند.

جدول زیر نسخه‌های آداپتور واسطه‌گری را فهرست می‌کند که از بازارسال سیگنال رفتار با محدودیت سنی به کیت توسعه نرم‌افزار طرف سوم واسطه‌گری‌شده پشتیبانی می‌کنند:

نام آداپتور میانجی‌گری	پایین‌ترین نسخه پشتیبانی‌شده
AppLovin	13.6.3.0
BidMachine	3.6.1.1
Bigo	5.2.1.0
Chartboost	9.12.0.1
DTExchange (Fyber)	8.4.7.1
i-mobile	2.3.4.7
InMobi	11.2.0.1
IronSource	9.4.1.0.1
Liftoff Monetize (Vungle)	7.7.2.1
LY Ads (Line Ads)	3.0.1.1
maio	2.2.1.2
Meta (Facebook)	6.21.1.1
Mintegral	8.1.3.1
Moloco	4.6.1.1
MyTarget	5.43.0.0
Pangle	7.9.1.1.1
PubMatic	5.1.0.1
Verve	3.8.1.1

تنظیمات مختص کودکان

هشدار: خصوصیت tagForChildDirectedTreatment منسوخ شده است. درعوض، خصوصیت ageRestrictedTreatment را تنظیم کنید.

برای اهداف قانون محافظت از حریم خصوصی آنلاین کودکان (COPPA)، تنظیمی به‌نام tagForChildDirectedTreatment وجود دارد.

به‌عنوان توسعه‌دهنده برنامه، می‌توانید هنگام درخواست آگهی مشخص کنید که آیا می‌خواهید Google محتوایتان را به‌عنوان محتوای مختص کودکان درنظر بگیرد یا نه. وقتی مشخص می‌کنید که می‌خواهید Google با محتوایتان به‌عنوان محتوای مختص کودکان رفتار کند، Google اقداماتی برای غیرفعال کردن آگهی‌های IBA و بازاریابی مجدد در آن درخواست آگهی انجام می‌دهد. گزینه‌های تنظیمات به‌شرح زیر است:

• tagForChildDirectedTreatment را روی true تنظیم کنید تا نشان دهید می‌خواهید محتوایتان برای اهداف COPPA به‌عنوان محتوای ویژه کودکان درنظر گرفته شود. این کار از انتقال «شناسه تبلیغاتی» (IDFA) جلوگیری می‌کند.
• tagForChildDirectedTreatment را روی false تنظیم کنید تا نشان دهید که نمی‌خواهید محتوایتان برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» به‌عنوان محتوای ویژه کودکان درنظر گرفته شود.
• اگر نمی‌خواهید مشخص کنید که مایلید با محتوایتان ازنظر COPPA چگونه رفتار شود، tagForChildDirectedTreatment را تنظیم نکنید.

مثال زیر نشان می‌دهد که می‌خواهید محتوایتان برای اهداف COPPA به‌عنوان محتوای ساخته‌شده برای کودکان درنظر گرفته شود:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

آبجکتیو-سی

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

با تنظیم این برچسب، گواهی می‌کنید که این اعلان صحیح است و شما مجاز هستید ازطرف مالک برنامه اقدام کنید. می‌دانید که سوءاستفاده از این تنظیم ممکن است منجر به بسته شدن «حساب Google» شما شود.

کاربران زیر سن قانونی

هشدار: خصوصیت tagForUnderAgeOfConsent منسوخ شده است. درعوض، خصوصیت ageRestrictedTreatment را تنظیم کنید.

می‌توانید درخواست‌های آگهی‌تان را علامت‌گذاری کنید تا برای کاربران ساکن منطقه اقتصادی اروپا (EEA) که زیر سن رضایت هستند، رفتار مناسب اعمال شود. این ویژگی برای کمک به تسهیل رعایت مقررات کلی حفاظت از داده (GDPR) طراحی شده است. ممکن است تعهدات قانونی دیگری تحت «مقررات عمومی حفاظت از داده‌ها» داشته باشید. راهنمای اتحادیه اروپا را مرور کنید و با مشاور حقوقی خودتان مشورت کنید. ابزارهای Google برای تسهیل رعایت مقررات طراحی شده‌اند و هیچ ناشر خاصی را از تعهداتش طبق قانون معاف نمی‌کنند. درباره نحوه تأثیر «مقررات کلی حفاظت از داده» بر ناشران بیشتر بدانید.

هنگام استفاده از این ویژگی، پارامتر «برچسب برای کاربران زیر سن قانونی رضایت در اروپا» (TFUA) در همه درخواست‌های آگهی آتی گنجانده خواهد شد. این پارامتر تبلیغات شخصی‌سازی‌شده، ازجمله بازاریابی مجدد، را برای آن درخواست آگهی خاص غیرفعال می‌کند. همچنین درخواست‌ها به فروشندگان آگهی طرف سوم را غیرفعال می‌کند، مانند پیکسل‌های سنجش آگهی و سرورهای آگهی طرف سوم.

با تنظیم کردن ویژگی tagForUnderAgeOfConsent در شیء GADMobileAds.requestConfiguration و ارسال true، می‌توان از این تنظیم برای همه نسخه‌های Google Mobile Ads SDK استفاده کرد.

• tagForUnderAgeOfConsent را روی true تنظیم کنید تا نشان دهید می‌خواهید درخواست‌های آگهی به‌گونه‌ای مدیریت شود که برای کاربران زیر سن رضایت مناسب باشد. این کار همچنین از انتقال «شناسه تبلیغاتی» (IDFA) جلوگیری می‌کند.
• تنظیم نکردن tagForUnderAgeOfConsent نشان می‌دهد که نمی‌خواهید درخواست‌های آگهی به‌شیوه‌ای مناسب برای کاربران زیر سن رضایت مدیریت شود.

مثال زیر نشان می‌دهد که می‌خواهید TFUA در درخواست آگهی شما گنجانده شود:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

آبجکتیو-سی

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

برچسب‌های فعال کردن تنظیم مختص کودکان و tagForUnderAgeOfConsent نباید هم‌زمان روی true تنظیم شوند. اگر این‌طور باشد، تنظیم «مختص کودکان» اولویت دارد.

نکته کلیدی: این پارامتر tagForUnderAgeOfConsent به آداپتورهای میانجی برای منابع آگهی طرف سوم ارسال نمی‌شود. مسئولیت اطمینان از اینکه هر شبکه آگهی طرف سوم در برنامه‌تان آگهی‌هایی را ارائه می‌کند که برای کاربران زیر سن رضایت طبق «مقررات کلی حفاظت از داده» مناسب است، برعهده شما است.

فیلتر کردن محتوای آگهی

برنامه‌ها می‌توانند بااستفاده از ویژگی maxAdContentRating از GADRequestConfiguration، حداکثر رده‌بندی محتوای آگهی را برای همه درخواست‌های آگهی تنظیم کنند. این تنظیم برای همه درخواست‌های آگهی آینده در باقی‌مانده جلسه اعمال می‌شود. مقادیر احتمالی برای این ویژگی براساس طبقه‌بندی‌های برچسب محتوای دیجیتال است و باید یکی از ثابت‌های زیر باشد:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

کد زیر همه درخواست‌های آگهی را پیکربندی می‌کند تا مشخص کند محتوای آگهی برگردانده‌شده باید با تعیین «برچسب محتوای دیجیتال» که بالاتر از GADMaxAdContentRatingGeneral نباشد مطابقت داشته باشد.

نکته کلیدی: تنظیمات فیلتر رده‌بندی محتوا که ازطریق کیت توسعه نرم‌افزار مشخص شده است، بر هرگونه تنظیمات پیکربندی‌شده بااستفاده از میانای کاربر AdMob اولویت دارد.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

آبجکتیو-سی

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (Beta)

‫ Publisher Privacy Treatment (PPT) API ابزاری اختیاری است که به برنامه‌ها اجازه می‌دهد مشخص کنند آیا شخصی‌سازی آگهی‌ها برای همه درخواست‌های آگهی بااستفاده از publisherPrivacyPersonalizationState ویژگی GADRequestConfiguration خاموش شود یا نه. هنگام استفاده از این ویژگی، پارامتر رفتار حریم خصوصی ناشر (PPT) در همه درخواست‌های آگهی آینده برای باقی‌مانده جلسه گنجانده می‌شود.

به‌طور پیش‌فرض، درخواست‌های آگهی به Google آگهی‌های شخصی‌سازی‌شده ارائه می‌دهند. کد زیر شخصی‌سازی آگهی را برای همه درخواست‌های آگهی خاموش می‌کند:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

آبجکتیو-سی

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

توجه: برای درخواست‌های آگهی با چندین سیگنال حریم خصوصی کاربر، محدودکننده‌ترین سیگنال اولویت خواهد داشت. برای نمونه‌های خاص، به اسناد Publisher Privacy Treatment API مراجعه کنید.

GADRequest

شیء GADRequest اطلاعات هدف‌یابی را برای ارسال با درخواست آگهی جمع‌آوری می‌کند.

افزودن موارد اضافی شبکه

موارد اضافی شبکه جزئیات اضافه‌ای هستند که با درخواست آگهی ارسال می‌شوند و مختص یک منبع آگهی هستند.

تکه‌کد زیر یک کلید پارامتر اضافی collapsible با مقدار bottom را برای Google تنظیم می‌کند:

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

آبجکتیو-سی

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

نشانی وب محتوا

هنگام درخواست آگهی، برنامه‌ها می‌توانند نشانی وب محتوایی را که ارائه می‌دهند ارسال کنند. این کار هدف‌یابی کلیدواژه را فعال می‌کند تا آگهی با محتوا مطابقت داده شود.

برای مثال، اگر برنامه‌تان درحال درخواست آگهی است و هم‌زمان محتوایی از https://www.example.com را نشان می‌دهد، می‌توانید این نشانی وب را برای هدف‌یابی کلیدواژه‌های مرتبط ارسال کنید:

Swift

let request = Request()
request.contentURL = "https://www.example.com"

آبجکتیو-سی

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

پرسشگان

وقتی آگهی به‌طور خودکار بازآوری می‌شود، از چه هدف‌یابی‌ای استفاده می‌شود؟

در بازآوری آگهی، از شیء GADRequest که قبلاً مشخص شده است دوباره برای هدف‌یابی استفاده می‌شود. برای تنظیم هدف‌یابی جدید، صراحتاً loadRequest را در GADBannerView با شیء GADRequest جدید فراخوانی کنید.

چگونه پارامترهای هدف‌یابی اضافی را به شبکه‌های میانجی ارسال کنم؟

برای اطلاع از نحوه ارسال هدف‌یابی به شبکه‌های میانجی، میانجی‌گری را ببینید.