คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่สนใจเพิ่มโฆษณาที่แสดงร่วมลงในการติดตั้งใช้งาน Android IMA
ข้อกำหนดเบื้องต้น
- แอปพลิเคชัน Android ที่ผสานรวม IMA SDK โปรดดู BasicExample หากคุณ ยังไม่มีแอปที่ผสานรวม SDK ไว้
- แท็กโฆษณาที่กำหนดค่าให้แสดงผลโฆษณาที่แสดงร่วม
- หากต้องการตัวอย่าง โปรดดูคำถามที่พบบ่อย
เกริ่นนำที่มีประโยชน์
หากคุณยังต้องติดตั้ง IMA SDK ในแอป โปรดอ่านคู่มือเริ่มต้นใช้งานของเรา
เพิ่มโฆษณาที่แสดงร่วมลงในแอป
สร้าง ViewGroup เพื่อแสดงโฆษณาที่แสดงร่วม
ก่อนที่จะขอโฆษณาที่แสดงร่วม คุณต้องสร้างพื้นที่ทำงานสำหรับโฆษณาที่แสดงร่วมในเลย์เอาต์ ใน XML ของเลย์เอาต์ ให้เพิ่มองค์ประกอบ ViewGroup
ตัวอย่างนี้ใช้ LinearLayout
ในขั้นตอนถัดไป คุณจะส่งการอ้างอิงไปยังองค์ประกอบนี้ไปยัง AdDisplayContainer
หากคุณผสานรวมเข้ากับแอป BasicExample ให้เพิ่มสิ่งนี้ลงใน
activity_my.xml
ใต้ com.google.android.exoplayer2.ui.PlayerView
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
ขั้นตอนถัดไปคือการสร้างออบเจ็กต์ CompanionAdSlot
ซึ่งจะเพิ่มลงใน ArrayList<CompanionAdSlot>
AdDisplayContainer
ใช้รายการช่องโฆษณาที่แสดงร่วมเพื่อให้คุณแสดงโฆษณาที่แสดงร่วมหลายรายการพร้อมกันได้ คุณจะต้องสร้างอินสแตนซ์ของ ImaSdkFactory
เพื่อสร้าง CompanionAdSlot
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);
สร้างช่องโฆษณาที่แสดงร่วมสำหรับโฆษณาที่แสดงร่วมแต่ละขนาดที่คุณต้องการแสดงในแอป
IMA SDK จะสร้างช่องโฆษณาที่แสดงร่วมด้วยโฆษณาที่แสดงร่วมจากการตอบสนองด้วย VAST ที่มีขนาดตรงกับความสูงและความกว้างของมุมมอง นอกจากนี้ IMA SDK ยังรองรับการใช้โฆษณาที่แสดงร่วมขนาดแบบไหลด้วย
เมื่อสร้าง companionAdSlots
แล้ว ระบบจะเพิ่มผู้ใช้ไปยัง AdsLoader
ตัวอย่างต่อไปนี้แสดงวิธี โดยขึ้นอยู่กับว่าคุณใช้ IMA Android BasicExample ที่ใช้ส่วนขยาย Exoplayer-IMA หรือการใช้งาน IMA อื่นๆ ที่ไม่ได้ใช้ส่วนขยาย
BasicExample
adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();
การติดตั้งใช้งานอื่นๆ
adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);
เท่านี้ก็เรียบร้อย แอปพลิเคชันของคุณกำลังแสดงโฆษณาที่แสดงร่วม
แสดงโฆษณาที่แสดงร่วมแบบไหล
ตอนนี้ IMA รองรับโฆษณาที่แสดงร่วมแบบไหลแล้ว โฆษณาที่แสดงร่วมเหล่านี้สามารถปรับขนาดให้พอดีกับขนาดของช่องโฆษณา โฆษณาเหล่านี้แสดงเต็ม 100% ของความกว้างของมุมมองระดับบนสุด แล้วปรับขนาดความสูงให้พอดีกับเนื้อหาของโฆษณาที่แสดงร่วม ตั้งค่าได้โดยใช้ขนาดโฆษณาที่แสดงร่วม Fluid
ใน Ad Manager ดูตำแหน่งที่จะตั้งค่านี้ได้จากรูปภาพต่อไปนี้
![รูปภาพแสดงการตั้งค่าโฆษณาที่แสดงร่วมของ Ad Manager ไฮไลต์ตัวเลือกขนาดโฆษณาที่แสดงร่วม](https://developers.google.cn/static/interactive-media-ads/images/ad_manager_fluid_companion.png?authuser=6&hl=th)
อัปเดตแอป Android สำหรับโฆษณาที่แสดงร่วมแบบไหล
คุณประกาศช่องโฆษณาที่แสดงร่วมแบบไหลได้โดยอัปเดตเมธอด CompanionAdSlot.setSize()
ให้เป็น CompanionAdSlot.FLUID_SIZE
เป็นพารามิเตอร์ทั้ง 2 รายการ
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);
คำถามที่พบบ่อย
- ฉันทำตามคำแนะนำแล้ว แต่ไม่เห็นโฆษณาที่แสดงร่วม ควรทำอย่างไร
- ก่อนอื่น ให้ตรวจสอบว่าแท็กของคุณส่งคืนโฆษณาที่แสดงร่วมจริงๆ โดยเปิดแท็กในเว็บเบราว์เซอร์ แล้วมองหาแท็ก CompanionAds หากคุณเห็นขนาดนั้น ให้ตรวจสอบว่าขนาดของโฆษณาที่แสดงร่วมที่ส่งกลับมีขนาดเท่ากับขนาดที่คุณส่งผ่านไปยังออบเจ็กต์
CompanionAdSlot
- ช่องโฆษณาที่แสดงร่วมของฉันจะมีลักษณะอย่างไรเมื่อทำตามคู่มือนี้
-
รูปภาพด้านล่างสร้างขึ้นจาก
BasicExample
และมีวิดีโอเนื้อหาที่เล่นอยู่ด้านบนพร้อมกับโฆษณาที่แสดงร่วมด้านล่าง