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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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