هدف گذاری

پلتفرم مورد نظر: اندروید، iOS، یونیتی ، فلاتر

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

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

دانلود نسخه آزمایشی API

پیش‌نیازها

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

پیکربندی GADRequest

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

سویفت 

let requestConfiguration = MobileAds.shared.requestConfiguration

هدف-سی 

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

محیط کودک محور

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

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

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

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

سویفت 

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

هدف-سی 

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

این تنظیم را می‌توان با تمام نسخه‌های SDK تبلیغات موبایلی گوگل با تنظیم ویژگی tagForUnderAgeOfConsent در شیء GADMobileAds.requestConfiguration و ارسال مقدار true استفاده کرد.

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

مثال زیر نشان می‌دهد که شما می‌خواهید TFUA در درخواست تبلیغ شما لحاظ شود:

سویفت 

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

هدف-سی 

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

تگ‌هایی که تنظیمات child-directed و tagForUnderAgeOfConsent را فعال می‌کنند، نباید همزمان روی true تنظیم شوند. در این صورت، تنظیمات child-directed اولویت دارد.

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

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

کد زیر تمام درخواست‌های تبلیغ را طوری پیکربندی می‌کند که محتوای تبلیغ برگردانده شده باید با یک برچسب محتوای دیجیتال (Digital Content Label) که بالاتر از GADMaxAdContentRatingGeneral نباشد، مطابقت داشته باشد.

سویفت 

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

هدف-سی 

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

سویفت 

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

هدف-سی 

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

درخواست GAM

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

اضافه کردن امکانات شبکه

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

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

سویفت 

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];

آدرس اینترنتی محتوا

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

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

سویفت 

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

هدف-سی 

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

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

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

سویفت 

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

هدف-سی 

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

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

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

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

سویفت 

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

سویفت 

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

هدف-سی 

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

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

سوئیفت آبجکتیو-سی

سیگنال‌های ارائه شده توسط ناشر

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

سویفت 

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