الاستهداف


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

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

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) في لطلبات الإعلان.

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