เพิ่มการรองรับโฆษณาที่แสดงร่วมกัน

เลือกแพลตฟอร์ม: HTML5 Android iOS

คู่มือนี้จัดทำขึ้นสำหรับผู้เผยแพร่โฆษณาที่สนใจเพิ่มโฆษณาที่แสดงร่วมกับวิดีโอใน การติดตั้งใช้งาน 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แล้ว คุณจะต้องเพิ่ม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 ดูตำแหน่งที่จะตั้งค่านี้ได้ใน รูปภาพต่อไปนี้

อัปเดตแอป 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 และมีวิดีโอเนื้อหาเล่นอยู่ด้านบนพร้อมกับโฆษณาที่แสดงร่วมอยู่ด้านล่าง