الاستهداف

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

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

للاطّلاع على استهداف الإعلانات أثناء التنفيذ، نزِّل تطبيق iOS API Demo بلغة Swift أو Objective-C.

تنزيل العرض التوضيحي لواجهة برمجة التطبيقات

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

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

GADRequestConfiguration

GADRequestConfiguration هو عنصر يجمع معلومات الاستهداف ليتم تطبيقها على مستوى العالم من خلال مثيل GADMobileAds المشترك. ويمكن الوصول إليه باستخدام الرمز التالي:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

لضمان تطبيق جميع طلبات الإعلانات لتغييرات إعدادات الطلب، اضبط إعدادات الطلب قبل بدء Google Mobile Ads SDK.

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

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

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

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

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

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

• .teen
• .unspecified

Objective-C

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

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

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

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

الترحيل إلى إعدادات معالجة الطلبات حسب العمر من TFCD وTFUA

يحلّ إعداد المعالجة الموجّهة للفئة العمرية محلّ السمتَين المتوقّفتَين tagForChildDirectedTreatment (TFCD) وtagForUnderAgeOfConsent (TFUA).

يعرض الجدول التالي إعدادات tagForChildDirectedTreatment وtagForUnderAgeOfConsent وما يعادلها من فئات عمرية:

TFCD

tagForChildDirectedTreatment	معالجة الطلبات حسب العمر
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
لم يتم تخصيص أي قيمة لـ tagForChildDirectedTreatment	GADAgeRestrictedTreatmentUnspecified
بدون مكافئ	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	معالجة الطلبات حسب العمر
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
لم يتم تخصيص أي قيمة لـ tagForUnderAgeOfConsent	GADAgeRestrictedTreatmentUnspecified
بدون مكافئ	GADAgeRestrictedTreatmentTeen

فهم تفاعلات المعالجة حسب العمر مع علامتَي TFCD وTFUA

في حال ضبط إعدادات معالجة الطلبات حسب العمر وإعدادات TFCD أو TFUA، تطبّق Google الإعدادات الأكثر تحفّظًا.

ملاحظة: يتم تلقائيًا التعامل مع جميع طلبات عرض الإعلانات على أنّها موجّهة إلى الأطفال بالنسبة إلى المستخدمين الذين سجّلوا الدخول إلى حسابات Google المُدارة من خلال Family Link.

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

تحذير: تم إيقاف السمة tagForChildDirectedTreatment نهائيًا. بدلاً من ذلك، اضبط السمة ageRestrictedTreatment.

لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA)، يتوفّر إعداد يُعرف باسم tagForChildDirectedTreatment.

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

• اضبط قيمة tagForChildDirectedTreatment على true للإشارة إلى أنّك تريد التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA). يمنع ذلك إرسال المعرّف الإعلاني (IDFA).
• اضبط قيمة tagForChildDirectedTreatment على false للإشارة إلى أنّك لا تريد أن يتم التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال بموجب قانون COPPA.
• لا تضبط قيمة tagForChildDirectedTreatment إذا كنت لا تريد الإشارة إلى طريقة التعامل مع المحتوى الخاص بك بما يتوافق مع قانون حماية خصوصية الأطفال على الإنترنت (COPPA).

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

المستخدمون دون سن الرشد

تحذير: تم إيقاف السمة tagForUnderAgeOfConsent نهائيًا. بدلاً من ذلك، اضبط السمة ageRestrictedTreatment.

يمكنك وضع علامة على طلبات إعلاناتك لكي يتم التعامل معها بصفتها موجّهة للمستخدمين تحت سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال للائحة العامة لحماية البيانات (GDPR). يُرجى العلم بأنك قد تتحمّل التزامات قانونية أخرى بموجب اللائحة العامة لحماية البيانات. يُرجى مراجعة إرشادات الاتحاد الأوروبي والرجوع إلى مستشارك القانوني. يُرجى العِلم أنّ أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب القانون. مزيد من المعلومات عن كيفية تأثير اللائحة العامة لحماية البيانات في الناشرين

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

يمكن استخدام هذا الإعداد مع جميع إصدارات Google Mobile Ads SDK من خلال ضبط السمة tagForUnderAgeOfConsent على الكائن GADMobileAds.requestConfiguration وتمرير true.

• اضبط قيمة tagForUnderAgeOfConsent على true للإشارة إلى أنّك تريد أن يتم التعامل مع طلبات عرض الإعلانات بطريقة مناسبة للمستخدمين تحت سن الرشد. يمنع هذا الإجراء أيضًا نقل المعرّف الإعلاني (IDFA).
• عدم ضبط tagForUnderAgeOfConsent يشير إلى أنّك لا تريد أن يتم التعامل مع طلبات الإعلانات بطريقة مناسبة للمستخدمين الذين تقلّ أعمارهم عن سن الرشد.

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

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

