Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

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

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

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

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

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

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

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

เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป

Google Mobile Ads SDK เวอร์ชันล่าสุด
ตั้งค่าสื่อกลาง AdMob

ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ BidMachine

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

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

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

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

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

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

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

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

สุดท้าย ให้จดบันทึกรหัสตำแหน่งโฆษณา

รายละเอียดของตำแหน่ง

อัปเดต 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

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

คุณต้องเพิ่ม BidMachine ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

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

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

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

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นพร้อมหน่วยโฆษณาที่คุณเลือก

เพิ่ม BidMachine เป็นแหล่งที่มาของโฆษณา

การเสนอราคา

ในส่วนแหล่งที่มาของโฆษณา ให้ค้นหาการ์ดการเสนอราคา แล้วเลือกเพิ่มแหล่งที่มาของโฆษณา จากนั้นเลือก BidMachine

คลิกวิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์และสร้างการเป็นพาร์ทเนอร์เพื่อการเสนอราคากับ BidMachine

คลิกรับทราบและยอมรับ แล้วคลิกต่อไป

หากมีการแมปสำหรับ BidMachine อยู่แล้ว คุณก็เลือกการแมปนั้นได้ หรือไม่เช่นนั้น ให้คลิกเพิ่มการแมป

จากนั้นป้อน รหัสแหล่งที่มาและรหัสตำแหน่งโฆษณา ที่ได้จากส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

น้ำตก

ในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

เลือก BidMachine จากนั้นป้อนค่า eCPM สำหรับ BidMachine แล้วคลิกต่อไป

หากมีการแมปสําหรับ BidMachine อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หรือไม่เช่นนั้น ให้คลิกเพิ่มการแมป

จากนั้นป้อน รหัสตำแหน่งโฆษณา ที่ได้จากส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

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

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

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

แนะนำ: ใช้ Swift Package Manager

ก่อนดำเนินการต่อ คุณต้องมีเวอร์ชันอะแดปเตอร์ขั้นต่ำที่รองรับคือ 3.6.0.0

หากต้องการเพิ่มทรัพยากร Dependency ของแพ็กเกจลงในโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้

ใน Xcode ให้ไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ...
ในข้อความแจ้งที่ปรากฏขึ้น ให้ค้นหา URL ของแพ็กเกจต่อไปนี้
```
https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
```
ในกฎการขึ้นต่อกัน ให้เลือกสาขา
ป้อน main ในช่องข้อความ

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

ดาวน์โหลด BidMachine SDK สำหรับ iOS เวอร์ชันล่าสุด แล้วลิงก์ไฟล์และแพ็กเกจ .xcframework ทั้งหมดในโปรเจ็กต์
ดาวน์โหลดอะแดปเตอร์ BidMachine เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และลิงก์ BidMachineAdapter.xcframework ในโปรเจ็กต์

ใช้ CocoaPods

เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
```
pod 'GoogleMobileAdsMediationBidMachine'
```
เรียกใช้คำสั่งต่อไปนี้จากบรรทัดคำสั่ง
```
pod install --repo-update
```

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

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

อะแดปเตอร์ BidMachine สำหรับ iOS เวอร์ชัน 3.4.0.0 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จากแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับกรอบความโปร่งใสและความยินยอม (TCF) ของ IAB ไปยัง BidMachine SDK ดูข้อมูลเพิ่มเติมได้ที่ GDPR

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

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

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

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

ใช้ SKAdNetwork

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

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

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

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

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

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก BidMachine คุณสามารถตรวจสอบข้อผิดพลาดที่เกี่ยวข้องจากการตอบกลับโฆษณาได้โดยใช้ GADResponseInfo.adNetworkInfoArray ในคลาสต่อไปนี้

GADMediationAdapterBidMachine

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

รหัสข้อผิดพลาด	โดเมน	เหตุผล
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 ไม่รองรับโฆษณาแบนเนอร์ขนาดนี้

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

เวอร์ชัน 3.8.2.0

ยืนยันความเข้ากันได้กับ SDK ของ BidMachine เวอร์ชัน 3.8.2 แล้ว

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.11.0
BidMachine SDK เวอร์ชัน 3.8.2

เวอร์ชัน 3.8.1.0

ยืนยันความเข้ากันได้กับ BidMachine SDK เวอร์ชัน 3.8.1 แล้ว

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.10.0
BidMachine SDK เวอร์ชัน 3.8.1

