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.