لمناقشة منتجاتنا وتقديم ملاحظات بشأنها، انضمّ إلى قناة Discord الرسمية في "مدير إعلانات Google" على خادم منتدى Google للإعلان والقياس.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

اختيار النظام الأساسي: HTML5 Android iOS

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

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

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

مقدمات مفيدة

إذا كنت لا تزال بحاجة إلى تنفيذ حزمة تطوير البرامج لإعلانات الوسائط التفاعلية في تطبيقك، يمكنك الاطّلاع على دليل البدء.

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

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

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

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

الخطوة التالية هي إنشاء عنصر 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);

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

BasicExample

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

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

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

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

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

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

صورة تعرض إعدادات الإعلان المرافق في "مدير إعلانات Google" تُبرز هذه السمة خيار أحجام الإعلانات المصاحبة.

تحديث تطبيقات 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 ويتم تشغيل فيديو المحتوى أعلاه مع الإعلان المرافق أدناه.

إتاحة الإعلانات المصاحبة تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.