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

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

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

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

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

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

إنشاء 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 التي تتطابق أبعادها مع ارتفاع العرض وعرضه. تتيح حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) أيضًا استخدام إعلانات مصاحبة ذات حجم مرن. بعد إنشاء 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 في "إدارة إعلانات Google". انظر الصورة التالية لمعرفة مكان تعيين هذه القيمة.

تحديث تطبيقات Android لتوفير تجربة سلسة على الأجهزة المرافقة

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

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

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

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

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

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

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