هدف گیری

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

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

برای دیدن هدف‌یابی آگهی در عمل، برنامه «نمونه iOS API» را در 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 (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 اقداماتی برای غیرفعال کردن آگهی‌های «علاقه‌محور» و «بازاریابی مجدد» در آن درخواست آگهی انجام می‌دهد. گزینه‌های تنظیمات به‌شرح زیر است:

• برای نشان دادن اینکه می‌خواهید محتوایتان برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» به‌عنوان محتوای ویژه کودکان درنظر گرفته شود، tagForChildDirectedTreatment را روی true تنظیم کنید. این کار از انتقال «شناسه تبلیغاتی» (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 جدید فراخوانی کنید.

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

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