هدف گذاری

پلتفرم مورد نظر: اندروید، 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;

درخواست GAD

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

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

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

قطعه کد زیر یک پارامتر اضافی به نام 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 = Request()
request.contentURL = "https://www.example.com"

هدف-سی 

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

سوالات متداول

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