الاستهداف

اختيار النظام الأساسي: Android iOS Unity Flutter

يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف لطلب عرض إعلان.

للاطّلاع على كيفية عمل استهداف الإعلانات، نزِّل تطبيق iOS API Demo في Swift أو Objective-C.

تنزيل تطبيق API Demo

المتطلبات الأساسية

قبل المتابعة، عليك إعداد Google Mobile Ads SDK.

GADRequestConfiguration

GADRequestConfiguration هو عنصر يجمع معلومات الاستهداف ليتم تطبيقها على مستوى العالم من خلال مثيل GADMobileAds المشترَك. ويمكن الوصول إليه باستخدام الرمز البرمجي التالي:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

لضمان تطبيق تغييرات إعدادات الطلب على جميع طلبات عرض الإعلانات، اضبط إعدادات الطلب قبل تهيئة Google Mobile Ads SDK.

ضبط المعالجة الموجّهة للفئة العمرية

لمساعدتك في إدارة امتثالك للوائح الخصوصية السارية المتعلّقة بالأطفال والمراهقين، Google Mobile Ads SDK توفّر إعدادًا للمعالجة الموجّهة للفئة العمرية. يتيح لك إعداد المعالجة الموجّهة للفئة العمرية الإشارة إلى ما إذا كان يجب أن تطبّق Google Mobile Ads SDK إجراءات حماية محدّدة عند عرض الإعلانات للأطفال أو المراهقين. عند استخدام هذا الإعداد، تتضمّن Google Mobile Ads SDK مَعلمة tfat في طلبات عرض الإعلانات. يُرجى الرجوع إلى مستشارك القانوني لتحديد المعالجة الموجّهة للسنّ المعمول به لمستخدميك استنادًا إلى التزاماتك القانونية والتنظيمية. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة وضع علامة على طلب عرض إعلان من تطبيق لمعالجة الطلبات حسب العمر.

يمكنك ضبط المعالجة الموجّهة للفئة العمرية باستخدام السمة ageRestrictedTreatment على GADRequestConfiguration.

ضبط المعالجة الموجّهة للأطفال

يشير المثال التالي إلى أنّه يجب التعامل مع طلبات عرض الإعلانات على أنّها موجّهة إلى الأطفال:

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

Objective-C

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

ضبط المعالجة الموجّهة للمراهقين

يشير المثال التالي إلى أنّه يجب التعامل مع طلبات عرض الإعلانات على أنّها موجّهة إلى المراهقين:

Swift

// Indicates that ad requests should have teen age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen

Objective-C

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

عدم ضبط معالجة موجّهة لفئة عمرية معيّنة

يشير المثال التالي إلى أنّه يجب عدم ضبط معالجة موجّهة لفئة عمرية معيّنة على مستوى طلبات عرض الإعلانات:

Swift

// Indicates that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified

Objective-C

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

نقل البيانات إلى المعالجة الموجّهة للفئة العمرية من علامتَي 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 الإعدادات الأكثر تحفّظًا.

الإعداد الموجّه إلى الأطفال

لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA)، هناك إعداد يُسمّى tagForChildDirectedTreatment.

بصفتك مطوّر تطبيقات، يمكنك الإشارة إلى ما إذا كنت تريد أن تتعامل Google مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال عند إرسال طلب عرض إعلان. عند الإشارة إلى أنّك تريد أن تتعامل Google مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال، تتّخذ Google خطوات لإيقاف الإعلانات التي تستهدف الاهتمامات وإعلانات الزوّار السابقين في طلب عرض الإعلان هذا. في ما يلي خيارات الإعداد:

  • اضبط tagForChildDirectedTreatment على true للإشارة إلى أنّك تريد أن يتم التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون COPPA. يمنع هذا الإجراء نقل المعرّف الإعلاني (IDFA).
  • اضبط tagForChildDirectedTreatment على false للإشارة إلى أنّك لا تريد أن يتم التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون COPPA.
  • لا تضبط tagForChildDirectedTreatment إذا كنت لا تريد الإشارة إلى كيفية التعامل مع المحتوى الخاص بك بموجب قانون COPPA.

يشير المثال التالي إلى أنّك تريد أن يتم التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون COPPA:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

من خلال ضبط هذه العلامة، أنت تقرّ بأنّ هذا الإشعار دقيق وبأنّك مخوّل بالتصرف نيابةً عن مالك التطبيق. وأنت تدرك أنّ إساءة استخدام هذا الإعداد قد يؤدي إلى إغلاق حسابك على Google.

يمكنك وضع علامة على طلبات عرض إعلاناتك لكي يتم التعامل معها بصفتها موجّهة للمستخدمين تحت سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال للائحة العامة لحماية البيانات (GDPR). يُرجى العلم بأنك قد تتحمّل التزامات قانونية أخرى بموجب اللائحة العامة لحماية البيانات. يُرجى مراجعة إرشادات الاتحاد الأوروبي والرجوع إلى مستشارك القانوني. يجب الانتباه إلى أنّ أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب القانون. مزيد من المعلومات عن كيفية تأثير اللائحة العامة لحماية البيانات في الناشرين.

