Tamamlayıcı reklam desteği ekleme

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 istiyorsanız 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östermek 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, tamamlayıcı reklam alanlarının listesini alır. Böylece aynı anda birden fazla tamamlayıcı reklam gösterebilirsiniz. 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, AdsLoader'e eklenmelidir. 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.

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

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

Hepsi bu kadar. Uygulamanız artık yardımcı 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ı bir deneyim 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. İçerik videosu yukarıda oynatılırken tamamlayıcı reklam aşağıda gösterilmektedir.