الاستهداف

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

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

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

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

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

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;

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

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.

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

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