الاستهداف

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

للاطلاع على استهداف الإعلانات عمليًا، يمكنك تنزيل تطبيق iOS API التجريبي باستخدام Swift أو Objective-C.

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

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

أكمِل دليل البدء.

GADRequestConfiguration

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

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

الموقع باعتباره موجّهًا للأطفال

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

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

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

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

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

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

يجب ألا يتم ضبط كل من العلامات لتفعيل الإعداد الموجّه إلى الأطفال والعلامات tagForUnderAgeOfConsent في آنٍ واحد على true. وإذا كانا كذلك، يتم منح الأولوية للإعداد الموجّه للأطفال.

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

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

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

GADRequest

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

عنوان URL الخاص بالمحتوى

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

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

Swift

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

Objective-C

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

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

ما الاستهداف الذي يتم استخدامه عند تحديث الإعلان تلقائيًا؟

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

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

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