الاستهداف


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

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

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 للإشارة إلى أنك نحن لا نريد أن يتم التعامل مع المحتوى الخاص بك على أنه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت.
  • تعيين 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.

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