الاستهداف

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

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

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

تنزيل تطبيق API Demo

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

قبل المتابعة، عليك إعداد 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 إجراءات حماية محدّدة لعرض الإعلانات للأطفال أو المراهقين. عند استخدام هذا الإعداد، تتضمّن Google Mobile Ads SDK مَعلمة tfat في طلبات الإعلان. استشر مستشارك القانوني لتحديد السنّ المعمول به لمستخدميك استنادًا إلى التزاماتك القانونية والتنظيمية.

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

ضبط طريقة التعامل مع الفئة العمرية للأطفال

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

Swift

// Indicate that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

Objective-C

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

ضبط طريقة التعامل مع الفئة العمرية للمراهقين

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

Swift

// Indicate that ad requests should have teenage treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen

Objective-C

// Indicate that ad requests should have teenage treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentTeen;

ضبط طريقة التعامل مع الفئة العمرية بدون تحديد فئة عمرية معيّنة

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

Swift

// Indicate that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified

Objective-C

// Indicate that ad requests should have unspecified age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentUnspecified;

الترحيل إلى طريقة التعامل مع الفئة العمرية من علامتَي 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 طريقة التعامل الأكثر تحفظًا.

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

لأغراض قانون حماية خصوصية الأطفال على الإنترنت (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.

يمكنك وضع علامة على طلبات إعلاناتك لكي يتم التعامل معها بصفتها موجّهة للمستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال للائحة العامة لحماية البيانات (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. وفي حال ضبطهما معًا، يتم منح الأولوية للإعداد الموجّه إلى الأطفال.

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

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

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

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

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

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"];

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

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

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

Swift

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

Objective-C

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

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

Swift Objective-C

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

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

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 جديد.
كيف يمكنني تمرير مَعلمات استهداف إضافية إلى شبكات التوسّط؟
يمكنك الاطّلاع على مقالة التوسّط لمعرفة كيفية إرسال معلومات الاستهداف إلى شبكات التوسّط.