إعلانات مصاحبة

هذا الدليل مصمم للناشرين المهتمين بإضافة الإعلانات المصاحبة إلى تنفيذ إعلانات الوسائط التفاعلية لنظام التشغيل Android

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

  • تطبيق Android مع دمج حزمة تطوير البرامج لإعلانات الوسائط التفاعلية راجع BasicExample إذا كنت لم يكن لديك تطبيق تم دمج حزمة SDK به.
  • علامة إعلان تم ضبطها لعرض إعلان مصاحب.

مواد تمهيدية مفيدة

إذا كنت لا تزال بحاجة إلى تنفيذ حزمة IMA SDK في تطبيقك، فراجع الحصول على دليل البدء

إضافة الإعلانات المصاحبة إلى تطبيقك

إنشاء مجموعة ViewGroup لعرض المحتوى المصاحب

قبل طلب مصاحب، تحتاج إلى إنشاء مسافة له في التصميم. في تنسيق XML، أضِف عنصر ViewGroup. هذا المثال LinearLayout. في خطوة لاحقة سوف تجتاز الإشارة إلى هذا العنصر إلى AdDisplayContainer. إذا كنت التكامل في تطبيق BasicExample، أضف هذا إلى activity_my.xml أدنى com.google.android.exoplayer2.ui.PlayerView.

activity_my.xml

<LinearLayout
  android:id="@+id/companionAdSlot"
  android:layout_width="match_parent"
  android:layout_height="250dp"
  android:layout_gravity="center_horizontal"
  android:gravity="center"
  android:orientation="vertical"
  android:textAlignment="center" />

إنشاء شريحة إعلان مصاحبة

وتمثّل الخطوة التالية في إنشاء كائن CompanionAdSlot، وهو ثم إضافته إلى ArrayList<CompanionAdSlot>. يأخذ AdDisplayContainer قائمة بالشرائح الإعلانية المصاحبة حتى تتمكن من عرض عدة إعلانات مصاحبة في وقت واحد ستحتاج إلى إنشاء مثيل ImaSdkFactory لإنشاء CompanionAdSlot. 

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

أنشئ شريحة إعلانية مصاحبة لكل حجم من الإعلانات المصاحبة التي تنوي عرضها في تطبيقك. تعمل حزمة تطوير البرامج لإعلانات الوسائط التفاعلية على تعبئة الشريحة الإعلانية المصاحبة بأي إعلانات مصاحبة من استجابة VAST تحتوي على أبعاد تتطابق مع ارتفاع الملف الشخصي وعرضه. وتتيح أيضًا حزمة تطوير البرامج لإعلانات الوسائط التفاعلية استخدام الأجهزة المصاحبة ذات الحجم السائل. بعد إنشاء companionAdSlots، يجب إضافته إلى AdsLoader توضح الأمثلة التالية كيفية القيام بذلك اعتمادًا على ما إذا كنت يستخدمون مثال أساسي لنظام التشغيل Android لإعلانات الوسائط التفاعلية الذي يستخدم إضافة Exoplayer-IMA أو عمليات تنفيذ إعلانات الوسائط التفاعلية الأخرى التي لا تستخدم الإضافة

BasicExample

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

التطبيقات الأخرى

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

هذا كل ما في الأمر! يعرض تطبيقك الآن علامة التبويب "مصاحب" الإعلانات.

عرض الإعلانات المصاحبة المرنة

أصبحت إعلانات الوسائط التفاعلية متاحة الآن للإعلانات المصاحبة المرنة. يمكن لهذه الإعلانات المصاحبة تغيير حجمها لتتناسب مع حجم الإعلان الشريحة. تملأ 100% من عرض العرض الأصلي، ثم تغيّر حجمها ليناسب حجم الإعلان المصاحب المحتوى. ويتم ضبطها باستخدام الحجم المصاحب لـ Fluid في "مدير إعلانات Google". يمكنك الاطّلاع على الصورة التالية لمعرفة مكان ضبط هذه القيمة.

صورة تعرض إعدادات الإعلانات المصاحبة في &quot;مدير إعلانات Google&quot; يبرز خيار الأحجام المصاحبة.

تحديث تطبيقات Android للحصول على إعلانات مرسَلة سلِسة

يمكنك الإعلان عن فتحة مرافقة سائلة من خلال تحديث CompanionAdSlot.setSize() الطريقة المطلوب اتخاذها CompanionAdSlot.FLUID_SIZE كاثنتين من المعلمتين. 

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

الأسئلة الشائعة

لقد اتّبعتُ الدليل، ولكن لم تظهر لي الإعلانات المصاحبة. ماذا يجب أن أفعل؟
تأكَّد أولاً من أنّ علامتك تعرض إعلانات مرتبطة بالفعل. للقيام بذلك، هذا، افتح العلامة في متصفح ويب وابحث عن علامة CompanionAds. إذا رأيت تأكد من أن حجم الإعلان المصاحب الذي يتم إرجاعه هو نفسه المقاس كأبعاد تمرِّرها إلى CompanionAdSlot المستخدم.
كيف ستبدو الخانة الإعلانية المصاحبة لديّ عند اتباع هذا الدليل؟
تم إنشاء الصورة أدناه من BasicExample وتضم فيديو المحتوى الذي يتمّ تشغيله أعلاه مع الإعلان المصاحب أدناه.

مثال على صورة الإعلان المصاحب لنظام التشغيل Android لإعلانات الوسائط التفاعلية