Tamamlayıcı reklam desteği ekleme

Platform seçin: HTML5 Android iOS

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

Ön koşullar

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

Faydalı başlangıç kılavuzları

IMA SDK'yı uygulamanıza henüz eklemediyseniz Başlangıç kılavuzumuza göz atın.

Uygulamanıza eşlik eden reklamlar ekleme

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

Yardımcı isteğinde bulunmadan önce düzeninizde yardımcı için bir alan oluşturmanız gerekir. Düzen XML'nize bir ViewGroup öğesi ekleyin. Bu örnekte LinearLayout kullanılıyor. Daha sonraki bir adımda, bu öğeye referans ileterek AdDisplayContainer oluşturacaksınız. BasicExample uygulamasına entegrasyon yapıyorsanız activity_my.xml bölümüne videoPlayerContainer öğesinin altına şunu 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, CompanionAdSlot nesnesi oluşturmaktır. Bu nesne daha sonra ArrayList<CompanionAdSlot> öğesine eklenir. AdDisplayContainer, aynı anda 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östermeyi planladığınız her tamamlayıcı boyutu için bir tamamlayıcı reklam alanı oluşturun. IMA SDK, tamamlayıcı reklam alanını, görünümün yüksekliği ve genişliğiyle eşleşen boyutlara sahip VAST yanıtındaki tüm tamamlayıcılarla doldurur. IMA SDK, değişken boyutlu tamamlayıcıların kullanılmasını da destekler. Oluşturduğunuz companionAdSlots öğelerinin AdsLoader öğesine eklenmesi gerekir. Aşağıdaki örneklerde, Exoplayer-IMA uzantısını kullanan IMA Android BasicExample'ı veya uzantıyı kullanmayan diğer IMA uygulamalarını kullanmanıza bağlı olarak bu işlemin 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 eşlik eden reklamlar gösteriyor.

Akışkan tamamlayıcı görüntülü reklamlar yayınlama

IMA artık değişken tamamlayıcı reklamları destekliyor. Bu yardımcı 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üksekliğini yardımcı reklamın içeriğine uyacak şekilde yeniden boyutlandırır. Ad Manager'da Fluid tamamlayıcı boyutu kullanılarak ayarlanır. Bu değeri nerede ayarlayacağınızı görmek için aşağıdaki resme bakın.

Akıcı eşlikçi deneyimi için Android uygulamalarını güncelleme

CompanionAdSlot.setSize() yöntemini CompanionAdSlot.FLUID_SIZE olarak her iki parametreyi de alacak şekilde güncelleyerek akışkan bir eşlik eden reklam alanı bildirebilirsiniz.

  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örünmüyor. Ne yapmalıyım?

Öncelikle, etiketinizin gerçekten eşlik eden reklamlar döndürdüğünden emin olun. Bunu yapmak için etiketi bir web tarayıcısında açın ve CompanionAds etiketini bulun. Bu durumu 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 eşlik eden reklam alanım nasıl görünecek?

Aşağıdaki resim, BasicExample kullanılarak oluşturulmuştur ve içerik videosu yukarıda, tamamlayıcı reklam ise aşağıda oynatılmaktadır.