الاستهداف

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

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

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

تنزيل تطبيق API Demo

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

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

RequestConfiguration

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

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

Kotlin

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

جافا

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

لضمان تطبيق التغييرات في إعدادات الطلب على جميع طلبات الإعلانات، اضبط إعدادات الطلب قبل تهيئة Google Mobile Ads SDK (Legacy).

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

لمساعدتك في إدارة امتثالك للوائح الخصوصية السارية المتعلّقة بالأطفال والمراهقين، Google Mobile Ads SDK (Legacy) توفّر إعدادًا للمعالجة الموجّهة للفئة العمرية. يتيح لك هذا الإعداد الإشارة إلى ما إذا كان يجب أن تطبّق Google Mobile Ads SDK (Legacy) إجراءات حماية محدّدة لعرض الإعلانات للأطفال أو المراهقين أو فئة عمرية غير محدّدة.

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

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

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 child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

للإشارة إلى المعالجة الموجّهة للمراهقين أو فئة عمرية غير محدّدة، استبدِل الإعداد CHILD بما يلي:

  • TEEN
  • UNSPECIFIED

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

نقل البيانات إلى المعالجة الموجّهة للفئة العمرية من علامتَي 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 الإعدادات الأكثر تحفّظًا.

إعادة توجيه المعالجة الموجّهة للفئة العمرية باستخدام "توسّط AdMob"

إذا ضبطت المعالجة الموجّهة للفئة العمرية باستخدام Google Mobile Ads SDK (Legacy)، تعيد محوّلات التوسّط توجيه إشارة المعالجة الموجّهة للفئة العمرية إلى حِزم SDK الخارجية التي يتم التوسّط فيها.

يسرد الجدول التالي إصدارات محوّلات التوسّط التي تتيح إعادة توجيه إشارة المعالجة المقيَّدة للقاصرين إلى حزمة SDK الخارجية التي يتم التوسّط فيها:

اسم محوّل التوسّط الحد الأدنى للإصدار المتوافق
AppLovin 13.6.3.0
BidMachine 3.7.1.1
Bigo 5.9.0.1
Chartboost 9.12.1.1
‫DTExchange (Fyber) 8.4.5.1
i-mobile 2.3.2.4
InMobi 11.3.0.1
IronSource 9.4.3.0
‫Liftoff Monetize (Vungle) 7.7.4.2
‫LY (Line) 3.1.1.1
maio 2.0.9.0
‫Meta (Facebook) 6.21.0.4
Mintegral 17.1.61.1
Moloco 4.10.0.0
MyTarget 5.47.1.1
Pangle 8.1.0.3.1
PubMatic 5.1.2.2
Verve 3.9.0.0

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

بموجب قانون حماية خصوصية الأطفال على الإنترنت (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 في طلبات عرض الإعلانات.

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

‫ Publisher Privacy Treatment API هي أداة اختيارية تتيح للتطبيقات الإشارة إلى ما إذا كان يجب إيقاف تخصيص الإعلانات لجميع طلبات عرض الإعلانات باستخدام الطريقة 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);