الاستهداف

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

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

للاطّلاع على كيفية عمل استهداف الإعلانات، نزِّل تطبيق 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 إعدادًا للمعالجة الموجّهة للفئة العمرية. يتيح لك هذا الإعداد الإشارة إلى ما إذا كان يجب أن تطبّق حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إجراءات حماية معيّنة لعرض الإعلانات على الأطفال أو المراهقين أو فئة عمرية غير محدّدة.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 نهائيًا. استخدِم السمة set the ageRestrictedTreatment property.

بدلاً منها.

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

نقطة أساسية: _لا_ تتم إعادة توجيه مَعلمة 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. عند استخدام هذه الميزة، يتم تضمين مَعلمة Publisher Privacy Treatment (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 جديد.

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

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