هدف گیری

انتخاب پلاتفرم: 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

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

  • .teen
  • .unspecified

آبجکتیو-سی

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

برای نشان دادن درمان نوجوانان یا درمان با سن نامشخص، تنظیم 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 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) 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

تنظیم کودک‌محور

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

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

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

مثال زیر نشان می‌دهد که می‌خواهید محتوای شما برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» به‌عنوان محتوای کودک‌پسند درنظر گرفته شود:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

آبجکتیو-سی

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

می‌توانید درخواست‌های آگهی‌تان را علامت‌گذاری کنید تا برای کاربران زیر سن رضایت در منطقه اقتصادی اروپا (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 تنظیم شوند. اگر این‌طور باشد، تنظیم «محتوای کودک‌پسند» اولویت دارد.

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

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

آبجکتیو-سی

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

پردازش حریم خصوصی ناشر (نسخه بتا)

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

آبجکتیو-سی

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

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

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

تکه‌کد زیر کلید پارامتر اضافی 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 = AdManagerRequest()
request.contentURL = "https://www.example.com"

آبجکتیو-سی

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

هدف‌یابی سفارشی

پس‌از پیکربندی جفت‌های کلید-مقدار در «واسط کاربر Ad Manager»، هدف‌یابی سفارشی را با مقادیر کلید در درخواست آگهی تنظیم کنید. ردیف‌های آگهی که آن مقادیر کلیدی را هدف‌یابی می‌کنند سپس برای ارائه در آن درخواست آگهی واجدشرایط می‌شوند. برای هدف‌یابی چند مقدار برای یک کلید، مقادیر را به‌صورت رشته‌ای جداشده با کاما وارد کنید.

Swift

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

آبجکتیو-سی

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

ایمنی نمانام (نسخه بتا)

برنامه‌هایی که محتوای پویای درنظرگرفته‌شده برای مخاطبان مختلف را نمایش می‌دهند می‌توانند ازطریق دارایی neighboringContentURLs فهرست کوتاهی از نشانی‌های وب ارائه دهند. نشانی‌های وب محتوای همسایه با دارایی contentURL تفاوت دارند زیرا فقط برای ایمنی نمانام استفاده می‌شوند.

فرض کنید برنامه شما محتوای چهار نشانی وب را در فیدی نمایش می‌دهد که حاوی آگهی نیز هست. می‌توانید آگهی‌هایی را درخواست کنید که رده‌بندی محتوای مشابهی با آن نشانی‌های وب داشته باشند، با ارسال آن‌ها به این صورت:

Swift

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

آبجکتیو-سی

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

شناسه‌های ناشرداده

می‌توانید شناسه ارائه‌شده توسط ناشر (PPID) را برای استفاده در حدگذاری تکرار آگهی، بخش‌بندی و هدف‌یابی مخاطب، چرخش آگهی ترتیبی، و دیگر کنترل‌های ارائه آگهی مبتنی بر مخاطب در سراسر دستگاه‌ها تنظیم کنید.

تنظیم PPID ازطریق GAMRequest انجام می‌شود:

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

آبجکتیو-سی

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

برای پیاده‌سازی شناسه‌های ناشرداده (PPID) در برنامه «نمونه میانای برنامه‌سازی کاربردی iOS»، مثال Ad Manager PPID را ببینید:

Swift Objective-C

نشان‌های ناشرداده

می‌توانید داده‌های مخاطب و زمینه‌ای را به‌عنوان نشان‌های ناشرداده (PPS) در درخواست‌های آگهی ارسال کنید. با «سیستم پیشنهاد قیمت خصوصی»، می‌توانید با انتقال ویژگی‌های مخاطبانتان به پیشنهاددهندگان قیمت در همه انواع تراکنش، بااستفاده از طبقه‌بندی‌های استاندارد، بدون نیاز به هم‌رسانی شناسه‌های کاربر، از داده‌های کاربرتان برای بهبود درآمدزایی برنامه‌ریزی‌شده استفاده کنید. ویژگی‌های مخاطب شما می‌تواند شامل داده‌های رفتاری و مبتنی بر علاقه ( طبقه‌بندی مخاطب IAB نسخه ۱.۱) و داده‌های زمینه‌ای ( طبقه‌بندی محتوای IAB نسخه ۲.۲) باشد.

Swift

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

آبجکتیو-سی

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

پرسشگان

وقتی آگهی به‌طور خودکار بازآوری می‌شود، از چه هدف‌یابی استفاده می‌شود؟
در بازآوری آگهی، از هدف GAMRequest که قبلاً مشخص شده است دوباره برای هدف‌یابی استفاده می‌شود. برای تنظیم هدف‌یابی جدید، loadRequest را در GAMBannerView با شیء GAMRequest جدید صراحتاً فراخوانی کنید.
چگونه پارامترهای هدف‌یابی اضافی را به شبکه‌های واسطه‌گری منتقل کنم؟
برای اطلاع از نحوه ارسال هدف‌یابی به شبکه‌های واسطه‌گری، واسطه‌گری را ببینید.