ผสานรวม BidMachine กับสื่อกลาง

เลือกแพลตฟอร์ม: Android ใหม่ Android iOS Unity Flutter

คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads Flutter Plugin เพื่อโหลดและแสดง โฆษณาจาก BidMachine โดยใช้ สื่อกลาง AdMob ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม BidMachine ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม BidMachine SDK และอะแดปเตอร์เข้ากับแอป Flutter

การผสานรวมและรูปแบบโฆษณาที่รองรับ

อแดปเตอร์สื่อกลาง AdMob สำหรับ BidMachine มีความสามารถต่อไปนี้

การผสานรวม
การเสนอราคา
น้ำตก  1
รูปแบบ
โฆษณาเปิดแอป
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
เนทีฟ

1 การผสานรวมแบบน้ำตกอยู่ในเวอร์ชันเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

ข้อกำหนด

  • ล่าสุดจาก Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • ระดับ API 23 ขึ้นไป ของ Android
  • หากต้องการติดตั้งใช้งานใน iOS ให้ทำดังนี้
    • เป้าหมายการติดตั้งใช้งาน iOS 13.3 ขึ้นไป
  • โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
  • ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

ขั้นตอนที่ 1: ตั้งค่าใน UI ของ BidMachine

เข้าสู่ระบบแดชบอร์ดบัญชี BidMachine

สร้างตําแหน่งโฆษณาใหม่

ไปที่แท็บแหล่งที่มา แล้วเลือกปุ่มแก้ไขในตารางแหล่งที่มา

แดชบอร์ดแหล่งที่มา

คุณจะเห็นรายการตําแหน่งโฆษณาทั้งหมดที่มี หากต้องการสร้างตําแหน่งโฆษณาใหม่ ให้คลิกปุ่มเพิ่มตําแหน่งโฆษณาในกล่องโต้ตอบ

กล่องโต้ตอบแก้ไขแหล่งที่มา

เลือกการเสนอราคาเป็นประเภทตําแหน่ง กรอกแบบฟอร์ม แล้วคลิกบันทึก

Android

สร้างตำแหน่งโฆษณา Android

iOS

สร้างตำแหน่งโฆษณา iOS

สุดท้าย ให้จดรหัสตําแหน่งไว้

Android

รายละเอียดตำแหน่งโฆษณา Android

iOS

รายละเอียดตำแหน่งโฆษณาใน iOS

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น เพื่อป้องกันไม่ให้เกิดการสูญเสียรายได้จากโฆษณาอย่างมาก คุณจะต้องใช้ไฟล์ app-ads.txt หากยังไม่ได้ดำเนินการ ตั้งค่าไฟล์ app-ads.txt สำหรับแอป

หากต้องการใช้ app-ads.txt สำหรับ BidMachine ให้ไปที่แท็บ app-ads.txt จากแดชบอร์ด จากนั้นคัดลอกรายการและ ต่อท้ายในไฟล์ app-ads.txt ของเว็บไซต์

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ BidMachine ใน UI ของ AdMob

กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ Android

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ iOS

เพิ่ม BidMachine ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม BidMachine ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ AdMob

ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ BidMachine

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วย SDK และอะแดปเตอร์ BidMachine เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_bidmachine: ^1.3.2

