الاستهداف

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

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

قبل المتابعة، عليك إعداد GMA Next-Gen SDK.

RequestConfiguration

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

يمكنك إنشاء عنصر RequestConfiguration باستخدام علامات الاستهداف التي تحتاج إليها من خلال أداة الإنشاء، ثم ضبط الإعداد من خلال استدعاء MobileAds.setRequestConfiguration().

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

لتطبيق علامات الاستهداف من طلب عرض الإعلان الأول، عليك توفير إعدادات الطلب أثناء تهيئة حزمة SDK:

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

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

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

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

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

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

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

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

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

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.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 في طلبات الإعلان:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.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:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

• ضبط التقييم الأقصى للمحتوى لكل طلب عرض إعلان

• كيفية ضبط التقييم الأقصى للمحتوى الإعلاني لتطبيق أو حساب

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

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

تعرض طلبات الإعلان على Google إعلانات مخصّصة تلقائيًا. يؤدي الرمز التالي إلى إيقاف تخصيص الإعلانات لجميع طلبات الإعلان:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

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

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

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

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

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);