الاستهداف

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

للاطّلاع على استهداف الإعلانات أثناء التنفيذ، نزِّل تطبيق iOS API Demo في 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 للإشارة إلى أنّك تريد أن يتم التعامل مع المحتوى على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت. ويؤدي ذلك إلى منع إرسال المعرّف الإعلاني، والمعروف باسم معرّف IDFA.
• اضبط القيمة tagForChildDirectedTreatment على false للإشارة إلى أنّك لا تريد أن تتم معاملة المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون COPPA.
• لا تضبط القيمة tagForChildDirectedTreatment إذا كنت لا تريد الإشارة إلى كيفية التعامل مع المحتوى الخاص بك بموجب قانون COPPA.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

المستخدمون الذين تقلّ أعمارهم عن سن الرشد

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

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

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

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

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

Swift

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

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

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

GADRequest

يجمع عنصر GADRequest معلومات targeting لإرسالها مع طلب إعلان.

عنوان 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 جديد.

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

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