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

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

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

• تطبيق Android يتضمّن حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) يمكنك الاطّلاع على BasicExample إذا لم يكن لديك تطبيق يتضمّن حزمة تطوير البرامج. إذا كنت بحاجة إلى مساعدة في دمج حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) في تطبيقك، يمكنك الاطّلاع على مقالة إعداد حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA).
• علامة إعلان تم ضبطها لعرض إعلان مصاحب إذا كنت بحاجة إلى نموذج، يمكنك الاطّلاع على الأسئلة الشائعة.

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

اتّبِع الخطوات التالية لإضافة موضع إعلان مصاحب وعرض إعلانات مصاحبة في تطبيقك.

إنشاء `ViewGroup` لعرض إعلانك المصاحب

قبل طلب إعلان مصاحب، عليك إنشاء مساحة له في تصميمك. في ملف XML الخاص بالتصميم، أضِف عنصر ViewGroup، ويستخدم هذا المثال LinearLayout. في خطوة لاحقة، ستمرِّر مرجعًا إلى هذا العنصر إلى AdDisplayContainer.

إذا كنت تدمج في تطبيق BasicExample، أضِف هذا إلى ملف activity_my.xml أسفل videoPlayerContainer.

<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" />
companion_ad_slot_snippet.xml

إنشاء CompanionAdSlot

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

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}
CompanionAdSnippets.java

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

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
CompanionAdSnippets.java

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}
CompanionAdSnippets.java

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

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

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

تعديل تطبيقات Android لعرض إعلانات مصاحبة مرنة

يمكنك الإعلان عن موضع إعلان مصاحب مرن من خلال تعديل الـ CompanionAdSlot.setSize() لتأخذ CompanionAdSlot.FLUID_SIZE ككلتا المَعلمتَين.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

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

اتّبعتُ الدليل، ولكن لا تظهر لي إعلانات مصاحبة. ماذا يجب أن أفعل؟

أولاً، تأكَّد من أنّ علامتك تعرض إعلانات مصاحبة فعلاً. لإجراء ذلك، افتح العلامة في متصفح ويب وابحث عن علامة <CompanionAds> إذا ظهرت لك هذه العلامة، تأكَّد من أنّ حجم الإعلان المصاحب الذي يتم عرضه هو الحجم نفسه الذي تمرِّره إلى عنصر CompanionAdSlot.

كيف ستبدو خانة الإعلان المصاحب عند اتّباع هذا الدليل؟

تم إنشاء الصورة التالية من BasicExample ، ويتم تشغيل فيديو المحتوى في الأعلى مع الإعلان المصاحب أدناه.