الاستهداف

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

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

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

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

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

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

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

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

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

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

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