Tamamlayıcı reklamlar

Bu kılavuz, test edebilirsiniz.

Ön koşullar

• IMA SDK entegrasyonuna sahip Android uygulaması. Aşağıdaki şartları karşılıyorsanız BasicExample (Temel Örnek) henüz entegre edilmiş SDK'sı olan bir uygulamanız yok.
• Tamamlayıcı reklam döndürecek şekilde yapılandırılan bir reklam etiketi.
  • Örneğe ihtiyacınız varsa SSS sayfamıza göz atın.

Faydalı yardımcı öneriler

Uygulamanızda IMA SDK'yı kullanmaya devam etmeniz gerekiyorsa Başlangıç kılavuzu.

Uygulamanıza tamamlayıcı reklamlar ekleyin

Tamamlayıcınızı göstermek için bir ViewGroup oluşturun

Tamamlayıcı Mod'u istemeden önce kullanır. Düzen XML'nizde bir ViewGroup öğesi ekleyin; bu örneği, LinearLayout kullanır. Sonraki adımlarda, AdDisplayContainer öğenize referans veriyor. Eğer Temel Örnek uygulamasına entegre etmek için, bunu activity_my.xml com.google.android.exoplayer2.ui.PlayerView altında.

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ştur

Sonraki adım bir CompanionAdSlot nesnesi oluşturmaktır. daha sonra bir ArrayList<CompanionAdSlot> öğesine eklendi. AdDisplayContainer, aşağıdaki işlemleri yapabilmeniz için tamamlayıcı reklam alanlarının listesini alır: Aynı anda birden fazla tamamlayıcı reklam gösterebilir. Projenin her yerinde CompanionAdSlot oluşturmak için ImaSdkFactory.

  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 tamamlayıcının her boyutu için bir tamamlayıcı reklam alanı oluşturun. IMA SDK, tamamlayıcı reklam alanını, bu alan için izin verilen VAST yanıtındaki tamamlayıcılarla görünümün yüksekliğiyle ve genişliğiyle eşleşen boyutlara sahip olmalıdır. IMA SDK, aynı zamanda değişken boyutlu tamamlayıcılar. companionAdSlots oluşturulduktan sonra AdsLoader. Aşağıdaki örneklerde, projenizde yer alan herhangi bir : IMA Android BasicExample Exoplayer-IMA uzantısı, veya uzantıyı kullanmayan diğer IMA uygulamaları.

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ı reklam.

Değişken tamamlayıcı reklamları görüntüleyin

IMA artık değişken tamamlayıcı reklamları desteklemektedir. Bu tamamlayıcı reklamlar, reklamın boyutuna uyacak şekilde yeniden boyutlandırılabilir yuvaya yerleştirilmiştir. Üst görünüm genişliğinin% 100'ünü kaplar, ardından yüksekliğini tamamlayıcının genişliğine sığacak şekilde yeniden boyutlandırırlar içerik. Bunlar, Ad Manager'da Fluid tamamlayıcı boyutu kullanılarak ayarlanır. Bkz. bu değerin nereden ayarlanacağını gösteren aşağıdaki resme bakın.

Değişken tamamlayıcılar için Android uygulamalarını güncelleme

CompanionAdSlot.setSize() CompanionAdSlot.FLUID_SIZE alma yöntemi kullanabilirsiniz.

  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ı reklam görmüyorum. Ne yapmalıyım?

Öncelikle, etiketinizin gerçekten tamamlayıcılar döndürdüğünden emin olun. Yapılacaklar Etiketi bir web tarayıcısında açın ve CompanionAds etiketini bulun. Gördüğünüz Döndürülen tamamlayıcının boyutunun aynı olduğundan emin olun. boyutu, CompanionAdSlot içine aktardığınız boyutlar olarak gösterilir. nesne.

Bu kılavuzda ilerlerken tamamlayıcı reklam alanım nasıl görünecek?

. Aşağıdaki resim BasicExample ve yukarıdaki içerik videosu aşağıdaki tamamlayıcı reklamla birlikte oynatılıyor.