โฆษณาที่แสดงร่วม

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

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