الاستهداف

اختيار النظام الأساسي: Android iOS Unity Flutter

يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف إلى "SDK لإعلانات Google على الأجهزة الجوّالة".

للحصول على مثال عملي، نزِّل تطبيق Android API Demo.

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

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

قبل المتابعة، عليك إعداد Google Mobile Ads SDK.

RequestConfiguration

تجمع RequestConfiguration معلومات الاستهداف التي يتم تطبيقها على مستوى العالم على كل طلب عرض إعلان. للاطّلاع على علامات الاستهداف المتاحة، يُرجى الرجوع إلى مستندات RequestConfiguration.Builder.

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);

لضمان تطبيق جميع طلبات الإعلانات لتغييرات إعدادات الطلب، اضبط إعدادات الطلب قبل بدء Google Mobile Ads SDK.

ضبط المعالجة الموجّهة للفئة العمرية

لمساعدتك في إدارة امتثالك للوائح الخصوصية السارية المتعلّقة بالأطفال والمراهقين، يوفّر Google Mobile Ads SDK إعدادًا خاصًا بالتعامل مع الفئات العمرية. يتيح لك إعداد "التعامل مع الفئة العمرية" تحديد ما إذا كان يجب أن تطبّق Google Mobile Ads SDK إجراءات معيّنة لحماية الأطفال أو المراهقين عند عرض الإعلانات. عند استخدام هذا الإعداد، تتضمّن Google Mobile Ads SDK مَعلمة tfat في طلبات الإعلانات. يُرجى الرجوع إلى مستشارك القانوني لتحديد المعالجة الموجّهة للفئات العمرية المناسبة لمستخدمي موقعك الإلكتروني استنادًا إلى التزاماتك القانونية والتنظيمية. لمزيد من المعلومات، اطّلِع على المقالة وضع علامة على طلب عرض إعلان من تطبيق لمعالجة الطلبات حسب العمر.

يمكنك ضبط المعالجة الموجّهة للفئة العمرية باستخدام طريقة setAgeRestrictedTreatment() من خلال واجهة برمجة التطبيقات RequestConfiguration.Builder.

ضبط إعدادات المعالجة الموجّهة إلى الأطفال

يوضّح المثال التالي أنّه يجب التعامل مع طلبات عرض الإعلانات على أنّها موجّهة إلى الأطفال:

جافا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

ضبط المعالجة الموجّهة للمراهقين

يوضّح المثال التالي أنّه يجب التعامل مع طلبات عرض الإعلانات على أنّها موجّهة إلى المراهقين:

جافا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have teen age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have teen age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

عدم ضبط أي طريقة محدّدة للمعالجة الموجّهة إلى الفئات العمرية

يوضّح المثال التالي أنّه يجب عدم تطبيق أي طريقة محدّدة للمعالجة الموجّهة إلى الفئات العمرية على طلبات عرض الإعلانات:

جافا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have unspecified age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

الترحيل إلى معالجة الطلبات حسب العمر من TFCD وTFUA

يحلّ إعداد المعالجة الموجّهة للفئة العمرية محلّ الإعدادَين المتوقّفَين .setTagForChildDirectedTreatment() (TFCD) و.setTagForUnderAgeOfConsent() (TFUA).

يعرض الجدول التالي إعدادات TFCD وTFUA وما يعادلها من إعدادات المعالجة حسب العمر:

TFCD

TFCD معالجة الطلبات حسب العمر
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
لم يتم تخصيص أي قيمة .setTagForChildDirectedTreatment() AgeRestrictedTreatment.UNSPECIFIED
بدون مكافئ AgeRestrictedTreatment.TEEN

TFUA

TFUA معالجة الطلبات حسب العمر
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
لم يتم تخصيص أي قيمة .setTagForUnderAgeOfConsent() AgeRestrictedTreatment.UNSPECIFIED
بدون مكافئ AgeRestrictedTreatment.TEEN

فهم تفاعلات المعالجة حسب العمر مع علامتَي TFCD وTFUA

في حال ضبط إعدادات معالجة الطلبات حسب العمر وإعدادات TFCD أو TFUA، تطبّق Google الإعدادات الأكثر تحفّظًا.

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

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

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

يمكنك تطبيق الإعداد "موجّه إلى الأطفال" من خلال setTagForChildDirectedTreatment():

  • استخدِم الدالة setTagForChildDirectedTreatment مع TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE للإشارة إلى أنّك تريد التعامل مع المحتوى الخاص بك باعتباره موجّهًا إلى الأطفال بموجب قانون COPPA. يؤدي ذلك إلى منع إرسال المعرّف الإعلاني على Android‏ (AAID).

  • استخدِم الدالة setTagForChildDirectedTreatment مع TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE للإشارة إلى أنّك لا تريد أن يتم التعامل مع محتواك على أنّه موجّه إلى الأطفال بموجب قانون COPPA.

  • استخدِم setTagForChildDirectedTreatment مع TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED إذا كنت لا تريد الإشارة إلى كيفية التعامل مع المحتوى الخاص بك بموجب قانون حماية خصوصية الأطفال على الإنترنت في طلبات الإعلانات.

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForChildDirectedTreatment(
            RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

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

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

كما هو الحال مع الإعدادات الموجّهة إلى الأطفال، تتوفّر طريقة في RequestConfiguration.Builder لضبط المَعلمة TFUA: setTagForUnderAgeOfConsent()، مع الخيارات التالية.

  • استخدِم الدالة setTagForUnderAgeOfConsent() مع TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE للإشارة إلى أنّك تريد أن يتم التعامل مع طلب عرض الإعلان على أنّه موجّه إلى مستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية. ويمنع ذلك أيضًا إرسال المعرّف الإعلاني على Android‏ (AAID).

  • استخدِم الدالة setTagForUnderAgeOfConsent() مع TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE للإشارة إلى أنّك لا تريد أن يتم التعامل مع طلب عرض الإعلان على أنّه موجّه إلى مستخدمين في المنطقة الاقتصادية الأوروبية دون سن الرشد.

  • استخدِم الدالة setTagForUnderAgeOfConsent() مع TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED للإشارة إلى أنّك لم تحدّد ما إذا كان يجب التعامل مع طلب عرض الإعلان على أنّه موجّه إلى مستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية.

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

يجب عدم ضبط العلامات لتفعيل الإعدادات الموجّهة إلى الأطفال وsetTagForUnderAgeOfConsent() معًا في الوقت نفسه على true. وفي حال ضبطهما معًا، يتم منح الأولوية للإعداد الموجّه إلى الأطفال.

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

للامتثال لسياسة الإعلانات غير الملائمة في Google Play، التي تشمل العروض المرتبطة بالإعلان، يجب أن تكون جميع الإعلانات والعروض المرتبطة بها المعروضة داخل تطبيقك ملائمة لتقييم المحتوى في تطبيقك، حتى إذا كان المحتوى بمفرده ممتثلاً لسياسات Google Play.

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

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

  • MAX_AD_CONTENT_RATING_G
  • MAX_AD_CONTENT_RATING_PG
  • MAX_AD_CONTENT_RATING_T
  • MAX_AD_CONTENT_RATING_MA

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

يمكنك الاطّلاع على المقالات التالية:

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

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

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setPublisherPrivacyPersonalizationState(
            RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

طلب عرض الإعلان

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

إضافة تفاصيل إضافية خاصة بالشبكة

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

يضبط مقتطف الرمز التالي مفتاح مَعلمة إضافية بقيمة collapsible مع قيمة bottom في Google:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)

جافا

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);