الاستهداف


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

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

RequestConfiguration

RequestConfiguration عبارة عن بنية تجمع معلومات الاستهداف يتم تطبيقها بشكل عام باستخدام الدالة العمومية SetRequestConfiguration().

لتعديل إعدادات الطلب، عليك الحصول على الإعدادات الحالية أولاً. إجراء أي تحديثات مطلوبة، وضبطها على النحو التالي:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

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

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

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

ويمكن تهيئة الإعداد من خلال تعيين tag_for_child_directed_treatment عضو في بنية RequestConfiguration إلى إحدى القيم العددية التالية:

  • تعيين RequestConfiguration::tag_for_child_directed_treatment إلى RequestConfiguration::kChildDirectedTreatmentTrue للإشارة إلى أنك تريد إذا كان المحتوى موجّهًا إلى الأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA).
  • حدِّد القيمة RequestConfiguration::tag_for_child_directed_treatment لسمة RequestConfiguration::kChildDirectedTreatmentFalse للإشارة إلى أنّك لا تريد أن يتم التعامل مع المحتوى على أنّه موجّه إلى الأطفال لأغراض قانون COPPA.
  • حدِّد القيمة RequestConfiguration::tag_for_child_directed_treatment لRequestConfiguration::kChildDirectedTreatmentUnspecified إذا كنت لا تريد تحديد كيفية التعامل مع المحتوى الخاص بك بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA) في طلبات الإعلانات.

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

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

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

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

مثلما هو الحال مع الإعدادات الموجّهة إلى الأطفال، هناك عضو في RequestConfiguration لـ ضبط مَعلمة TFUA: tag_for_under_age_of_consent، والتي قد تكون باستخدام القيم المحتسبة التالية:

  • تعيين RequestConfiguration::tag_for_under_age_of_consent إلى RequestConfiguration::kUnderAgeOfConsentTrue للإشارة إلى أنك تريد طلب إعلان للتعامل مع المستخدمين في المنطقة الاقتصادية الأوروبية (EEA) دون سن الرشد.
  • تعيين RequestConfiguration::tag_for_under_age_of_consent إلى RequestConfiguration::kUnderAgeOfConsentFalse للإشارة إلى أنك تريد طلب إعلان لعدم التعامل مع مستخدمين في المنطقة الاقتصادية الأوروبية (المنطقة الاقتصادية الأوروبية) دون سن الرشد.
  • حدِّد القيمة RequestConfiguration::tag_for_under_age_of_consent لRequestConfiguration::kUnderAgeOfConsentUnspecified للإشارة إلى أنّك لم تحدِّد ما إذا كان يجب التعامل مع طلب الإعلان على أنّه موجّه للمستخدمين في المنطقة الاقتصادية الأوروبية (EEA) الذين تقلّ أعمارهم عن سن الرشد.

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

العلامات لتفعيل الإعداد "موجّه للأطفال" و"المستخدمون دون سن الرشد" يجب ألا يتم تعيينهما على "صواب" في آنٍ واحد. وفي حال ضبطهما معًا، يتم منح الأولوية لإعداد "محتوى موجه إلى الأطفال".

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

يمكن للتطبيقات ضبط الحد الأقصى لتقييم محتوى الإعلانات لطلبات الإعلانات من خلال علامة متغير السلسلة RequestConfiguration::max_ad_content_rating field. إنّ إعلانات AdMob التي يتم عرضها عند ضبط هذا الخيار لها تقييم محتوى يساوي هذا المستوى أو أقلّ منه. تستند القيمة المحتمَلة لهذا الحقل إلى تصنيفات تصنيفات المحتوى الرقمي ويجب أن تكون إحدى القيم التالية المحدَّدة:

  • RequestConfiguration::kMaxAdContentRatingG
  • RequestConfiguration::kMaxAdContentRatingPG
  • RequestConfiguration::kMaxAdContentRatingT
  • RequestConfiguration::kMaxAdContentRatingMA

يعمل الرمز التالي على إعداد بنية RequestConfiguration لتحديد هذا الإعلان يجب أن يتوافق المحتوى المعروض مع تصنيف "لا" لتصنيف المحتوى الرقمي أعلى من G:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

يجمع عنصر AdRequest معلومات الاستهداف لإرسالها مع طلب إعلان.

عنوان URL للمحتوى

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

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

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();