คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดง โฆษณาจาก PubMatic โดยใช้ AdMob Mediation ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม PubMatic ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม PubMatic และอ ะแดปเตอร์เข้ากับแอป iOS
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อแดปเตอร์สื่อกลางสำหรับ PubMatic มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | |
| รูปแบบ | |
| โฆษณาเปิดแอป | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
Google Mobile Ads SDK เวอร์ชันล่าสุด
ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ PubMatic
เข้าสู่ระบบบัญชี PubMatic แล้ว เลือกการ์ด OpenWrap SDK
เพิ่มแอปพลิเคชันใหม่
ไปที่แท็บแอป แล้วคลิกปุ่มเพิ่มแอป
เลือกแพลตฟอร์ม รวมถึง URL ของ App Store และชื่อแอปสำหรับ แอปของคุณ
ในส่วนเส้นทางการผสานรวม ให้เลือก iOS (Objective-C / Swift) แล้วเลือก AdMob - การเสนอราคา SDK เป็นเส้นทางการผสานรวมย่อย จากนั้นคลิกปุ่มเพิ่มแอป
อัปเดต app-ads.txt
ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย
พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก
หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับแอป
ก่อนที่จะสรุปแอป คุณจะเห็นรายการที่เหมาะสมเพื่อ
เพิ่มลงใน app-ads.txt
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีติดตั้งใช้งาน app-ads.txt สำหรับ PubMatic ได้ที่วิธีติดตั้งใช้งาน app-ads.txt
รหัสโปรไฟล์
เมื่อสร้างแอปแล้ว ให้ไปที่แท็บแอปและจดรหัสโปรไฟล์ของแอปพลิเคชันที่สร้างขึ้นใหม่
สร้างหน่วยโฆษณา
ในแท็บหน่วยโฆษณา ให้เลือกแอปที่คุณสร้างไว้ในส่วนก่อนหน้า แล้วคลิกปุ่มสร้างหน่วยโฆษณา
กรอกรายละเอียดหน่วยโฆษณาในแบบฟอร์ม แล้วคลิกบันทึก
จดบันทึกรหัสหน่วยโฆษณา OpenWrap ที่สร้างขึ้นใหม่
รับรหัสผู้เผยแพร่โฆษณา
ไปที่แดชบอร์ดข้อมูลวิเคราะห์ วางเมาส์เหนือไอคอนโปรไฟล์และจดรหัสของคุณ
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ PubMatic ใน UI ของ AdMob
กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
คุณต้องเพิ่ม PubMatic OpenWrap SDK ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา
ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางอยู่แล้วที่ต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่ เพิ่ม SDK ของ PubMatic OpenWrap เป็นแหล่งที่มาของโฆษณา
หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง
ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป
ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ตั้งที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา
เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่ อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น
ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก
เพิ่ม PubMatic OpenWrap SDK เป็นแหล่งที่มาของโฆษณา
ในส่วนแหล่งที่มาของโฆษณา ภายใต้การ์ดการเสนอราคา ให้เลือกเพิ่ม แหล่งที่มาของโฆษณา จากนั้นเลือก PubMatic OpenWrap SDKคลิกวิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์และ ตั้งค่าการเป็นพาร์ทเนอร์ด้านการเสนอราคากับ PubMatic OpenWrap SDK
คลิกรับทราบและยอมรับ แล้วคลิกต่อไป
หากมีการแมปสำหรับ PubMatic OpenWrap SDK อยู่แล้ว คุณก็เลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป
จากนั้น ป้อน รหัสหน่วยโฆษณา OpenWrap ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น
เพิ่ม PubMatic ลงในรายการพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทำตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม PubMatic ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ AdMob
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ของ PubMatic
CocoaPods (แนะนำ)
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationPubMatic'จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
การผสานรวมด้วยตนเอง
ดาวน์โหลดเวอร์ชันล่าสุดของ PubMatic OpenWrap SDK สำหรับ iOS และลิงก์ไฟล์และแพ็กเกจ
.xcframeworkทั้งหมดในโปรเจ็กต์ดาวน์โหลดอแดปเตอร์ PubMatic เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลด ในบันทึกการเปลี่ยนแปลงและลิงก์
PubMaticAdapter.xcframeworkในโปรเจ็กต์
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน PubMatic SDK
เพื่อปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอรับความยินยอมจากผู้ใช้สำหรับการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมายกำหนด และสำหรับการเก็บรวบรวม การแชร์ และการใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน ห่วงโซ่สื่อกลาง
PubMatic จะอ่านความยินยอมตาม GDPR ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรองรับข้อกําหนดความยินยอมเพิ่มเติมของ Google รวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ที่ ส่งความยินยอมตาม GDPR และ GDPR
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ์ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัด สำหรับการแสดงโฆษณาของ Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางของคุณ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจเข้าร่วมในการขายข้อมูลส่วนตัว และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้ เป็นไปตามข้อกำหนด
PubMatic จะอ่านความยินยอม GPP ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรองรับข้อกำหนดความยินยอมเพิ่มเติมของ Google รวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ที่ ส่งต่อความยินยอมของ GPP
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
การผสานรวม SKAdNetwork
ทําตามเอกสารประกอบของ PubMatic
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob แล้ว
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก PubMatic OpenWrap SDK ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา PubMatic (การเสนอราคา)
ขั้นตอนที่ไม่บังคับ
โฆษณาเนทีฟ
การแสดงโฆษณา
อแดปเตอร์ PubMatic จะแสดงโฆษณาเนทีฟเป็น
GADNativeAd
ออบเจ็กต์ โดยจะป้อนข้อมูลต่อไปนี้
ฟิลด์
สำหรับ
GADNativeAd
| ช่อง | ชิ้นงานที่อะแดปเตอร์ PubMatic รวมไว้เสมอ |
|---|---|
| บรรทัดแรก | |
| รูปภาพ | |
| เนื้อความ | |
| Icon | |
| คำกระตุ้นการตัดสินใจ | |
| การให้ดาว | |
| ร้านค้า | |
| ราคา | |
| ผู้ลงโฆษณา |
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก PubMatic คุณสามารถตรวจสอบ
ข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้
GADResponseInfo.adNetworkInfoArray
ภายใต้คลาสต่อไปนี้
GADMediationAdapterPubMatic
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกันซึ่งอแดปเตอร์ PubMatic แสดงเมื่อโหลดโฆษณาไม่สำเร็จ
| รหัสข้อผิดพลาด | โดเมน | เหตุผล |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | การกำหนดค่าเซิร์ฟเวอร์ไม่มีรหัสผู้เผยแพร่โฆษณาที่จำเป็น |
| 102 | com.google.ads.mediation.pubmatic | คำขอรวบรวมสัญญาณการเสนอราคาไม่สำเร็จเนื่องจากมีการระบุรูปแบบหลายรูปแบบ ไม่มีรูปแบบ หรือรูปแบบที่ไม่รองรับในพารามิเตอร์คำขอ |
| 103 | com.google.ads.mediation.pubmatic | การกำหนดค่าโฆษณาไม่ถูกต้องสำหรับการโหลดโฆษณา |
| 104 | com.google.ads.mediation.pubmatic | แสดงโฆษณาคั่นระหว่างหน้าไม่สำเร็จเนื่องจากโฆษณาไม่พร้อม |
| 105 | com.google.ads.mediation.pubmatic | แสดงโฆษณาที่มีการให้รางวัลไม่สำเร็จเนื่องจากโฆษณายังไม่พร้อม |
| 106 | com.google.ads.mediation.pubmatic | โหลดแหล่งที่มาของรูปภาพโฆษณาเนทีฟรายการใดรายการหนึ่งไม่สำเร็จ |
| 1001-5002 | ส่งโดย SDK ของ PubMatic | SDK ของ PubMatic แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ PubMatic |
บันทึกการเปลี่ยนแปลงของอแดปเตอร์สื่อกลาง iOS ของ PubMatic
เวอร์ชัน 4.8.1.1 (อยู่ระหว่างดำเนินการ)
- รองรับรูปแบบโฆษณาคั่นระหว่างหน้าแบบลำดับขั้น
- รองรับรูปแบบโฆษณาที่มีการให้รางวัลแบบ Waterfall
- รองรับรูปแบบโฆษณาแบนเนอร์ Waterfall
- รองรับรูปแบบโฆษณาเนทีฟแบบ Waterfall
- แก้ไขข้อบกพร่องที่ไม่ได้ตั้งค่าผู้มอบสิทธิ์โฆษณาเนทีฟอย่างถูกต้อง
- รวม Info.plist ไว้ในเฟรมเวิร์ก
เวอร์ชัน 4.8.1.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ PubMatic OpenWrap SDK เวอร์ชัน 4.8.1 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 12.9.0
- PubMatic OpenWrap SDK เวอร์ชัน 4.8.1
เวอร์ชัน 4.8.0.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ PubMatic OpenWrap SDK เวอร์ชัน 4.8.0 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 12.8.0
- PubMatic OpenWrap SDK เวอร์ชัน 4.8.0
เวอร์ชัน 4.7.0.0
- รุ่นแรก
- รองรับการเสนอราคาสำหรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
- ได้รับการยืนยันว่าใช้งานร่วมกับ PubMatic OpenWrap SDK เวอร์ชัน 4.7.0 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 12.6.0
- PubMatic OpenWrap SDK เวอร์ชัน 4.7.0