الاستهداف

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

للاطلاع على استهداف الإعلانات عمليًا، يمكنك تنزيل تطبيق 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 للإشارة إلى أنّك تريد التعامل مع المحتوى الذي تقدّمه باعتباره موجّهًا للأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت (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) الخاصة بالناشرين (PPT) واجهة برمجة التطبيقات هي أداة اختيارية تتيح للتطبيقات تحديد ما إذا كان يجب إيقاف تخصيص الإعلانات لجميع طلبات الإعلانات باستخدام السمة 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) من خلال GAMRequest:

Swift

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

Objective-C

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

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

Swift هدف-ج

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

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