الاستهداف

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

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

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

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

أكمِل دليل البدء.

GADRequestConfiguration

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

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

لضمان تطبيق جميع طلبات الإعلانات لتغييرات إعدادات الطلب، يجب ضبط إعدادات الطلب قبل إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.

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

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

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

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

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

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

عنوان 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";

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

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

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

يتم ضبط رقم تعريف العميل في نقطة البيع من خلال GAMRequest:

Swift

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

Objective-C

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

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

Swift Objective-C

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

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