الاستهداف

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

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

تنزيل الإصدار التجريبي من واجهة برمجة التطبيقات

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

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

GADRequestConfiguration

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

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

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

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

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

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

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

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

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

الانتقال إلى المعالجة الموجّهة للفئة العمرية من TFCD وTFUA

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

يعرض الجدول التالي إعدادات tagForChildDirectedTreatment وtagForUnderAgeOfConsent وما يعادلها من إعدادات التصنيف حسب العمر:

فهم تفاعلات المعالجة الموجّهة للفئات العمرية مع علامة TFCD وعلامة TFUA

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

إعادة توجيه إعدادات المعالجة الموجّهة للفئة العمرية باستخدام التوسّط

في حال ضبط المعالجة الموجّهة للفئات العمرية باستخدام Google Mobile Ads SDK، ستعيد محوّلات التوسّط توجيه إشارة المعالجة الموجّهة للفئات العمرية إلى حِزم تطوير البرامج (SDK) التابعة لجهات خارجية والتي يتم التوسّط فيها.

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

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

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

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

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

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

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

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

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

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

يشير المثال التالي إلى أنّك تريد تضمين مَعلمة TFUA في طلب الإعلان:

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

‫Publisher Privacy Treatment (إصدار تجريبي)

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

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

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

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

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

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

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

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 هذا لاستهداف الكلمات الرئيسية ذات الصلة:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Swift Objective-C

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

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

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)

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 جديد.

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

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