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

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

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

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

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

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

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

ข้อกำหนด

• ระดับ API 23 ขึ้นไปของ Android

• [สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ AdMob adapter 3.4.0.1 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)

• ล่าสุดจาก Google Mobile Ads SDK

• ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

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

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

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

หมายเหตุ: BidMachine จะสร้างแหล่งที่มาให้คุณโดยอัตโนมัติ หากต้องการสร้างแหล่งข้อมูลใหม่ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้า

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

กรอกแบบฟอร์มแล้วคลิกบันทึก

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

อัปเดต app-ads.txt

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

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

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

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่ม BidMachine ในบริษัท

การเสนอราคา

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา

น้ำตก

ไปที่ผู้ดูแลระบบ > บริษัท แล้วคลิกปุ่มบริษัทใหม่ ในแท็บบริษัททั้งหมด เลือกเครือข่ายโฆษณา

เลือก BidMachine เป็น เครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน แล้วเปิดใช้สื่อกลาง

คุณไม่จำเป็นต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน คลิกบันทึกเมื่อ เสร็จแล้ว

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

การเสนอราคา

ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

การเสนอราคา

ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ค้นหา BidMachineToken แล้วเปิดเปิดใช้การผสานรวมแอป

คลิกบันทึก

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

การเสนอราคา

ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่า เริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับ SDK Bidding

คลิกบันทึก

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

กำหนดค่าการเสนอราคา BidMachine

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

คลิกผู้เสนอราคารายใหม่

เลือก BidMachine เป็นผู้เสนอราคา

คลิกดำเนินการต่อเพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้

คลิกเสร็จสิ้น

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

กำหนดค่าการแมปหน่วยโฆษณา

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

เลือกบริษัทสำหรับ BidMachine

ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่

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

สุดท้าย ให้คลิกบันทึก

สำคัญ: กำหนดเป้าหมายหน่วยโฆษณาที่เลือกโดยกลุ่มผลตอบแทนอย่างน้อย 1 กลุ่ม และรหัสแหล่งที่มาต้องเชื่อมโยงกับแอปเป้าหมายตามที่แสดงใน UI ของ BidMachine

น้ำตก

ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่ เลือกแอปพลิเคชันบนอุปกรณ์เคลื่อนที่

เลื่อนลงแล้วคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน

เลือกบริษัทที่คุณสร้างไว้สำหรับ BidMachine ในส่วนก่อนหน้า เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม Android เป็นแพลตฟอร์ม และใช้งานอยู่เป็นสถานะ

ป้อน รหัสตําแหน่ง ที่ได้รับในส่วนก่อนหน้า และค่า CPM เริ่มต้น คลิกบันทึก

สำคัญ: รหัสแหล่งที่มาต้อง เชื่อมโยงกับแอปเป้าหมายตามที่ระบุใน UI ของ BidMachine

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

สำคัญ: ตรวจสอบว่าคุณมีสิทธิ์การจัดการบัญชีเพื่อทำการกำหนดค่าให้เสร็จสมบูรณ์ สำหรับการขอความยินยอมของผู้ใช้ EU และ GDPR, กฎระเบียบของรัฐในสหรัฐอเมริกา และแพลตฟอร์มการแสดงข้อความแก่ผู้ใช้ ดูรายละเอียดได้ที่จัดการสิทธิ์ของผู้ใช้ในการเข้าถึงบัญชีของคุณ

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

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

หมายเหตุ: การผสานรวม BidMachine SDK และ Google Mobile Ads SDK เวอร์ชันที่เข้ากันไม่ได้อาจทำให้เกิดปัญหาในการบิลด์

การผสานรวม Android Studio (แนะนํา)

ในไฟล์ Gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency ในการติดตั้งใช้งานต่อไปนี้

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.3.0")
    implementation("com.google.ads.mediation:bidmachine:3.7.0.0")
}

ดึงดูด

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.3.0'
    implementation 'com.google.ads.mediation:bidmachine:3.7.0.0'
}

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

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

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

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

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

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

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

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

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ Ad Manager และ BidMachine ก่อนที่จะเปิดตัวแอป

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

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

ขั้นตอนที่ไม่บังคับ

โฆษณาเนทีฟ

การแสดงโฆษณา

อแดปเตอร์ BidMachine จะแสดงโฆษณาเนทีฟเป็น NativeAd ออบเจ็กต์ โดยจะป้อนข้อมูลต่อไปนี้ ฟิลด์ สำหรับ NativeAd

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

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

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

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

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

รหัสข้อผิดพลาด	โดเมน	เหตุผล
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ข้อมูลโฆษณา

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

เวอร์ชันถัดไป

• แมป AgeRestrictedTreatment กับ COPPA API ของ BidMachine

เวอร์ชัน 3.7.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ BidMachine SDK เวอร์ชัน 3.7.0 ได้

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 25.1.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.1.0
• BidMachine SDK เวอร์ชัน 3.7.0

เวอร์ชัน 3.6.1.0

• เพิ่มพร็อพเพอร์ตี้เพื่อสร้างอะแดปเตอร์ที่มีทรัพยากร Dependency ของ GMA Next-Gen SDK
• ได้รับการยืนยันว่าใช้งานร่วมกับ BidMachine SDK เวอร์ชัน 3.6.1 ได้

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 25.1.0
• BidMachine SDK เวอร์ชัน 3.6.1

เวอร์ชัน 3.5.1.2

• อัปเดตอะแดปเตอร์ BidMachine เพื่อใช้ AdPlacementConfig

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• SDK ของ BidMachine เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.1.1

• เพิ่มการรองรับการส่งต่อพารามิเตอร์ tagForUnderAgeOfConsent Google Mobile Ads SDK ไปยัง BidMachine SDK

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• SDK ของ BidMachine เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.1.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ BidMachine SDK เวอร์ชัน 3.5.1 ได้

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• SDK ของ BidMachine เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ BidMachine SDK เวอร์ชัน 3.5.0 ได้

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• BidMachine SDK เวอร์ชัน 3.5.0

เวอร์ชัน 3.4.0.1

• นำการอ้างอิงระดับคลาสไปยังออบเจ็กต์ Context ออกเพื่อช่วยแก้ไขปัญหาหน่วยความจำรั่วไหล
• อัปเดตอแดปเตอร์เพื่อรองรับคำขอโฆษณาแบนเนอร์ที่มีขนาดใกล้เคียงกับ รูปแบบที่รองรับ แทนที่จะกำหนดให้มีขนาดที่ตรงกัน

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• BidMachine SDK เวอร์ชัน 3.4.0

เวอร์ชัน 3.4.0.0

• เพิ่มการรองรับสื่อกลางตามลำดับขั้นสำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
• ตอนนี้อแดปเตอร์จะส่งต่อ onAdOpened() พร้อม onAdImpression() สำหรับโฆษณาแบบเต็มหน้าจอ
• ได้รับการยืนยันว่าใช้งานร่วมกับ SDK ของ BidMachine เวอร์ชัน 3.4.0 ได้

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 24.6.0
• BidMachine SDK เวอร์ชัน 3.4.0

เวอร์ชัน 3.3.0.0

• รุ่นแรก

สร้างและทดสอบด้วย

• Google Mobile Ads SDK เวอร์ชัน 24.5.0
• BidMachine SDK เวอร์ชัน 3.3.0