خيارات الإعلانات المدمجة مع المحتوى

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

المعلمة الأخيرة المضمنة في إنشاء GADAdLoader هي مجموعة اختيارية من الكائنات. يصف هذا القسم تلك الخيارات.

سويفت

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

ج موضوعية

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

يحتوي GADNativeAdImageAdLoaderOptions على خصائص تتعلق بالصور في الإعلانات المدمجة مع المحتوى. يمكن أن تتحكم التطبيقات في كيفية معالجة GADAdLoader لأصول الصور عن طريق إنشاء كائن GADNativeAdImageAdLoaderOptions ، وتعيين خصائصه ( disableImageLoading ، و shouldRequestMultipleImages preferredImageOrientation ، وتمريره أثناء التهيئة.

يحتوي GADNativeAdImageAdLoaderOptions على الخصائص التالية:

disableImageLoading
يتم إرجاع أصول الصور للإعلانات المدمجة مع المحتوى عبر مثيلات GADNativeAdImage ، والتي تحتوي على خصائص image و imageURL . إذا تم تعيين disableImageLoading على false ، وهو الإعداد الافتراضي ( NO في Objective-C) ، فستجلب SDK أصول الصور تلقائيًا وتعبئ image وخصائص imageURL لك. إذا تم الضبط على " true " (أو " YES " في الهدف- C) ، فإن SDK سوف تقوم فقط بملء imageURL ، مما يسمح لك بتنزيل الصور الفعلية وفقًا لتقديرك. استخدم mainImage GADMediaContent لتعيين الصورة لعرض الوسائط عند تنزيل الصور يدويًا.
preferredImageOrientation

تحتوي بعض التصميمات على صور متعددة متاحة لمطابقة اتجاهات الجهاز المختلفة. يمكن أن تطلب التطبيقات صورًا لاتجاه معين عن طريق تعيين هذه الخاصية على أحد ثوابت الاتجاه:

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape
  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

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

    إذا لم يتم استدعاء هذه الطريقة ، فسيتم استخدام القيمة الافتراضية لـ GADNativeAdImageAdLoaderOptionsOrientationAny .

shouldRequestMultipleImages

ستحتوي بعض أصول الصور على سلسلة من الصور بدلاً من صورة واحدة فقط. من خلال تعيين هذه القيمة على "صحيح" ، يشير تطبيقك إلى أنه جاهز لعرض جميع الصور لأي أصول تحتوي على أكثر من واحدة. من خلال تعيينه على false (الافتراضي) ، يوجه تطبيقك SDK لتقديم الصورة الأولى فقط لأي أصول تحتوي على سلسلة.

إذا لم يتم تمرير أي كائنات GADAdLoaderOptions عند تهيئة GADAdLoader ، فسيتم استخدام القيمة الافتراضية لكل خيار.

GADNativeAdViewAdOptions

تُستخدم كائنات GADNativeAdViewAdOptions للإشارة إلى التفضيلات الخاصة بكيفية تمثيل الإعلانات الأصلية للإعلانات. لديهم خاصية واحدة: preferredAdChoicesPosition ، والتي يمكنك استخدامها لتحديد الموقع حيث يجب وضع رمز AdChoices. يمكن أن يظهر الرمز في أي ركن من أركان الإعلان ، ويتم تعيينه افتراضيًا على GADAdChoicesPositionTopRightCorner . القيم المحتملة لهذه الخاصية هي:

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

فيما يلي مثال يوضح كيفية وضع رمز "خيارات الإعلان" في الزاوية العلوية اليسرى من الإعلان:

سويفت

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

ج موضوعية

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

تُستخدم كائنات GADVideoOptions للإشارة إلى كيفية عرض أصول الفيديو الأصلية. أنها توفر خاصية واحدة: startMuted .

تشير هذه القيمة المنطقية إلى ما إذا كان يجب بدء تشغيل مواد عرض الفيديو في حالة كتم الصوت. القيمة الافتراضية هي true .

GADMultipleAdsAdLoaderOptions

تسمح كائنات GADMultipleAdsAdLoaderOptions للناشرين بتوجيه أداة تحميل الإعلانات لتحميل إعلانات متعددة في طلب واحد. الإعلانات المحملة بهذه الطريقة مضمونة لتكون فريدة. تحتوي GADMultipleAdsAdLoaderOptions على خاصية واحدة ، numberOfAds ، والتي تمثل عدد الإعلانات التي يجب أن يحاول أداة تحميل الإعلانات عرضها للطلب. بشكل افتراضي ، تكون هذه القيمة واحدة ، ويتم تحديدها بحد أقصى خمسة (حتى إذا طلب أحد التطبيقات المزيد من الإعلانات ، فسيتم إرجاع خمسة على الأكثر). العدد الفعلي للإعلانات المعروضة ليس مضمونًا ، ولكنه سيكون بين صفر و numberOfAds .

خيارات GADNativeAdMediaAdLoader

لاستخدام هذه الميزة ، قم بتضمين فئة GADNativeAdMediaAdLoaderOptions في مصفوفة خيارات الإعلانات الأصلية في تهيئة GADAdLoader .

تسمح لك كائنات GADNativeAdMediaAdLoaderOptions بتحديد تفضيلات نسبة العرض إلى الارتفاع للوسائط. يتم تطبيق الخيار على كل من الصورة والفيديو. تحتوي هذه الفئة على خاصية واحدة: mediaAspectRatio ، والتي يمكنك استخدامها لتحديد نسب عرض الوسائط المدعومة. القيم المحتملة لهذه الخاصية هي:

ج موضوعية سويفت
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

سيؤدي تعيين mediaAspectRatio على أحد هذه الخيارات إلى إرجاع الإعلانات التي تحتوي على وسائط بنسبة عرض إلى ارتفاع محددة فقط. إذا لم يتم تعيين هذه الخاصية بشكل صريح ، فستتحول القيمة افتراضيًا إلى GADMediaAspectRatioUnknown ولن يتم تطبيق أي قيود على نسب العرض إلى الارتفاع.