هدف گیری

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

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

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

برای اهداف قانون محافظت از حریم خصوصی آنلاین کودکان (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» شما شود.

می‌توانید درخواست‌های آگهی‌تان را علامت‌گذاری کنید تا برای کاربران ساکن «منطقه اقتصادی اروپا» (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 (Beta)

‫ 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 UI، هدف‌یابی سفارشی را با مقادیر کلید در درخواست آگهی تنظیم کنید. سپس ردیف‌هایی که آن مقادیر کلیدی را هدف‌یابی می‌کنند برای ارائه در آن درخواست آگهی واجدشرایط می‌شوند. برای هدف‌یابی چند مقدار برای یک کلید، مقادیر را به‌صورت رشته‌ای جداشده با کاما وارد کنید.

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 API، نمونه 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 جدید فراخوانی کنید.
چگونه پارامترهای هدف‌یابی اضافی را به شبکه‌های میانجی ارسال کنم؟
برای اطلاع از نحوه ارسال هدف‌یابی به شبکه‌های میانجی، میانجی‌گری را ببینید.