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

هذا الدليل مخصّص للناشرين المهتمين بإضافة إعلانات مصاحبة إلى تنفيذ إعلانات الوسائط التفاعلية (IMA) على Android.

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

  • تطبيق Android مع دمج أداة تطوير البرامج لإعلانات الوسائط التفاعلية. راجِع BasicExample إذا لم يكن لديك تطبيق تم دمج حزمة تطوير البرامج (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;مدير الإعلانات&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 لإعلانات الوسائط التفاعلية