هدف گذاری

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

برای مشاهده هدف گذاری تبلیغات در عمل، برنامه آزمایشی iOS API را در Swift یا Objective-C دانلود کنید.

نسخه ی نمایشی API را دانلود کنید

پیش نیازها

راهنمای شروع را کامل کنید.

GADRequestConfiguration

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

سویفت 

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

هدف-C 

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

تنظیم به کارگردانی کودک

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

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

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

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

سویفت 

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

هدف-C 

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

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

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

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

سویفت 

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

هدف-C 

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

فیلتر کردن محتوای تبلیغاتی

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

سویفت 

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

هدف-C 

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

درمان حریم خصوصی ناشر (بتا)

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

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

سویفت 

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

هدف-C 

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

URL محتوا

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

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

سویفت 

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

هدف-C 

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

هدف گذاری سفارشی

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

سویفت 

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

هدف-C 

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

ایمنی برند (بتا)

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

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

سویفت 

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

هدف-C 

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 انجام می شود:

سویفت 

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

هدف-C 

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

برای پیاده‌سازی شناسه‌های ارائه‌شده ناشر (PPID) در برنامه آزمایشی iOS API، به مثال Ad Manager PPID مراجعه کنید:

Swift Objective-C

ناشر سیگنال هایی را ارائه کرد

می‌توانید مخاطبان و داده‌های متنی را به‌عنوان سیگنال‌های ارائه‌شده ناشر (PPS) در درخواست‌های آگهی ارسال کنید. با PPS، می‌توانید از داده‌های کاربر خود برای بهبود درآمدزایی برنامه‌ای با برقراری ارتباط با ویژگی‌های مخاطبان خود به پیشنهاد دهندگان در همه انواع تراکنش ، با استفاده از طبقه‌بندی استاندارد، بدون نیاز به اشتراک‌گذاری شناسه‌های کاربر، استفاده کنید. ویژگی‌های مخاطب شما می‌تواند شامل داده‌های رفتاری و مبتنی بر علاقه ( IAB Audience Taxonomy 1.1 ) و داده‌های متنی ( IAB Content Taxonomy 2.2 ) باشد.

سویفت 

let extras = GADExtras()
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 = GAMRequest()
request.register(extras)

هدف-C 

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