الاستهداف

يتيح لك الاستهداف تقديم معلومات عن السياق والجمهور إلى "Google Mobile Ads SDK for React Native" لعرض إعلانات ملائمة للمستخدمين.

يمكنك ضبط الاستهداف على المستويات التالية:

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

يشرح هذا الدليل كيفية تقديم معلومات الاستهداف إلى Google Mobile Ads SDK for React Native.

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

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

ضبط إعدادات الطلب

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

لتطبيق إعدادات الاستهداف من طلب عرض الإعلان الأول، اضبط السمة requestConfiguration عند استدعاء الطريقة initialize:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

استبدِل TEST_DEVICE_HASHED_ID برقم تعريف جهاز اختباري مجزّأ. يحدّد رقم التعريف هذا الجهاز الذي من المفترض أن يتلقّى إعلانات اختبارية.

لتعديل إعدادات الاستهداف بعد إعداد Google Mobile Ads SDK for React Native، يمكنك استدعاء طريقة setRequestConfiguration. تستبدل الطريقة setRequestConfiguration إعدادًا حاليًا وتصبح سارية على طلبات عرض الإعلانات اللاحقة.

يعدّل المثال التالي عنصر RequestConfiguration باستخدام إعدادات استهداف معدَّلة ويطبّق الإعدادات على طلبات عرض الإعلانات:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

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

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

يمكنك ضبط إعدادات معالجة الطلبات حسب العمر باستخدام السمة ageRestrictedTreatment في RequestConfiguration.

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

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

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

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

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

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

يمكنك ضبط التقييم الأقصى للمحتوى الإعلاني لطلبات عرض الإعلانات في تطبيقك باستخدام السمة maxAdContentRating في العنصر RequestConfiguration. بعد ضبط هذا الإعداد، ستحصل الإعلانات على تقييم محتوى مساوٍ لهذا التقييم أو أقل منه. تستند القيم المحتملة لهذا الإعداد إلى تصنيفات المحتوى الرقمي، ويجب أن تكون إحدى الثوابت التالية:

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

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

لمعرفة التفاصيل، يُرجى الاطّلاع على ما يلي:

اختياري: ضبط واجهة برمجة التطبيقات PPT API (إصدار تجريبي)

تتيح لك واجهة برمجة التطبيقات Publisher Privacy Treatment (PPT) تحديد ما إذا كنت تريد إيقاف تخصيص الإعلانات لجميع طلبات عرض الإعلانات باستخدام السمة publisherPrivacyPersonalizationState في العنصر RequestConfiguration. عند استخدام هذه الميزة، يُدرج "Google Mobile Ads SDK for React Native" مَعلمة معالجة خصوصية الناشر (PPT) في جميع طلبات عرض الإعلانات لبقية الجلسة.

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

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

ضبط العنصر AdRequest

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

على عكس الإعدادات العامة التي يتم ضبطها باستخدام طريقة setRequestConfiguration، يتم تمرير عنصر AdRequest إلى طريقة load لفئة شكل الإعلان، مثل InterstitialAd.load لـ "الإعلانات البينية" أو BannerAd.load لـ "إعلانات البانر".

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

لتمرير معلَمات خاصة بالشبكة إلى Google Mobile Ads SDK for React Native، مثل معلَمات الإعلانات القابلة للتصغير، استخدِم السمة extras.

يضبط المثال التالي مفتاح مَعلمة إضافي على collapsible بقيمة bottom:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

تقديم عنوان URL للمحتوى

لتقديم عنوان URL للمحتوى من أجل الإعلانات التي تستهدف المحتوى وأمان العلامة التجارية، أضِف السمة contentUrl:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

يجب ألا يزيد طول عنوان URL للمحتوى عن 512 حرفًا.