คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดง โฆษณาจาก BidMachine โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม BidMachine ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม BidMachine SDK และอะแดปเตอร์เข้ากับแอป iOS
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อแดปเตอร์สื่อกลางสำหรับ BidMachine มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | 1 |
| รูปแบบ | |
| โฆษณาเปิดแอป | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
1 การผสานรวมแบบน้ำตกอยู่ในเวอร์ชันเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
ล่าสุดจาก Google Mobile Ads SDK
ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์
ขั้นตอนที่ 1: ตั้งค่าใน UI ของ 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
ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่
เลือกหน่วยโฆษณาที่เฉพาะเจาะจง เลือกหน่วยโฆษณาและรูปแบบ แอปบนอุปกรณ์เคลื่อนที่เป็น ประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อนรหัสแหล่งที่มาและรหัสตําแหน่ง ที่ได้รับในส่วนก่อนหน้า
สุดท้าย ให้คลิกบันทึก
น้ำตก
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่ เลือกแอปพลิเคชันบนอุปกรณ์เคลื่อนที่
เลื่อนลงแล้วคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน
เลือกบริษัทที่คุณสร้างไว้สำหรับ BidMachine ในส่วนก่อนหน้า เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม iOS เป็นแพลตฟอร์ม และใช้งานอยู่เป็นสถานะ
ป้อน รหัสตําแหน่ง ที่ได้รับในส่วนก่อนหน้า และค่า CPM เริ่มต้น คลิกบันทึก
เพิ่ม BidMachine ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม BidMachine ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ BidMachine
ใช้ Swift Package Manager
ก่อนดำเนินการต่อ คุณต้องมีอะแดปเตอร์เวอร์ชันขั้นต่ำที่รองรับ 3.6.0.0
หากต้องการเพิ่มทรัพยากร Dependency ของแพ็กเกจ ในโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้
ใน Xcode ให้ไปที่ไฟล์ > เพิ่มการขึ้นต่อกันของแพ็กเกจ...
ในข้อความแจ้งที่ปรากฏขึ้น ให้ค้นหา URL ของแพ็กเกจต่อไปนี้
https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.gitในกฎการขึ้นต่อกัน ให้เลือกสาขา
ป้อน
mainในช่องข้อความ
ใช้ CocoaPods
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationBidMachine'จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
ดาวน์โหลดเวอร์ชันล่าสุดของ BidMachine SDK สำหรับ iOS และลิงก์ไฟล์และแพ็กเกจ
.xcframeworkทั้งหมดในโปรเจ็กต์ดาวน์โหลดอแดปเตอร์ BidMachine เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลด ในบันทึกการเปลี่ยนแปลงและลิงก์
BidMachineAdapter.xcframeworkในโปรเจ็กต์
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน BidMachine SDK
เพื่อปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอรับความยินยอมจากผู้ใช้สำหรับการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมายกำหนด และสำหรับการเก็บรวบรวม การแชร์ และการใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง (Mediation Chain) Google ไม่สามารถส่งต่อตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
BidMachine จะอ่านความยินยอมตาม GDPR ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอม ซึ่งรวมถึง UMP SDK โดยอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่ GDPR
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ์ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" ของตน (ตามที่กฎหมายให้คำจำกัดความไว้ สำหรับคำเหล่านั้น) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัด สำหรับการแสดงโฆษณาของ Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางของคุณ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจเข้าร่วมในการขายข้อมูลส่วนตัว และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้ เป็นไปตามข้อกำหนด
BidMachine จะอ่านความยินยอม GPP ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ที่ GPP
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
ติดตั้งใช้งาน SKAdNetwork
ทําตามเอกสารประกอบของ BidMachine
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
ทำตามวิธีการในเอกสารของ 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เมธอด delegate ของโฆษณาแบนเนอร์ ไม่ควรเกิดขึ้น |
| 105 | com.google.mediation.bidmachine | โฆษณาเต็มหน้าจอไม่พร้อมสำหรับการนำเสนอ |
| 106 | com.google.mediation.bidmachine | SDK ของ Bid Machine แสดงโฆษณาที่ไม่ใช่โฆษณาเนทีฟไปยังBidMachineAdProtocol didLoadAdเมธอด delegate ของโฆษณาเนทีฟ ไม่ควรเกิดขึ้น |
| 107 | com.google.mediation.bidmachine | โหลดแหล่งที่มาของรูปภาพโฆษณาเนทีฟรายการใดรายการหนึ่งไม่สำเร็จ |
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง iOS ของ BidMachine
เวอร์ชัน 3.7.0.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ BidMachine SDK เวอร์ชัน 3.7.0 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.4.0
- BidMachine SDK เวอร์ชัน 3.7.0
เวอร์ชัน 3.6.1.1
- ตอนนี้อแดปเตอร์จะส่งต่อ
ageRestrictedTreatmentแฟล็ก Google Mobile Ads SDK ไปยัง API ของ COPPA ของ BidMachine SDK - อัปเกรดอะแดปเตอร์ BidMachine และการทดสอบหน่วยเป็น Swift 6
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.3.0
- BidMachine SDK เวอร์ชัน 3.6.1
เวอร์ชัน 3.6.1.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ BidMachine SDK เวอร์ชัน 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
- BidMachine SDK เวอร์ชัน 3.6.0
เวอร์ชัน 3.5.1.2
- อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK เป็นเวอร์ชัน 13.0.0
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.0.0
- SDK ของ BidMachine เวอร์ชัน 3.5.1
เวอร์ชัน 3.5.1.1
- อัปเดตเวอร์ชัน iOS ขั้นต่ำของ CocoaPods เป็น
13.0 - เพิ่มการรองรับการส่งต่อ
tagForUnderAgeOfConsentพารามิเตอร์ Google Mobile Ads SDK ไปยัง BidMachine SDK - แก้ไข
BidMachineAdDelegateส่วนการปฏิบัติตามข้อกำหนดให้สอดคล้องกับลักษณะการทำงานของแฮนเดิลการเรียกกลับของ BidMachine SDK
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.0.0
- SDK ของ BidMachine เวอร์ชัน 3.5.1
เวอร์ชัน 3.5.1.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ BidMachine SDK เวอร์ชัน 3.5.1 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 12.14.0
- SDK ของ BidMachine เวอร์ชัน 3.5.1
เวอร์ชัน 3.5.0.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ BidMachine SDK เวอร์ชัน 3.5.0 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 12.12.0
- BidMachine SDK เวอร์ชัน 3.5.0
เวอร์ชัน 3.4.0.2
- เพิ่มการรองรับสื่อกลางตามลำดับขั้นสำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
- นำพร็อพเพอร์ตี้แบบคงที่
isTestModeออกจากBidMachineAdapterExtras - เพิ่มการตรวจสอบขนาดโฆษณาแบนเนอร์สำหรับโฆษณาแบนเนอร์สื่อกลางตามลำดับขั้น
สร้างและทดสอบด้วย
- 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
- รุ่นแรก
- เพิ่มการรองรับการเสนอราคาสำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
- ได้รับการยืนยันว่าใช้งานร่วมกับ SDK ของ BidMachine เวอร์ชัน 3.4.0 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 12.8.0
- BidMachine SDK เวอร์ชัน 3.4.0