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

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

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

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้

  • Google Mobile Ads Flutter Plugin เวอร์ชันล่าสุด
  • เฟรมเวิร์ก Flutter เวอร์ชัน 3.7.0 ขึ้นไป
  • วิธีติดตั้งใช้งานใน Android
    • Android API ระดับ 24 ขึ้นไป
  • วิธีติดตั้งใช้งานใน 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

    (Android เท่านั้น) เพิ่มที่เก็บต่อไปนี้ลงในไฟล์ build.gradle ภายในไดเรกทอรี android ของโปรเจ็กต์

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifactory.bidmachine.io/bidmachine")
      }
  }

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

    dependencies:
  gma_mediation_bidmachine: ^1.5.1

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

    ดาวน์โหลดปลั๊กอินสื่อกลาง 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 Flutter เวอร์ชัน 1.0.0 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จากแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับกรอบความโปร่งใสและความยินยอม (TCF) ของ IAB ไปยัง SDK ของ BidMachine ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบเกี่ยวกับ GDPR ของ BidMachine สำหรับ Android และ iOS

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

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

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

    บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Flutter ของ BidMachine

    รุ่น 1.5.1

    เวอร์ชัน 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