يوضح هذا الدليل كيفية توفير معلومات الاستهداف لطلب الإعلان.
وللاطّلاع على استهداف الإعلانات بشكل عملي، يمكنك تنزيل تطبيق iOS API Demo في Swift أو الهدف-ج.
تنزيل العرض التوضيحي لواجهة برمجة التطبيقات
المتطلبات الأساسية
أكمِل دليل البدء.
GADRequestConfiguration
GADRequestConfiguration
هي كائن يجمع معلومات الاستهداف ليتم تطبيقها عالميًا من خلال
الـ
GADMobileAds
المثيل المشترك. يمكن الوصول إليه باستخدام الرمز التالي:
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
إعداد "موجّه للأطفال"
لأغراض قانون حماية خصوصية الأطفال على الإنترنت
(COPPA),
هناك إعداد يسمى
tagForChildDirectedTreatment
بصفتك مطوّر تطبيقات، يمكنك الإشارة إلى ما إذا كنت تريد أن تتعامل Google مع محتوى موجّه إلى الأطفال عند تقديم طلب إعلان. عندما تشير إلى أن أردت أن تتعامل Google مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال، وستتخذ Google خطوات إيقاف الإعلانات التي تستهدف الاهتمامات وإعلانات تجديد النشاط التسويقي في طلب الإعلان هذا. خيارات الإعداد هي على النحو التالي:
- اضبط
tagForChildDirectedTreatment
علىtrue
للإشارة إلى أنك تريد عرض حسابك التعامل مع المحتوى باعتباره موجّهًا للأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA). وهذا يمنع إرسال معرِّف الإعلانات (IDFA). - يمكنك ضبط
tagForChildDirectedTreatment
علىfalse
للإشارة إلى أنك لا تريد ذلك. إذا كان المحتوى موجّهًا إلى الأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA). - لا تضبط
tagForChildDirectedTreatment
إذا لم تكن تريد الإشارة إلى كيفية ذلك. تريد أن يتم التعامل مع المحتوى الخاص بك بما يتوافق مع قانون حماية خصوصية الأطفال على الإنترنت (COPPA).
يشير المثال التالي إلى أنّك تريد أن يتم التعامل مع المحتوى الذي تقدّمه على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;
من خلال إعداد هذه العلامة، أنت تقرّ بأنّ هذا الإشعار دقيق وأنّك المفوّض بالتصرف نيابةً عن مالك التطبيق. أنت تدرك أن إساءة الاستخدام من هذه الإعدادات إلى إغلاق حسابك على Google.
المستخدمون دون سن الرشد
يمكنك وضع علامة على طلبات إعلاناتك ليتم التعامل معها على أنّها موجّهة للمستخدمين في المنطقة الاقتصادية الأوروبية (EEA) تحت سن الرشد. هذه الميزة مُصمَّمة للمساعدة في تسهيل الامتثال لبنود المبادئ العامة لائحة حماية البيانات (GDPR) لاحظ أنه قد يكون لديك حسابات قانونية أخرى والالتزامات بموجب اللائحة العامة لحماية البيانات. يُرجى مراجعة إرشادات الاتحاد الأوروبي والتشاور مع مستشارك القانوني. تجدر الإشارة إلى أنّ أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب بالقانون. مزيد من المعلومات عن كيفية تأثير "اللائحة العامة لحماية البيانات" للناشرين.
عند استخدام هذه الميزة، يتم عرض علامة للمستخدمين تحت سن الرشد في سيتم تضمين مَعلمة أوروبا (TFUA) في جميع طلبات الإعلانات المستقبلية. تؤدي هذه المعلمة إلى إيقاف الإعلانات المخصّصة، بما في ذلك تجديد النشاط التسويقي طلب الإعلان المحدد هذا. وتعمل أيضًا على إيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية مثل وحدات البكسل لقياس الإعلانات وخوادم الإعلانات من جهة خارجية.
ويمكن استخدام هذا الإعداد مع جميع إصدارات حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من خلال
ضبط
السمة tagForUnderAgeOfConsent
على
جسم GADMobileAds.requestConfiguration
ويستمر في true
.
- اضبط
tagForUnderAgeOfConsent
علىtrue
للإشارة إلى أنك تريد عرض الإعلان. طلبات يجب معالجتها بطريقة مناسبة للمستخدمين الذين تقل أعمارهم عن أو موافقتك. ويمنع هذا أيضًا انتقال الإعلانات المعرِّف، IDFA - يشير عدم ضبط
tagForUnderAgeOfConsent
إلى أنّك لا تريد عرض إعلان. طلبات يجب معالجتها بطريقة مناسبة للمستخدمين الذين تقل أعمارهم عن أو موافقتك.
يشير المثال التالي إلى أنّك تريد تضمين TFUA في طلب إعلانك:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
العلامات لتفعيل الإعداد الموجّه إلى الأطفال
وtagForUnderAgeOfConsent
في الوقت نفسه، ويجب ألا يتم ضبطهما على true
.
في هذه الحالة، تكون الأولوية للإعداد الموجّه للأطفال.
تصفية المحتوى الإعلاني
يمكن للتطبيقات ضبط تقييم أقصى لمحتوى الإعلان لجميع طلبات الإعلان باستخدام
سمة maxAdContentRating
من GADRequestConfiguration
ينطبق هذا الإعداد
لجميع طلبات الإعلان المستقبلية خلال الفترة المتبقية من الجلسة. القيم المحتملة
تستند هذه السمة إلى تصنيف المحتوى الرقمي
التصنيفات، ويجب أن تكون واحدة
الثوابت التالية:
GADMaxAdContentRatingGeneral
GADMaxAdContentRatingParentalGuidance
GADMaxAdContentRatingTeen
GADMaxAdContentRatingMatureAudience
يعمل الرمز التالي على إعداد جميع طلبات الإعلان لتحديد محتوى الإعلان هذا
الذي يتم إرجاعه مع تصنيف "تصنيف المحتوى الرقمي" الذي لا يزيد عن
GADMaxAdContentRatingGeneral
Swift
GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
التعامل مع خصوصية الناشر (إصدار تجريبي)
تشير رسالة الأشكال البيانية
التعامل مع خصوصية الناشر
(PPT) API هي أداة اختيارية تتيح للتطبيقات تحديد ما إذا كان يجب إيقاف الإعلانات أو لا.
التخصيص لجميع طلبات الإعلانات باستخدام
publisherPrivacyPersonalizationState
خاصية GADRequestConfiguration
. عند استخدام هذه الميزة، يستخدم الناشر
يتم تضمين معلمة معالجة الخصوصية (PPT) في جميع طلبات الإعلان المستقبلية
ما تبقى من الجلسة.
بشكل تلقائي، يتم عرض إعلانات مخصّصة لطلبات الإعلان إلى Google. ما يلي: يؤدي إلى إيقاف تخصيص الإعلانات لجميع طلبات الإعلانات:
Swift
GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GAMRequest
عنصر GAMRequest
يجمع الاستهداف
المعلومات التي سيتم إرسالها مع طلب الإعلان.
عنوان URL الخاص بالمحتوى
عند طلب إعلان، يمكن للتطبيقات تمرير عنوان URL للمحتوى الذي تعرضه. ويؤدي هذا إلى تفعيل استهداف الكلمات الرئيسية لمطابقة الإعلان مع المحتوى.
على سبيل المثال، إذا كان تطبيقك يطلب إعلانًا أثناء عرض محتوى من
https://www.example.com
، يمكنك ضبط عنوان URL هذا لاستهداف الكلمات الرئيسية ذات الصلة:
Swift
let request = GAMRequest()
request.contentURL = "https://www.example.com"
Objective-C
GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";
الاستهداف المخصّص
بعد ضبط أزواج المفتاح/القيمة في واجهة مستخدم "مدير الإعلانات"، اضبط إعدادات باستخدام القيم الرئيسية في طلب الإعلان. العناصر التي تستهدف تلك المفاتيح تصبح القيم مؤهلة للعرض في طلب الإعلان هذا. لاستهداف قيم متعددة بالنسبة لمفتاح واحد، أدخل القيم كسلسلة مفصولة بفواصل.
Swift
let request = GAMRequest()
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 = GAMRequest()
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) لاستخدامه في تحديد عدد مرات الظهور. تقسيم الجمهور والاستهداف، وعرض الإعلانات بالتناوب التسلسلي، وغير ذلك عناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة.
يتم ضبط المعرّف المقدَّم من الناشر (PPID) من خلال GAMRequest
:
Swift
let request = GAMRequest()
request.publisherProvidedID = "AB123456789"
Objective-C
GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";
اطّلِع على مثال المعرّف المقدَّم من الناشر (PPID) في "مدير إعلانات Google" لمعرفة طريقة التنفيذ المقدَّمة من الناشر. المُعرّفات (PPID) في التطبيق التجريبي لواجهة برمجة تطبيقات iOS:
إشارات مقدَّمة من الناشر
يمكنك إرسال بيانات الجمهور والسياق إشارات مقدَّمة من الناشر (PPS) في طلبات الإعلان. تتيح لك "الإشارات المقدَّمة من الناشر" (PPS) استخدام بيانات المستخدمين لتحسين تحقيق الربح الآلي من خلال توصيل سمات جمهورك مقدمي عروض أسعار في جميع أنواع المعاملات، باستخدام التصنيفات العادية، بدون الحاجة إلى مشاركة معرّفات المستخدمين. جمهورك الخصائص السلوكية البيانات السلوكية والاهتمامات ( الإصدار 1.1 من تصنيف الجمهور الصادر عن مكتب IAB) البيانات السياقية ( تصنيف المحتوى 2.2 من IAB).
Swift
let extras = GADExtras()
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 = GAMRequest()()
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
. - كيف يمكنني ضبط معلَمات استهداف إضافية على شبكات التوسّط؟
- يمكنك الاطّلاع على التوسّط لمعرفة كيفية إرسال الاستهداف إلى شبكات التوسط.