الاستهداف

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

للاطّلاع على استهداف الإعلانات أثناء العمل، نزِّل تطبيق 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

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

  • .teen
  • .unspecified

Objective-C

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

للإشارة إلى المعالجة الموجّهة إلى المراهقين أو غير المحدّدة، استبدِل الإعداد 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 Mobile Ads SDK، ستعيد محوّلات التوسّط توجيه إشارة المعالجة الموجّهة للفئات العمرية إلى حِزم تطوير البرامج (SDK) التابعة لجهات خارجية والتي يتم التوسّط فيها.

يسرد الجدول التالي إصدارات محوّلات التوسّط التي تتيح إعادة توجيه إشارة المعالجة المحظورة على فئات عمرية معيّنة إلى حزمة تطوير البرامج (SDK) التابعة لجهة خارجية والتي يتم التوسّط فيها:

اسم محوِّل التوسّط الحد الأدنى للإصدار المتوافق
AppLovin 13.6.3.0
BidMachine 3.6.1.1
Bigo 5.2.1.0
Chartboost 9.12.0.1
DTExchange (Fyber) 8.4.7.1
i-mobile 2.3.4.7
InMobi 11.2.0.1
IronSource 9.4.1.0.1
Liftoff Monetize (Vungle) 7.7.2.1
LY Ads (Line Ads) 3.0.1.1
maio 2.2.1.2
Meta (Facebook) 6.21.1.1
Mintegral 8.1.3.1
Moloco 4.6.1.1
MyTarget 5.43.0.0
Pangle 7.9.1.1.1
PubMatic 5.1.0.1
Verve 3.8.1.1

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

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

عند استخدام هذه الميزة، سيتم تضمين مَعلمة "علامة للمستخدمين دون سن الرشد في أوروبا" (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 (إصدار تجريبي)

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

جمع الموقع الجغرافي التقريبي

يمكن لتطبيق "Google Mobile Ads SDK" جمع بيانات الموقع الجغرافي التقريبي لاستهداف الإعلانات استنادًا إلى الموقع الجغرافي للجهاز. إذا منح المستخدم إذن تحديد الموقع الجغرافي في تطبيقك، يجمع "Google Mobile Ads SDK" الموقع الجغرافي التقريبي.

بدءًا من الإصدار 13.12.0 من "Google Mobile Ads SDK"، يتم تفعيل ميزة جمع الموقع الجغرافي التقريبي تلقائيًا. يمكنك إيقاف جمع بيانات الموقع الجغرافي التقريبي باستخدام السمة coarseLocationCollectionEnabled.

يؤدي المثال التالي إلى إيقاف جمع بيانات الموقع الجغرافي التقريبي:

Swift

// Disables automatic coarse location collection by the SDK.
MobileAds.shared.requestConfiguration.coarseLocationCollectionEnabled = false

Objective-C

// Disables automatic coarse location collection by the SDK.
GADMobileAds.sharedInstance.requestConfiguration.coarseLocationCollectionEnabled = NO;

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