เวอร์ชัน 3.8.0.0

ยืนยันความเข้ากันได้กับ BidMachine SDK เวอร์ชัน 3.8.0 แล้ว

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.9.0
BidMachine SDK เวอร์ชัน 3.8.0

เวอร์ชัน 3.7.1.1

อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads iOS SDK เป็น 13.3 เพื่อผ่อนปรนและอนุญาตเวอร์ชันย่อย
อัปเดตเพื่อส่งรหัสสถานที่ไปยัง BidMachine SDK เมื่อรวบรวมสัญญาณและโหลดโฆษณา

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.8.0
BidMachine SDK เวอร์ชัน 3.7.1

เวอร์ชัน 3.7.1.0

ยืนยันความเข้ากันได้กับ BidMachine SDK เวอร์ชัน 3.7.1 แล้ว
คำขอโฆษณาแบนเนอร์สำหรับการเสนอราคาคงที่ไม่ได้ส่งขนาดโฆษณาอย่างถูกต้อง

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.4.0
BidMachine SDK เวอร์ชัน 3.7.1

เวอร์ชัน 3.7.0.0

ยืนยันความเข้ากันได้กับ SDK ของ BidMachine เวอร์ชัน 3.7.0 แล้ว

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.4.0
BidMachine SDK เวอร์ชัน 3.7.0

เวอร์ชัน 3.6.1.1

ตอนนี้อะแดปเตอร์จะส่งต่อแฟล็ก ageRestrictedTreatment Google Mobile Ads SDK ไปยัง COPPA API ของ BidMachine SDK
อัปเกรดอะแดปเตอร์ BidMachine และ Unit Test เป็น Swift 6

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 3.6.1.0

ยืนยันความเข้ากันได้กับ SDK ของ BidMachine เวอร์ชัน 3.6.1 แล้ว

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 3.6.0.0

ยืนยันความเข้ากันได้กับ SDK ของ BidMachine เวอร์ชัน 3.6.0 แล้ว
เปลี่ยนโครงสร้างภายในโค้ดการโหลดโฆษณาแบนเนอร์ BidMachine และการจัดการรูปภาพโฆษณาเนทีฟ

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.1.0
SDK ของ BidMachine เวอร์ชัน 3.6.0

เวอร์ชัน 3.5.1.2

อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK เป็นเวอร์ชัน 13.0.0

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.0.0
BidMachine SDK เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.1.1

อัปเดตเวอร์ชัน iOS ขั้นต่ำของ CocoaPods เป็น 13.0
เพิ่มการรองรับการส่งต่อพารามิเตอร์ tagForUnderAgeOfConsent Google Mobile Ads SDK ไปยัง BidMachine SDK
แก้ไขส่วนความสอดคล้อง BidMachineAdDelegate เพื่อให้สอดคล้องกับลักษณะการทำงานของ Callback ของ BidMachine SDK

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 13.0.0
BidMachine SDK เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.1.0

ยืนยันความเข้ากันได้กับ SDK ของ BidMachine เวอร์ชัน 3.5.1 แล้ว

สร้างขึ้นและทดสอบด้วย:

Google Mobile Ads SDK เวอร์ชัน 12.14.0
BidMachine SDK เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.0.0

ยืนยันความเข้ากันได้กับ SDK ของ BidMachine เวอร์ชัน 3.5.0 แล้ว

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 3.4.0.2

เพิ่มการรองรับ Waterfall สำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และรูปแบบโฆษณาเนทีฟ
นำพร็อพเพอร์ตี้แบบคงที่ isTestMode ออกจาก BidMachineAdapterExtras
เพิ่มการตรวจสอบขนาดโฆษณาแบนเนอร์สําหรับโฆษณาแบนเนอร์ Waterfall

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 3.4.0.1

ตอนนี้โหมดทดสอบพร้อมใช้งานใน Objective-C ผ่านพร็อพเพอร์ตี้ GADMediationAdapterBidMachineExtras.isTestMode แล้ว

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 3.4.0.0

การเผยแพร่ครั้งแรก
เพิ่มการรองรับการเสนอราคาสําหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และรูปแบบโฆษณาเนทีฟ
ยืนยันความเข้ากันได้กับ BidMachine SDK เวอร์ชัน 3.4.0 แล้ว

สร้างขึ้นและทดสอบด้วย:

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