عند استخدام هذه الميزة، سيتم تضمين مَعلمة "علامة المستخدمين تحت سن الرشد في أوروبا" (TFUA) في جميع طلبات عرض الإعلانات المستقبلية. تؤدي هذه المَعلمة إلى إيقاف الإعلانات المخصّصة، بما في ذلك تجديد النشاط التسويقي لطلب عرض الإعلان المحدّد هذا. تعمل الميزة أيضًا على إيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية، مثل وحدات البكسل لقياس الإعلانات وخوادم الإعلانات من جهة خارجية.

يمكن استخدام هذا الإعداد مع جميع إصدارات Google Mobile Ads SDK من خلال ضبط السمة tagForUnderAgeOfConsent في العنصر GADMobileAds.requestConfiguration وتمرير true.

  • اضبط tagForUnderAgeOfConsent على true للإشارة إلى أنّك تريد التعامل مع طلبات عرض الإعلانات بطريقة مناسبة للمستخدمين تحت سن الرشد. يمنع هذا الإجراء أيضًا نقل المعرّف الإعلاني (IDFA).
  • عدم ضبط tagForUnderAgeOfConsent يشير إلى أنّك لا تريد التعامل مع طلبات عرض الإعلانات بطريقة مناسبة للمستخدمين تحت سن الرشد.

يشير المثال التالي إلى أنّك تريد تضمين علامة TFUA في طلب عرض الإعلان:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

يجب عدم ضبط العلامات لتفعيل الإعداد الموجّه إلى الأطفال و tagForUnderAgeOfConsent معًا في الوقت نفسه على true. وفي حال ضبطهما معًا، يتم منح الأولوية للإعداد الموجّه إلى الأطفال.

فلترة محتوى الإعلان

يمكن للتطبيقات ضبط التقييم الأقصى للمحتوى الإعلاني لجميع طلبات عرض الإعلانات باستخدام السمة maxAdContentRating في GADRequestConfiguration. ينطبق هذا الإعداد على جميع طلبات عرض الإعلانات المستقبلية طوال الفترة المتبقية من الجلسة. تستند القيم المحتمَلة لهذه السمة إلى تصنيفات تصنيفات المحتوى الرقمي، ويجب أن تكون إحدى الثوابت التالية:

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

يضبط الرمز البرمجي التالي جميع طلبات عرض الإعلانات لتحديد أنّ محتوى الإعلان الذي يتم عرضه يجب أن يتطابق مع تصنيف المحتوى الرقمي الذي لا يزيد عن GADMaxAdContentRatingGeneral.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

المعالجة الموجّهة للخصوصية للناشرين (إصدار تجريبي)

‫ Publisher Privacy Treatment (PPT) API هي أداة اختيارية تتيح للتطبيقات الإشارة إلى ما إذا كان يجب إيقاف تخصيص الإعلانات لجميع طلبات عرض الإعلانات باستخدام السمة publisherPrivacyPersonalizationState في GADRequestConfiguration. عند استخدام هذه الميزة، يتم تضمين مَعلمة المعالجة الموجّهة للخصوصية للناشرين (PPT) في جميع طلبات عرض الإعلانات المستقبلية طوال الفترة المتبقية من الجلسة.

تعرض طلبات عرض الإعلانات على Google إعلانات مخصّصة تلقائيًا. يوقف الرمز البرمجي التالي تخصيص الإعلانات لجميع طلبات عرض الإعلانات:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GADRequest

يجمع العنصر GADRequest معلومات الاستهداف لإرسالها مع طلب عرض إعلان.

إضافة تفاصيل إضافية خاصة بالشبكة

تفاصيل إضافية خاصة بالشبكة هي تفاصيل إضافية يتم إرسالها مع طلب عرض الإعلان وتكون خاصة بمصدر إعلان واحد.

يضبط مقتطف الرمز البرمجي التالي مفتاح مَعلمة إضافية بقيمة collapsible تساوي bottom على Google:

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

عنوان URL للمحتوى

عند طلب عرض إعلان، يمكن للتطبيقات تمرير عنوان URL للمحتوى الذي تعرضه. يتيح ذلك استهداف الكلمات الرئيسية لمطابقة الإعلان مع المحتوى.

على سبيل المثال، إذا كان تطبيقك يطلب عرض إعلان أثناء عرض محتوى من https://www.example.com، يمكنك تمرير عنوان URL هذا لاستهداف الكلمات الرئيسية ذات الصلة:

Swift

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

Objective-C

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

الأسئلة الشائعة

ما هي معلومات الاستهداف التي يتم استخدامها عند إعادة تحميل الإعلان تلقائيًا؟
عند إعادة تحميل الإعلان، يتم استخدام العنصر GADRequest الذي تم تحديده سابقًا للاستهداف مرة أخرى. لضبط استهداف جديد، عليك استدعاء loadRequest بشكلٍ صريح على GADBannerView باستخدام عنصر GADRequest جديد.
كيف يمكنني تمرير مَعلمات استهداف إضافية إلى شبكات التوسّط؟
يُرجى الاطّلاع على مقالة التوسّط لمعرفة كيفية إرسال معلومات الاستهداف إلى شبكات التوسّط.