يجب عدم ضبط العلامتَين اللتين تتيحان إعداد المحتوى الموجّه إلى الأطفال وtagForUnderAgeOfConsent على القيمة true في الوقت نفسه، لأنّ إعداد المحتوى الموجّه إلى الأطفال سيكون له الأولوية.

ملاحظة مهمة: لا يتم إعادة توجيه المَعلمة tagForUnderAgeOfConsent إلى برامج التوسّط الخاصة بمصادر الإعلانات التابعة لجهات خارجية. وتقع على عاتقك مسؤولية التأكّد من أنّ كل شبكة إعلانات تابعة لجهة خارجية في تطبيقك تعرض إعلانات مناسبة للمستخدمين الذين لم يبلغوا سن الرشد بموجب اللائحة العامة لحماية البيانات.

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

يضبط الرمز التالي جميع طلبات الإعلانات لتحديد أنّ محتوى الإعلان المعروض يجب أن يتوافق مع تصنيف "تصنيف المحتوى الرقمي" لا يزيد عن GADMaxAdContentRatingGeneral.

ملاحظة مهمة: إنّ إعدادات فلتر التقييم حسب الفئة العمرية المحدّدة من خلال حزمة SDK تلغي أي إعدادات تم ضبطها باستخدام واجهة مستخدم "مدير إعلانات Google".

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

ملاحظة: بالنسبة إلى طلبات الإعلانات التي تتضمّن إشارات متعدّدة لخصوصية المستخدم، ستكون الأولوية للإشارة الأكثر تقييدًا. راجِع مستندات Publisher Privacy Treatment API للاطّلاع على أمثلة محدّدة.

GAMRequest

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

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

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

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

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

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

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

على سبيل المثال، إذا كان تطبيقك يطلب عرض إعلان أثناء عرض محتوى من https://www.example.com، يمكنك تمرير عنوان URL هذا لاستهداف الكلمات الرئيسية ذات الصلة:

Swift

let request = AdManagerRequest()
request.contentURL = "https://www.example.com"

Objective-C

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

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

بعد ضبط أزواج المفتاح/القيمة في واجهة مستخدم "مدير إعلانات Google"، اضبط الاستهداف المخصّص باستخدام قيم المفاتيح في طلب عرض إعلان. بعد ذلك، تصبح البنود الإعلانية التي تستهدف قيم المفاتيح هذه مؤهَّلة للعرض في طلب عرض الإعلان هذا. لاستهداف قيم متعدّدة لمفتاح واحد، أدخِل القيم كسلسلة مفصولة بفواصل.

Swift

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

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

يمكن للتطبيقات التي تعرض محتوًى ديناميكيًا موجّهًا إلى شرائح جمهور مختلفة أن تقدّم قائمة قصيرة بعناوين URL من خلال السمة neighboringContentURLs. تختلف عناوين URL الخاصة بالمحتوى المجاور عن السمة contentURL في أنّه يتم استخدامها فقط لضمان ملاءمة المحتوى مع العلامة التجارية.

لنفترض أنّ تطبيقك يعرض محتوًى من أربعة عناوين URL في خلاصة تحتوي أيضًا على إعلانات. يمكنك طلب إعلانات تتضمّن التقييم حسب الفئة العمرية للمحتوى المشابه لعناوين URL هذه من خلال تمريرها على النحو التالي:

Swift

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

ملاحظة مهمة: تستخدم حزمة تطوير البرامج (SDK) أول أربعة عناوين URL فقط، ويتم تجاهل جميع العناوين الأخرى.

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

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

ملاحظة: لا تتوفّر هذه الميزة لجميع الناشرين. يمكنك الاطّلاع على لمحة عن المعرّفات المقدَّمة من الناشر للحصول على التفاصيل.

يتم ضبط المعرّف المقدَّم من الناشر (PPID) من خلال GAMRequest:

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

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

Swift Objective-C

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

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

Swift

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

الأسئلة الشائعة

ما هو الاستهداف المستخدَم عند إعادة تحميل إعلان تلقائيًا؟

عند إعادة تحميل الإعلان، يتم استخدام عنصر GAMRequest الذي تم تحديده سابقًا لاستهداف الإعلان مرة أخرى. لضبط استهداف جديد، استخدِم الدالة loadRequest بشكل صريح في GAMBannerView مع كائن GAMRequest جديد.

كيف يمكنني تمرير مَعلمات استهداف إضافية إلى شبكات التوسّط؟

اطّلِع على التوسّط لمعرفة كيفية إرسال الاستهداف إلى شبكات التوسّط.