Tamamlayıcı reklamlar

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

Ön koşullar

• IMA SDK entegre Android uygulaması. Halihazırda SDK entegre edilmiş bir uygulamanız yoksa BasicExample'e bakın.
• Tamamlayıcı reklam döndürecek şekilde yapılandırılmış bir reklam etiketi.
  • Örneğe ihtiyacınız varsa SSS bölümümüze göz atın.

Yararlı bilgiler

Uygulamanızda hâlâ IMA SDK'sı uygulanması gerekiyorsa Başlangıç kılavuzumuzu inceleyin.

Uygulamanıza tamamlayıcı reklamlar ekleyin

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

Bir tamamlayıcı reklam istemeden önce, düzeninizde bunun için bir alan oluşturmanız gerekir. Düzen XML'nize bir ViewGroup öğesi ekleyin. Bu örnekte LinearLayout kullanılmaktadır. Sonraki bir adımda, AdDisplayContainer öğenize bu öğeye bir referans geçirirsiniz. BasicExample uygulamasına entegre ediyorsanız bunu com.google.android.exoplayer2.ui.PlayerView öğesinin altındaki activity_my.xml bölümüne 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şturun

Sonraki adım bir 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östermek istediğiniz tamamlayıcı her boyut için bir tamamlayıcı reklam alanı oluşturun. IMA SDK, 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şturulduktan sonra bunların 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ından hangisini 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 şu anda tamamlayıcı reklamlar gösteriyor.

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 alanının boyutuyla eşleşecek şekilde yeniden boyutlandırılabilir. Üst görünüm genişliğinin% 100'ünü kaplarlar, ardından yüksekliklerini tamamlayıcının içeriğine sığacak şekilde yeniden boyutlandırırlar. Bunlar, Ad Manager'da Fluid tamamlayıcı boyutu kullanılarak ayarlanır. Bu değerin nereye ayarlanacağını görmek için aşağıdaki resme bakın.

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

CompanionAdSlot.setSize() yöntemini her iki parametre olarak da CompanionAdSlot.FLUID_SIZE alacak şekilde güncelleyerek değişken tamamlayıcı 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 izledim ancak tamamlayıcı reklamları görmüyorum. What should I do?

Öncelikle, etiketinizin gerçekten tamamlayıcılar döndürdüğünden emin olun. Bunu yapmak için etiketi bir web tarayıcısında açın ve CompanionAds etiketi arayın. Bunu görürseniz döndürülmekte olan tamamlayıcının boyutunun, CompanionAdSlot nesnesine geçirmekte olduğunuz boyutlarla aynı boyutta olduğundan emin olun.

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

Aşağıdaki resim, Temel Örnek 'ten oluşturulmuştur ve içerik videosu yukarıda, aşağıdaki tamamlayıcı reklamla birlikte oynatılır.