الاستهداف

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

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