الاستهداف

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

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

تنزيل الإصدار التجريبي من واجهة برمجة التطبيقات

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

RequestConfiguration

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

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

Kotlin

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

Java

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

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

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

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

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

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

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

  • يُرجى الاتصال برقم 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)

Java

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 للإشارة إلى أنّك تريد أن يتم التعامل مع طلب الإعلان على أنّه موجّه إلى مستخدمين في المنطقة الاقتصادية الأوروبية (EEA) دون سن الرشد. ويؤدي ذلك أيضًا إلى منع إرسال المعرِّف الإعلاني على Android (AAID).

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

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

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

Kotlin

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

Java

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)

Java

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

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

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

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

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

Kotlin

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

Java

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

طلب الإعلان

يجمع عنصر AdManagerAdRequest معلومات targeting لإرسالها مع طلب إعلان.

الاستهداف المخصّص

يمكنك تمرير أزواج مفتاح/قيمة مخصّصة لاستهداف حملات "مدير إعلانات Google" (عناصر السطر) من خلال AdManagerAdRequest.Builder.addCustomTargeting():

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

يمكنك تمرير قيم متعدّدة لمفتاح على شكل قائمة سلاسل. على سبيل المثال، لتحديد عملاء محتملين في منتصف العشرينات بدلاً من 25 عامًا فقط.

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

اطّلِع على مثال الاستهداف المخصّص في "مدير إعلانات Google" لتطبيق الاستهداف المخصّص في تطبيق Android API Demo.

استثناءات الفئات

يمكنك إضافة مستوى استبعاد فئات على مستوى المساحة إلى طلب باستخدام addCategoryExclusion() الطريقة التي يوفّرها AdManagerAdRequest.Builder:

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdManagerAdRequest.Builder()
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

اطّلِع على مثال على استبعادات الفئات في "مدير إعلانات Google" لتطبيق استبعادات الفئات في تطبيق Android API Demo.

المعرّفات المقدَّمة من الناشر

يمكنك ضبط معرّف يقدّمه الناشر (PPID) لاستخدامه في تحديد عدد مرّات الظهور، وتقسيم الجمهور واستهدافه، وعرض الإعلانات بالتناوب التسلسلي، وغيرها من عناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة.

في ما يلي مثال على ضبط معرّف PPID:

Kotlin

val adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Java

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setPublisherProvidedId("AB123456789")
    .build();

اطّلِع على مثال على المعرّف المقدَّم من الناشر (PPID) في "مدير إعلانات Google" لتطبيق المعرّفات المقدَّمة من الناشر (PPID) في تطبيق Android API Demo.

الإشارات المقدَّمة من الناشر

يمكنك إرسال بيانات الجمهور والسياق على أنّها إشارات مقدَّمة من الناشر (PPS) في طلبات الإعلانات. باستخدام ميزة PPS، يمكنك استخدام بيانات المستخدمين لتحسين تحقيق الربح الآلي من خلال إطلاع مقدمي عروض الأسعار على سمات جمهورك في جميع أنواع المعاملات، وذلك باستخدام تصنيفات عادية، بدون الحاجة إلى مشاركة معرّفات المستخدمين. يمكن أن تتضمّن سمات جمهورك بيانات مستندة إلى السلوك والاهتمامات (تصنيف الجمهور 1.1 من IAB) و data السياقية (تصنيف محتوى 2.2 من IAB).

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build()

عنوان URL للمحتوى

لتوفير عنوان URL للمحتوى للإعلانات المستهدَفة حسب المحتوى وأمان العلامة التجارية، يمكنك استدعاء setContentUrl() عند إنشاء AdManagerAdRequest:

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();

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

التطبيقات التي تعرض محتوى ديناميكيًا موجهًا إلى شرائح جمهور مختلفة يمكنها تقديم قائمة قصيرة بعناوين URL باستخدام setNeighboringContentUrls() الطريقة عند إنشاء AdManagerAdRequest:

Kotlin

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

Java

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

يختلف .setNeighboringContentUrls() عن .setContentUrl() في أنّه يُستخدَم فقط للحفاظ على أمان العلامة التجارية.

إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0‏ ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0‏. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers‏. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.

تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)