يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف إلى طلب إعلان.
المتطلبات الأساسية
- أكمِل دليل البدء.
إعدادات الطلب
يجمع العنصر RequestConfiguration
إعدادات الضبط العامة لكل طلب إعلان ويتم تطبيقه من خلال استدعاء MobileAds.SetRequestConfiguration()
.
يضبط المثال التالي MobileAds
باستخدام عنصر RequestConfiguration
يتضمّن أرقام تعريف أجهزة الاختبار:
// Configure your RequestConfiguration with Test Device Ids.
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
TestDeviceIds = TestDeviceIds
});
لضمان تطبيق جميع طلبات الإعلانات لتغييرات إعدادات الطلبات، اضبط إعدادات الطلبات قبل تهيئة حزمة تطوير البرامج (SDK).
إعدادات المحتوى الموجّه للأطفال
لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA)، يتوفّر إعداد يُعرف باسم "وضع علامة على المحتوى باعتباره موجّهًا للأطفال". من خلال ضبط علامة التتبّع هذه، أنت تقرّ بأنّ هذا الإشعار دقيق وبأنّك مخوّل بالتصرف نيابةً عن مالك التطبيق. وأنت تدرك أنّ إساءة استخدام هذا الإعداد قد يؤدي إلى إغلاق حسابك على Google.
بصفتك مطوّر تطبيقات، يمكنك الإشارة إلى ما إذا كنت تريد أن تتعامل Google مع المحتوى الخاص بك على أنّه موجّه للأطفال عند إرسال طلب إعلان. إذا أشرت إلى أنّك تريد أن تتعامل Google مع المحتوى الخاص بك على أنّه موجّه للأطفال، تتّخذ حزمة تطوير البرامج (SDK) خطوات لإيقاف الإعلانات التي تستهدف الاهتمامات وإعلانات تجديد النشاط التسويقي في طلب الإعلان هذا.
يمكن استخدام الإعداد مع جميع إصدارات حزمة تطوير البرامج (SDK) الخاصة بخدمات Google Play
من خلال RequestConfiguration.TagForChildDirectedTreatment)
:
اضبط
TagForChildDirectedTreatment
علىTagForChildDirectedTreatment.True
للإشارة إلى أنّك تريد التعامل مع محتواك باعتباره موجّهًا للأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA). يمنع هذا الإعداد إرسال المعرّف الإعلاني على Android (AAID).اضبط
TagForChildDirectedTreatment
علىTagForChildDirectedTreatment.False
للإشارة إلى أنّك لا تريد أن يتم التعامل مع المحتوى الخاص بك باعتباره موجّهًا إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت.اضبط قيمة
TagForChildDirectedTreatment
علىnull
إذا كنت لا تريد تحديد كيفية التعامل مع المحتوى الخاص بك بموجب قانون حماية خصوصية الأطفال على الإنترنت في طلبات الإعلانات.
يوضّح المثال التالي أنّك تريد أن يتم التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون COPPA:
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
TagForChildDirectedTreatment = TagForChildDirectedTreatment.True
});
المستخدمون دون سن الرشد
يمكنك وضع علامة على طلبات إعلاناتك لكي يتم التعامل معها بصفتها موجّهة للمستخدمين تحت سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال للائحة العامة لحماية البيانات (GDPR). يُرجى العلم بأنك قد تتحمّل التزامات قانونية أخرى بموجب اللائحة العامة لحماية البيانات. يُرجى مراجعة إرشادات الاتحاد الأوروبي والرجوع إلى مستشارك القانوني. يُرجى العِلم أنّ أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب القانون.
مزيد من المعلومات عن كيفية تأثير اللائحة العامة لحماية البيانات في الناشرين
عند استخدام هذه الميزة، يتم تضمين مَعلمة "علامة المستخدمين تحت سن الرشد في أوروبا" (TFUA) في طلب الإعلان. تؤدي هذه المَعلمة إلى إيقاف الإعلانات المخصّصة، بما في ذلك تجديد النشاط التسويقي، لجميع طلبات الإعلان. تعمل الميزة أيضًا على إيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية، مثل وحدات البكسل لقياس الإعلانات وخوادم الإعلانات من جهة خارجية.
كما هو الحال مع الإعدادات الموجّهة إلى الأطفال، تتوفّر طريقة في
RequestConfiguration
لضبط المَعلمة TFUA:
TagForUnderAgeOfConsent
،
مع الخيارات التالية.
اضبط
TagForUnderAgeOfConsent
علىTagForUnderAgeOfConsent.True
للإشارة إلى أنّك تريد أن يتم التعامل مع طلب الإعلان على أنّه موجّه إلى مستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية. يمنع هذا الإعداد إرسال المعرّف الإعلاني على Android (AAID).اضبط
TagForUnderAgeOfConsent
علىTagForUnderAgeOfConsent.False
للإشارة إلى أنّك لا تريد أن يتم التعامل مع طلب الإعلان على أنّه موجّه للمستخدمين دون سنّ الرشد في المنطقة الاقتصادية الأوروبية.اضبط
TagForUnderAgeOfConsent
علىnull
للإشارة إلى أنّك لم تحدّد ما إذا كان يجب التعامل مع طلب الإعلان على أنّه موجّه للمستخدمين تحت سن الرشد في المنطقة الاقتصادية الأوروبية.
يوضّح المثال التالي أنّك تريد تضمين TFUA في طلبات الإعلانات:
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
TagForUnderAgeOfConsent = TagForUnderAgeOfConsent.True
});
يجب عدم ضبط العلامات التي تفعّل الإعداد "محتوى موجّه للأطفال"
وTagForUnderAgeOfConsent
معًا في الوقت نفسه على true
.
وفي حال ضبطهما معًا، يتم منح الأولوية لإعداد "موجّه للأطفال".
فلترة محتوى الإعلانات
للامتثال لسياسة الإعلانات غير الملائمة في Google Play، التي تشمل العروض المرتبطة بالإعلان، يجب أن تكون جميع الإعلانات والعروض المرتبطة بها المعروضة داخل تطبيقك ملائمة لتقييم المحتوى في تطبيقك، حتى إذا كان المحتوى بمفرده ممتثلاً لسياسات Google Play.
يمكن أن تساعدك أدوات مثل التقييم الأقصى للمحتوى الإعلاني في التحكم بشكل أكبر في محتوى الإعلانات التي تظهر للمستخدمين. يمكنك ضبط حد أقصى لتقييم المحتوى، وذلك للمساعدة على الامتثال لسياسات النظام الأساسي.
يمكن للتطبيقات ضبط تقييم أقصى للمحتوى الإعلاني لطلبات الإعلانات باستخدام الحقل
MaxAdContentRating
. إنّ إعلانات AdMob التي يتم عرضها عند ضبط هذا الإعداد لها تقييم محتوى
مماثل أو أقل من مستوى الطلب.
تستند القيم المحتملة لهذه البيانات الإضافية الخاصة بالشبكة إلى تصنيفات المحتوى الرقمي، ويجب أن تكون إحدى السلاسل التالية:
MaxAdContentRating.G
MaxAdContentRating.PG
MaxAdContentRating.T
MaxAdContentRating.MA
يضبط المثال التالي عنصر RequestConfiguration
لتحديد أنّ المحتوى الإعلاني المعروض يجب أن يتوافق مع تصنيف المحتوى الرقمي الذي لا يزيد عن G
:
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
MaxAdContentRating = MaxAdContentRating.G
});
مزيد من المعلومات عن ضبط الحد الأقصى لتقييم المحتوى لكل طلب إعلان
طلب الإعلان
يجمع الكائن AdManagerAdRequest
معلومات الاستهداف لطلب الإعلان.
الاستهداف المخصّص
يمكنك تمرير أزواج المفتاح/القيمة المخصّصة لاستهداف بنود حملات "مدير إعلانات Google" من خلال AdManagerAdRequest.AddCustomTargeting()
:
يمرّر المثال التالي العمر المستهدَف المخصّص على النحو التالي: 25
:
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
CustomTargeting = new Dictionary<string, string>
{
{ "age", "25"}
}
};
يستهدف المثال التالي الأفراد الذين تتراوح أعمارهم بين 24 و26 عامًا:
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
CustomTargeting = new Dictionary<string, string>
{
{ "age", "24, 25, 26"}
}
};
استثناءات الفئات
يمكنك إضافة مستوى استبعاد الفئة على مستوى موضع الإعلان إلى طلب باستخدام الحقل
AdManagerAdRequest
CategoryExclusion
:
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
CategoryExclusions = new HashSet<string>
{
"automobile",
"boat"
}
};
المعرّفات المقدَّمة من الناشر
يمكنك ضبط معرّف مقدَّم من الناشر (PPID) لاستخدامه في تحديد عدد مرّات الظهور وتقسيم الجمهور واستهدافه وعرض الإعلانات بالتناوب بشكل تسلسلي وعناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة.
يضبط المثال التالي معرّف مقدّم الخدمة:
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
PublisherProvidedId = "AB123456789"
};
إشارات مقدَّمة من الناشر
يمكنك إرسال بيانات الجمهور والبيانات السياقية كـ إشارات مقدَّمة من الناشر (PPS) في طلبات الإعلانات. باستخدام ميزة "المعالجة الخاصة"، يمكنك استخدام بيانات المستخدمين لتحسين تحقيق الربح آليًا من خلال إبلاغ مقدّمي عروض الأسعار بخصائص شرائح الجمهور في جميع أنواع المعاملات، وذلك باستخدام التصنيفات النموذجية بدون الحاجة إلى مشاركة معرّفات المستخدمين. يمكن أن تشمل خصائص جمهورك بيانات سلوكية وبيانات مستندة إلى الاهتمامات (معايير تصنيف الجمهور 1.1 الصادرة عن مكتب IAB) وبيانات سياقية (معايير تصنيف المحتوى 2.2 الصادرة عن مكتب IAB).
يضبط المثال التالي تصنيف الجمهور إلى شرائح:
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
Extras = new Dictionary<string, string>
{
// Set the demographic to an audience with an "Age Range" of 30-34
// and an interest in mergers and acquisitions.
{ "IAB_AUDIENCE_1_1", "1, 2, 3, 4, 5"},
// Set the content to sedan, station wagon and SUV automotive values.
{ "IAB_AUDIENCE_2_2", "6, 7, 8, 9, 10"},
}
};