الاستهداف

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

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

تنزيل العرض التوضيحي لواجهة برمجة التطبيقات

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

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

GADRequestConfiguration

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

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

بموجب قانون حماية خصوصية الأطفال على الإنترنت (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.

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

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

‫ 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"];

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

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

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