الاستهداف

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

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

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

تنزيل العرض التوضيحي لواجهة برمجة التطبيقات

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

أكمِل دليل الخطوات الأولى.

GADRequestConfiguration

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

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

لضمان تطبيق جميع طلبات الإعلانات للتغييرات في إعدادات الطلبات، اضبط إعدادات الطلبات قبل إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.

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

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

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

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

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

المستخدمون دون سن الرشد

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

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

يمكن استخدام هذا الإعداد مع جميع إصدارات حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" من خلال ضبط السمة tagForUnderAgeOfConsent على العنصر GADMobileAds.requestConfiguration وتمرير true.

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

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

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

ملاحظة مهمة: لا يتم توجيه المَعلمة tagForUnderAgeOfConsent إلى محوّلات التوسّط لمصادر الإعلانات التابعة لجهات خارجية. وتقع على عاتقك مسؤولية ضمان أنّ كل شبكة إعلانات تابعة لجهة خارجية في تطبيقك تعرض إعلانات مناسبة للمستخدمين الذين لم يبلغوا سن الرشد بموجب اللائحة العامة لحماية البيانات.

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

نقطة أساسية: إنّ إعدادات فلتر تقييم المحتوى المحدّدة من خلال حزمة تطوير البرامج (SDK) تلغي أي إعدادات تم ضبطها باستخدام واجهة مستخدم AdMob.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

بشكلٍ تلقائي، تعرض طلبات الإعلان المُرسَلة إلى Google إعلانات مخصّصة. يؤدي الرمز التالي إلى إيقاف تخصيص الإعلانات لجميع طلبات الإعلانات:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

ملاحظة: بالنسبة إلى طلبات الإعلانات التي تتضمّن إشارات متعدّدة لخصوصية المستخدم، ستكون الأولوية للإشارة الأكثر تقييدًا. يمكنك الاطّلاع على مستندات Publisher Privacy Treatment API للاطّلاع على أمثلة محدّدة.

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 جديد.

كيف يمكنني تمرير مَعلمات استهداف إضافية إلى شبكات التوسّط؟

راجِع التوسّط لمعرفة كيفية إرسال الاستهداف إلى شبكات التوسّط.