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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

คู่มือนี้จะแสดงวิธีใช้ 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 24 ขึ้นไปของ Android
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
  • โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
  • ตั้งค่าสื่อกลาง AdMob

ขั้นตอนที่ 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 ต่อไปนี้พร้อมกับ BidMachine SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_bidmachine: ^1.5.0

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

ดาวน์โหลดปลั๊กอินสื่อกลาง 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)

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 ของโฆษณาแบนเนอร์ ไม่ควรเกิดขึ้น
105 com.google.mediation.bidmachine โฆษณาแบบเต็มหน้าจอไม่พร้อมสำหรับการนำเสนอ
106 com.google.mediation.bidmachine SDK ของ Bid Machine แสดงโฆษณาที่ไม่ใช่โฆษณาเนทีฟไปยังBidMachineAdProtocol didLoadAdเมธอด delegate ของโฆษณาเนทีฟ ไม่ควรเกิดขึ้น
107 com.google.mediation.bidmachine โหลดแหล่งที่มาของรูปภาพโฆษณาเนทีฟรายการใดรายการหนึ่งไม่สำเร็จ
108 com.google.mediation.bidmachine BidMachine ไม่รองรับโฆษณาแบนเนอร์ขนาดนี้

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

เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.2

เวอร์ชัน 1.4.1

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.2

เวอร์ชัน 1.3.1

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0