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

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

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

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

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

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

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

ข้อกำหนด

  • ล่าสุด Google Mobile Ads Unity Plugin
  • Unity 2019.4 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • Android API ระดับ 23 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity 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: นำเข้า BidMachine SDK และอะแดปเตอร์

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI ไว้ คุณสามารถติดตั้งปลั๊กอินสื่อกลาง Google Mobile Ads BidMachine สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จาก ไดเรกทอรีรากของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.bidmachine

OpenUPM

ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > ตัวจัดการแพ็กเกจ เพื่อเปิด การตั้งค่าตัวจัดการแพ็กเกจ Unity

ในแท็บรีจิสทรีที่มีขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่มีขอบเขตโดยใช้รายละเอียดต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่ หน้าต่าง > ตัวจัดการแพ็กเกจ เพื่อเปิด ตัวจัดการแพ็กเกจ Unity และ เลือก รีจิสทรีของฉัน จากเมนูแบบเลื่อนลง

รีจิสทรีของ Unity

เลือกแพ็กเกจ Google Mobile Ads BidMachine Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ BidMachine เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน บันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsBidMachineMediation.unitypackage จากไฟล์ ZIP

ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือกชิ้นงาน > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsBidMachineMediation.unitypackage ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว จากนั้นคลิกนำเข้า

นำเข้าจาก Unity

จากนั้นเลือกชิ้นงาน > ตัวจัดการการพึ่งพาภายนอก > ตัวแก้ปัญหา Android > บังคับแก้ปัญหา ไลบรารีตัวจัดการการพึ่งพาภายนอกจะทำการแก้ปัญหาทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ลงในไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับปิด

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

บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง BidMachine Unity

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.1

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.2

เวอร์ชัน 1.0.1

เวอร์ชัน 1.0.0