Tamamlayıcı reklam desteği ekleme

Bu kılavuz, Android IMA uygulamalarına tamamlayıcı reklamlar eklemek isteyen yayıncılar için hazırlanmıştır.

Ön koşullar

• IMA SDK'sının entegre edildiği Android uygulaması. SDK'nın entegre edildiği bir uygulamanız yoksa BasicExample'a bakın. IMA SDK'yı uygulamanıza ekleme konusunda yardıma ihtiyacınız varsa IMA SDK'yı ayarlama başlıklı makaleyi inceleyin.
• Tamamlayıcı reklam döndürecek şekilde yapılandırılmış bir reklam etiketi. Örnek için SSS sayfamıza göz atın.

Uygulamanıza tamamlayıcı reklamlar ekleme

Uygulamanıza tamamlayıcı reklam alanı eklemek ve tamamlayıcı reklamları göstermek için aşağıdaki adımları uygulayın.

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

Tamamlayıcı reklam isteğinde bulunmadan önce düzeninizde bu reklam için bir alan oluşturmanız gerekir. Düzen XML'nize bir ViewGroup öğesi ekleyin. Bu örnekte LinearLayout kullanılmıştır. Sonraki bir adımda, bu öğeye bir referans ileterek AdDisplayContainer öğenize göndereceksiniz.

BasicExample uygulamasına entegrasyon yapıyorsanız bunu activity_my.xml dosyasına, videoPlayerContainer öğesinin altına ekleyin.

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

Sonraki adım, bir CompanionAdSlot nesnesi oluşturmaktır. Bu nesne daha sonra bir ArrayList<CompanionAdSlot> örneğine eklenir. AdDisplayContainer arayüzü, aynı anda birden fazla tamamlayıcı reklam gösterebilmeniz için tamamlayıcı reklam alanlarının listesini alır. CompanionAdSlot nesnesini oluşturmak için ImaSdkFactory sınıfının bir örneğini oluşturmanız gerekir.

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

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ından gelen ve görünümün yüksekliği ile genişliğine uyan 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 bunları AdsLoader ekleyin. Aşağıdaki örneklerde, Exoplayer-IMA uzantısını veya uzantıyı kullanmayan diğer IMA uygulamalarını kullanmanıza bağlı olarak bunu nasıl yapacağınız gösterilmektedir.

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

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

Akıcı tamamlayıcı reklamlar gösterme

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

Akıcı yardımcılar için Android uygulamalarını güncelleme

CompanionAdSlot.setSize() yöntemini her iki parametre olarak CompanionAdSlot.FLUID_SIZE alacak şekilde güncelleyerek esnek bir tamamlayıcı alan tanımlayabilirsiniz.

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

SSS

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

Öncelikle, etiketinizin gerçekten tamamlayıcı reklamlar döndürdüğünden emin olun. Bunu yapmak için etiketi bir web tarayıcısında açın ve <CompanionAds> etiketini bulun. Bunu görürseniz döndürülen tamamlayıcının boyutunun, CompanionAdSlot nesnesine ilettiğiniz boyutlarla aynı olduğundan emin olun.

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

Aşağıdaki resim, BasicExample'dan oluşturulmuştur ve üstte oynatılan içerik videosu ile altta tamamlayıcı reklamı içerir.