Tamamlayıcı reklamlar

Bu kılavuz, Android IMA uygulamalarında tamamlayıcı reklam eklemek isteyen yayıncılara yöneliktir.

Ön koşullar

• IMA SDK'sı entegre edilmiş Android uygulaması. SDK'nın entegre edildiği bir uygulamanız yoksa BasicExample'a bakın.
• Tamamlayıcı reklam döndürecek şekilde yapılandırılmış bir reklam etiketi.
  • Örnek için SSS sayfamıza göz atın.

Faydalı başlangıç kılavuzları

Uygulamanıza IMA SDK'sını uygulamanız gerekiyorsa Başlangıç kılavuzumuza göz atın.

Uygulamanıza tamamlayıcı reklamlar ekleme

Tamamlayıcınızı görüntülemek için bir ViewGroup oluşturun

Arkadaş isteğinde bulunmadan önce düzeninizde buna yer açmanız gerekir. İçerik düzeni XML'inize bir ViewGroup öğesi ekleyin. Bu örnekte LinearLayout kullanılmaktadır. Daha sonraki bir adımda, bu öğeye ait bir referansı AdDisplayContainer öğenize ileteceksiniz. BasicExample uygulamasına entegre ediyorsanız bunu videoPlayerContainer altındaki activity_my.xml alanına ekleyin.

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 oluşturma

Bir sonraki adım, bir CompanionAdSlot nesnesi oluşturmaktır. Bu nesne daha sonra bir ArrayList<CompanionAdSlot>'a eklenir. AdDisplayContainer, tek seferde birden fazla tamamlayıcı reklam gösterebilmeniz için tamamlayıcı reklam alanlarının listesini alır. CompanionAdSlot oluşturmak için ImaSdkFactory örneği oluşturmanız gerekir.

  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);

Uygulamanızda göstermek istediğiniz her tamamlayıcı boyutu için bir tamamlayıcı reklam alanı oluşturun. IMA SDK'sı, tamamlayıcı reklam alanını VAST yanıtındaki, görünümün yüksekliği ve genişliğiyle eşleşen boyutlara sahip tamamlayıcılarla doldurur. IMA SDK, değişken boyutlu tamamlayıcıların kullanılmasını da destekler. companionAdSlots'ü oluşturduktan sonra AdsLoader'a eklenmeleri gerekiyordu. Aşağıdaki örneklerde, Exoplayer-IMA uzantısını kullanan IMA Android BasicExample'u mu yoksa uzantıyı kullanmayan diğer IMA uygulamalarını mı kullandığınıza bağlı olarak bunun nasıl yapılacağı gösterilmektedir.

BasicExample

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

Diğer uygulamalar

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

Hepsi bu kadar. Uygulamanız artık tamamlayıcı reklamlar gösteriyor.

Akıcı tamamlayıcı reklamlar gösterin

IMA artık değişken tamamlayıcı reklamları destekliyor. Bu tamamlayıcı reklamlar, reklam alanının boyutuna uyacak şekilde yeniden boyutlandırılabilir. Ana görünümün genişliğinin% 100'ünü doldurur, ardından yüksekliklerini tamamlayıcı içeriğe sığacak şekilde yeniden boyutlandırır. Bunlar, Ad Manager'da Fluid tamamlayıcı boyutu kullanılarak ayarlanır. Bu değerin nerede ayarlanacağını öğrenmek için aşağıdaki resme bakın.

Android uygulamalarını sorunsuz çalışan yardımcılar için güncelleme

CompanionAdSlot.setSize() yöntemini, her iki parametre olarak da CompanionAdSlot.FLUID_SIZE almasını sağlayacak şekilde güncelleyerek değişken bir tamamlayıcı slot tanımlayabilirsiniz.

  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);

SSS

Kılavuzu uyguladım ancak tamamlayıcı reklamlar görmüyorum. Ne yapmalıyım?

Öncelikle, etiketinizin gerçekten de eşlik eden kullanıcıları döndürdüğünden emin olun. Bunu yapmak için etiketi bir web tarayıcısında açıp CompanionAds etiketini bulun. Bu hatayı görüyorsanız döndürülen tamamlayıcının boyutunun, CompanionAdSlotnesneye

ilettiğiniz boyutlarla aynı olduğundan emin olun.

Bu kılavuzu uyguladığımda tamamlayıcı reklam alanım nasıl görünecek?

Aşağıdaki resim, BasicExample üzerinden oluşturulmuştur ve üstte oynatılan içerik videosunun altında tamamlayıcı reklamı gösterir.