الاستهداف

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

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

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

تنزيل الإصدار التجريبي من واجهة برمجة التطبيقات

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

قبل المتابعة، عليك إعداد 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" تطبيق إجراءات حماية معيّنة عند عرض الإعلانات للأطفال أو المراهقين أو فئة عمرية غير محدّدة.

يمكنك ضبط إعدادات معالجة الطلبات حسب العمر باستخدام السمة ageRestrictedTreatment في GADRequestConfiguration.

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

Swift

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

للإشارة إلى المعالجة الموجّهة إلى المراهقين أو غير المحدّدة حسب العمر، استبدِل الإعداد .child بما يلي:

• .teen
• .unspecified

Objective-C

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

للإشارة إلى المعالجة الموجّهة إلى المراهقين أو غير المحدّدة، استبدِل الإعداد GADAgeRestrictedTreatmentChild بما يلي:

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

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

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

ملاحظة: بالنسبة إلى المستخدمين الذين سجّلوا الدخول إلى حسابات Google المُدارة باستخدام Family Link، تتم تلقائيًا معالجة كل المحتوى على أنّه موجّه إلى الأطفال في جميع طلبات الإعلانات.

إعادة توجيه معالجة الطلبات حسب العمر من خلال "توسط AdMob"

في حال ضبط المعالجة الموجّهة للفئات العمرية باستخدام Google Mobile Ads SDK، ستعيد محوّلات التوسّط توجيه إشارة المعالجة الموجّهة للفئات العمرية إلى حِزم تطوير البرامج (SDK) التابعة لجهات خارجية والتي يتم التوسّط فيها.

يسرد الجدول التالي إصدارات محوّلات التوسّط التي تتيح إعادة توجيه إشارة المعالجة المحظورة على فئات عمرية معيّنة إلى حزمة تطوير البرامج (SDK) التابعة لجهة خارجية والتي يتم التوسّط فيها:

اسم محوّل التوسّط	الحد الأدنى للإصدار المتوافق
AppLovin	13.6.3.0
BidMachine	3.6.1.1
Bigo	5.2.1.0
Chartboost	9.12.0.1
DTExchange (Fyber)	8.4.7.1
i-mobile	2.3.4.7
InMobi	11.2.0.1
IronSource	9.4.1.0.1
Liftoff Monetize (Vungle)	7.7.2.1
LY Ads (Line Ads)	3.0.1.1
maio	2.2.1.2
Meta (Facebook)	6.21.1.1
Mintegral	8.1.3.1
Moloco	4.6.1.1
MyTarget	5.43.0.0
Pangle	7.9.1.1.1
PubMatic	5.1.0.1
Verve	3.8.1.1

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

تحذير: تم إيقاف سمة tagForChildDirectedTreatment نهائيًا. بدلاً من ذلك، اضبط السمة ageRestrictedTreatment.

لأغراض قانون حماية خصوصية الأطفال على الإنترنت (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 الخاص بك.

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

تحذير: تم إيقاف سمة tagForUnderAgeOfConsent نهائيًا. بدلاً من ذلك، اضبط السمة ageRestrictedTreatment.

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

عند استخدام هذه الميزة، سيتم تضمين مَعلمة "علامة للمستخدمين دون سن الرشد في أوروبا" (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. وفي حال ضبطهما معًا، يتم منح الأولوية للإعدادات المخصّصة للأطفال.

نقطة رئيسية: لا تتم إعادة توجيه مَعلمة 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 (إصدار تجريبي)

‫ Publisher Privacy Treatment (PPT) API هي أداة اختيارية تتيح للتطبيقات تحديد ما إذا كان يجب إيقاف تخصيص الإعلانات لجميع طلبات عرض الإعلانات باستخدام السمة 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 جديد.

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

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