การผสานรวมด้วยตนเอง

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ BidMachine เวอร์ชันล่าสุด แตกไฟล์ที่ดาวน์โหลดมา แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา (และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน BidMachine SDK

เพื่อปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอรับความยินยอมจากผู้ใช้สำหรับการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมายกำหนด และสำหรับการเก็บรวบรวม การแชร์ และการใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง (Mediation Chain) Google ไม่สามารถส่งต่อตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ

BidMachine จะอ่านความยินยอมตาม GDPR ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ที่ คู่มือ GDPR ของ BidMachine สำหรับ Android และ iOS

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา

กฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ์ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัด สำหรับการแสดงโฆษณาของ Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางของคุณ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจเข้าร่วมในการขายข้อมูลส่วนตัว และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้ เป็นไปตามข้อกำหนด

BidMachine จะอ่านความยินยอม GPP ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ใน คู่มือ GPP ของ BidMachine สำหรับ Android และ iOS

ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม BidMachine

iOS

การผสานรวม SKAdNetwork

โปรดดูเอกสารประกอบของ BidMachine เกี่ยวกับการรองรับ SKAdNetwork เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน

เปิดใช้โฆษณาทดสอบ

ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob แล้ว

ทำตามวิธีการในเอกสารของ BidMachine สำหรับ Android และ iOS เพื่อเปิดใช้โหมดทดสอบสำหรับ BidMachine

ยืนยันโฆษณาทดสอบ

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก BidMachine ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา BidMachine (การเสนอราคา)

รหัสข้อผิดพลาด

หากอแดปเตอร์ไม่ได้รับโฆษณาจาก BidMachine ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับของโฆษณาได้โดยใช้ResponseInfo ในคลาสต่อไปนี้

Android

io.bidmachine
com.google.ads.mediation.bidmachine

iOS

GADMediationAdapterBidMachine

รหัสและข้อความที่มาพร้อมกันซึ่งอแดปเตอร์ BidMachine แสดงเมื่อโหลดโฆษณาไม่สำเร็จมีดังนี้

Android

รหัสข้อผิดพลาด โดเมน เหตุผล
100 com.google.ads.mediation.bidmachine ได้รับรหัสตําแหน่งที่ไม่ถูกต้องหรือว่างเปล่า
101 com.google.ads.mediation.bidmachine ข้อผิดพลาดระหว่างการรวบรวมสัญญาณ: ไม่พบการกำหนดค่าข้อมูลสัญญาณ
102 com.google.ads.mediation.bidmachine ได้รับรูปแบบโฆษณาที่ไม่ถูกต้องระหว่างการรวบรวมสัญญาณ
103 com.google.ads.mediation.bidmachine ไม่สามารถแมปขนาดโฆษณาที่ขอไปยัง bidmachine.BannerSize
104 com.google.ads.mediation.bidmachine คำขอโฆษณา BidMachine ที่โหลดแล้วหมดอายุแล้ว
105 com.google.ads.mediation.bidmachine แสดงโฆษณาแบบเต็มหน้าจอไม่ได้
106 com.google.ads.mediation.bidmachine BidMachine SDK ส่งกลับonAdLoaded()การเรียกกลับพร้อมnullข้อมูลโฆษณา

iOS

รหัสข้อผิดพลาด โดเมน เหตุผล
101 com.google.mediation.bidmachine การกำหนดค่าเซิร์ฟเวอร์ไม่มีรหัสผู้เผยแพร่โฆษณาที่จำเป็น
102 com.google.mediation.bidmachine คำขอรวบรวมสัญญาณการเสนอราคาไม่สำเร็จเนื่องจากพารามิเตอร์ RTB ไม่มีรูปแบบโฆษณาหรือระบบไม่รองรับรูปแบบที่ระบุ
103 com.google.mediation.bidmachine การกำหนดค่าโฆษณาไม่ถูกต้องสำหรับการโหลดโฆษณา
104 com.google.mediation.bidmachine BidMachine SDK แสดงโฆษณาที่ไม่ใช่แบนเนอร์ไปยังBidMachineAdProtocol didLoadAd delegate method ของโฆษณาแบนเนอร์ ไม่ควรเกิดขึ้น
105 com.google.mediation.bidmachine โฆษณาเต็มหน้าจอไม่พร้อมสำหรับการนำเสนอ
106 com.google.mediation.bidmachine SDK ของ Bid Machine แสดงโฆษณาที่ไม่ใช่โฆษณาเนทีฟไปยังBidMachineAdProtocol didLoadAdเมธอด delegate ของโฆษณาเนทีฟ ไม่ควรเกิดขึ้น
107 com.google.mediation.bidmachine โหลดแหล่งที่มาของรูปภาพโฆษณาเนทีฟรายการใดรายการหนึ่งไม่สำเร็จ

บันทึกการเปลี่ยนแปลงของตัวกลาง BidMachine Flutter

เวอร์ชัน 1.5.0 (อยู่ระหว่างดำเนินการ)

เวอร์ชัน 1.4.0 (อยู่ระหว่างดำเนินการ)

เวอร์ชัน 1.3.2

เวอร์ชัน 1.3.1

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0