คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่สนใจเพิ่มโฆษณาที่แสดงร่วมลงใน การใช้งาน Android IMA
ข้อกำหนดเบื้องต้น
- แอปพลิเคชัน Android ที่ผสานรวม IMA SDK โปรดดู BasicExample หากคุณ หากคุณยังไม่มีแอปที่มีการผสานรวม SDK
- แท็กโฆษณาที่กำหนดค่าให้แสดงโฆษณาที่แสดงร่วม
- หากคุณต้องการดูตัวอย่าง โปรดดูคำถามที่พบบ่อยของเรา
เกริ่นนำที่เป็นประโยชน์
หากคุณยังต้องใช้ IMA SDK ในแอป โปรดดู คู่มือเริ่มต้นใช้งาน
เพิ่มโฆษณาที่แสดงร่วมลงในแอป
สร้าง ViewGroup เพื่อแสดงโฆษณาที่แสดงร่วม
ก่อนที่จะส่งคำขอโฆษณาที่แสดงร่วม คุณต้องสร้างพื้นที่ทำงานสำหรับโฆษณาที่แสดงร่วมใน
เลย์เอาต์ เพิ่มองค์ประกอบ ViewGroup
ใน XML เลย์เอาต์ นี้
ตัวอย่างเช่น ใช้ 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=19&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
ของ Google - ช่องโฆษณาที่แสดงร่วมของฉันจะมีลักษณะอย่างไรเมื่อทำตามคู่มือนี้
-
รูปภาพด้านล่างสร้างขึ้นจาก
BasicExample
และมีเนื้อหาวิดีโอเล่นด้านบนพร้อมกับโฆษณาที่แสดงร่วมด้านล่าง