คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่สนใจเพิ่มโฆษณาที่แสดงร่วมลงในการติดตั้งใช้งาน IMA ใน Android
ข้อกำหนดเบื้องต้น
- แอปพลิเคชัน Android ที่ผสานรวม IMA SDK ดู BasicExample หากคุณยังไม่มีแอปที่ผสานรวม SDK หากต้องการความช่วยเหลือในการติดตั้งใช้งาน IMA SDK ในแอป โปรดดูหัวข้อตั้งค่า IMA SDK
- แท็กโฆษณาที่กําหนดค่าไว้ให้แสดงโฆษณาที่แสดงร่วม หากต้องการดูตัวอย่าง โปรดไปที่คำถามที่พบบ่อย
เพิ่มโฆษณาที่แสดงร่วมลงในแอป
ทำตามขั้นตอนเพื่อเพิ่มช่องโฆษณาที่แสดงร่วมและแสดงโฆษณาที่แสดงร่วมในแอป
สร้าง ViewGroup เพื่อแสดงโฆษณาที่แสดงร่วมกัน
ก่อนที่จะขอโฆษณาที่แสดงร่วมกัน คุณต้องสร้างพื้นที่สำหรับโฆษณาดังกล่าวในเลย์เอาต์ ใน XML ของเลย์เอาต์ ให้เพิ่มองค์ประกอบ ViewGroup ตัวอย่างนี้ใช้ LinearLayout ในขั้นตอนถัดไป คุณจะส่งการอ้างอิงองค์ประกอบนี้ไปยัง AdDisplayContainer
หากคุณกำลังผสานรวมเข้ากับแอป BasicExample ให้เพิ่มโค้ดนี้ลงในไฟล์ activity_my.xml ใต้ videoPlayerContainer
<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
public void createCompanionAdSlot(ViewGroup companionViewGroup) {
ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
companionAdSlot.setSize(300, 250);
ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
companionAdSlots.add(companionAdSlot);
}
สร้างช่องโฆษณาที่แสดงร่วมสำหรับโฆษณาที่แสดงร่วมแต่ละขนาดที่คุณต้องการแสดงในแอป IMA SDK จะป้อนข้อมูลช่องโฆษณาที่แสดงร่วมด้วยโฆษณาที่แสดงร่วมจากการตอบกลับด้วย VAST ซึ่งมีขนาดตรงกับความสูงและความกว้างของมุมมอง
นอกจากนี้ IMA SDK ยังรองรับการใช้โฆษณาที่แสดงร่วมแบบไหลด้วย
เมื่อสร้าง companionAdSlots แล้ว ให้เพิ่มลงใน AdsLoader ตัวอย่างต่อไปนี้แสดงวิธีดำเนินการโดยขึ้นอยู่กับว่าคุณใช้ส่วนขยาย Exoplayer-IMA หรือการติดตั้งใช้งาน IMA อื่นๆ ที่ไม่ได้ใช้ส่วนขยายดังกล่าว
ส่วนขยาย Exoplayer-IMA
public void setCompanionAdSlotExoPlayer(
Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
ImaAdsLoader adsLoader =
new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
การติดตั้งใช้งานอื่นๆ
public void setCompanionAdSlot(
AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
adDisplayContainer.setCompanionSlots(companionAdSlots);
}
เท่านี้ก็เรียบร้อย ตอนนี้แอปพลิเคชันของคุณแสดงโฆษณาที่แสดงร่วมแล้ว
แสดงโฆษณาที่แสดงร่วมแบบไหล
IMA รองรับโฆษณาที่แสดงร่วมแบบไหล โฆษณาที่แสดงร่วมเหล่านี้สามารถปรับขนาดให้ตรงกับขนาดของช่องโฆษณาได้ โดยจะเติมเต็มความกว้าง 100% ของมุมมองหลัก แล้วปรับขนาดความสูงให้พอดีกับเนื้อหาของโฆษณาที่แสดงร่วม โดยจะตั้งค่าโดยใช้Fluid
ขนาดที่แสดงร่วมใน Ad Manager ดูรูปภาพต่อไปนี้เพื่อดูตำแหน่งที่จะตั้งค่านี้
อัปเดตแอป Android สำหรับอุปกรณ์ที่ใช้ร่วมกันได้อย่างราบรื่น
คุณประกาศช่องโฆษณาที่แสดงร่วมกันแบบไหลได้โดยอัปเดตเมธอด CompanionAdSlot.setSize() ให้ใช้ CompanionAdSlot.FLUID_SIZE เป็นพารามิเตอร์ทั้ง 2 รายการ
companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
คำถามที่พบบ่อย
- ฉันทำตามคำแนะนำแล้ว แต่ไม่เห็นโฆษณาที่แสดงร่วม ฉันควรทำอย่างไร
- ก่อนอื่น ให้ตรวจสอบว่าแท็กแสดงโฆษณาที่แสดงร่วมกันจริง โดยเปิดแท็กในเว็บเบราว์เซอร์และมองหาแท็ก
<CompanionAds>หากเห็นข้อความดังกล่าว ให้ตรวจสอบว่าขนาดของโฆษณาที่แสดงร่วมกันที่แสดงผลมีขนาดเดียวกับมิติข้อมูลที่คุณส่งไปยังออบเจ็กต์CompanionAdSlot - ช่องโฆษณาที่แสดงร่วมจะมีลักษณะอย่างไรเมื่อทำตามคู่มือนี้
รูปภาพต่อไปนี้สร้างขึ้นจาก BasicExample และมีวิดีโอเนื้อหาเล่นอยู่ด้านบนพร้อมโฆษณาที่แสดงร่วมอยู่ด้านล่าง
