الاستهداف

اختيار النظام الأساسي: Android iOS Unity Flutter

يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف لطلب عرض الإعلان.

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

أكمِل دليل الخطوات الأولى.

ضبط الطلب

يجمع الكائن 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 للإشارة إلى أنّك لا تريد أن يتم التعامل مع محتواك على أنّه موجّه إلى الأطفال لأغراض قانون COPPA.
اضبط TagForChildDirectedTreatment على null إذا كنت لا تريد الإشارة إلى الطريقة التي تريد أن يتم بها التعامل مع محتواك في ما يتعلق بقانون COPPA في طلبات الإعلان.

يشير المثال التالي إلى أنّك تريد أن يتم التعامل مع محتواك على أنّه موجّه إلى الأطفال لأغراض قانون 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) في طلبات الإعلان. باستخدام الإشارات المقدَّمة من الناشر، يمكنك استخدام بيانات المستخدمين لتحسين تحقيق الربح الآلي من خلال إبلاغ مقدِّمي عروض الأسعار بخصائص جمهورك في جميع أنواع المعاملات، باستخدام التصنيفات العادية، بدون الحاجة إلى مشاركة معرّفات المستخدمين. يمكن أن تتضمّن خصائص جمهورك بيانات سلوكية وبيانات تستهدف الاهتمامات (تصنيف جمهور IAB 1.1) وبيانات سياقية (تصنيف محتوى IAB 2.2).

يضبط المثال التالي تصنيف الجمهور إلى شرائح:

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"},
    }
};