คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่สนใจเพิ่มโฆษณาประกอบลงในการใช้งาน IMA ของ Android
ข้อกำหนดเบื้องต้น
- แอปพลิเคชัน Android ที่ผสานรวม IMA SDK ดู BasicExample หากยังไม่มีแอปที่ผสานรวม SDK ไว้แล้ว
- แท็กโฆษณาที่กําหนดค่าให้แสดงโฆษณาที่แสดงร่วมกัน
- หากต้องการตัวอย่าง โปรดดูคำถามที่พบบ่อย
ข้อมูลเบื้องต้นที่เป็นประโยชน์
หากยังต้องติดตั้ง IMA SDK ในแอป โปรดดูคู่มือเริ่มต้นใช้งาน
เพิ่มโฆษณาประกอบลงในแอป
สร้าง ViewGroup เพื่อแสดงข้อมูลประกอบ
ก่อนขอใช้แอปที่ใช้ร่วมกัน คุณต้องสร้างพื้นที่สำหรับแอปนั้นในเลย์เอาต์ ใน XML ของเลย์เอาต์ ให้เพิ่มองค์ประกอบ ViewGroup
ตัวอย่างนี้ใช้ LinearLayout
ในขั้นตอนถัดไป คุณจะส่งการอ้างอิงองค์ประกอบนี้ไปยัง AdDisplayContainer
หากคุณกำลังผสานรวมกับแอป BasicExample ให้เพิ่มข้อมูลนี้ลงใน
activity_my.xml
ใต้ videoPlayerContainer
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?hl=th)
อัปเดตแอป Android สำหรับอุปกรณ์เสริมที่ทำงานได้อย่างราบรื่น
คุณสามารถประกาศช่องโฆษณาประกอบแบบยืดหยุ่นได้โดยอัปเดตเมธอด CompanionAdSlot.setSize()
ให้ใช้ CompanionAdSlot.FLUID_SIZE
เป็นทั้งพารามิเตอร์
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
และมีวิดีโอเนื้อหาที่เล่นอยู่ด้านบนพร้อมโฆษณาประกอบด้านล่าง