ผสานรวม PubMatic กับการเสนอราคา

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

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

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

¹ การผสานรวม Waterfall อยู่ในเวอร์ชันอัลฟ่า

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

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

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

• Google Mobile Ads SDK เวอร์ชันล่าสุด

• ตั้งค่าสื่อกลาง

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

ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี PubMatic แล้วเลือกการ์ด OpenWrap SDK

เพิ่มแอปพลิเคชันใหม่

ไปที่แท็บแอป แล้วคลิกปุ่มเพิ่มแอป

เลือกแพลตฟอร์ม รวมถึง URL ของ App Store และชื่อแอปสำหรับแอปของคุณ

ในส่วนเส้นทางการผสานรวม ให้เลือก iOS (Objective-C / Swift) และเลือกการเสนอราคา SDK ของ AdMob เป็นเส้นทางการผสานรวมย่อย จากนั้นคลิกปุ่มเพิ่มแอป

อัปเดต app-ads.txt

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

ก่อนที่แอปจะเสร็จสมบูรณ์ ระบบจะแสดงรายการที่เหมาะสมให้คุณเพิ่มลงใน app-ads.txt

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ app-ads.txt สำหรับ PubMatic ได้ที่วิธีใช้ app-ads.txt

รหัสโปรไฟล์

เมื่อสร้างแอปแล้ว ให้ไปที่แท็บแอป และจดบันทึกรหัสโปรไฟล์ของแอปพลิเคชันที่สร้างขึ้นใหม่

สร้างหน่วยโฆษณา

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

กรอกรายละเอียดของหน่วยโฆษณาในแบบฟอร์ม แล้วคลิกบันทึก

จดบันทึกรหัสหน่วยโฆษณา OpenWrap ที่สร้างขึ้นใหม่

รับรหัสผู้เผยแพร่โฆษณา

ไปที่แดชบอร์ด Analytics วางเมาส์เหนือไอคอนโปรไฟล์และจดบันทึกรหัส

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

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

เพิ่ม PubMatic OpenWrap SDK ในบริษัท

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

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

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

กำหนดค่าการเสนอราคา SDK ของ PubMatic OpenWrap

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

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

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

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

ใช้ Swift Package Manager

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

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

1. ใน Xcode ให้ไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ...

2. ในข้อความแจ้งที่ปรากฏขึ้น ให้ค้นหา URL ของแพ็กเกจต่อไปนี้

   https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.git
   

3. ในกฎการขึ้นต่อกัน ให้เลือกสาขา

4. ป้อน main ในช่องข้อความ

ใช้ CocoaPods

• เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์

  pod 'GoogleMobileAdsMediationPubMatic'
  

• เรียกใช้คำสั่งต่อไปนี้จากบรรทัดคำสั่ง

  pod install --repo-update

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

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

2. ดาวน์โหลดอะแดปเตอร์ PubMatic เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลงและลิงก์ PubMaticAdapter.xcframework ในโปรเจ็กต์

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

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

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

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

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

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

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

ติดตั้งใช้งาน SKAdNetwork

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

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

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

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

GADMediationAdapterPubMatic

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

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

เวอร์ชัน 5.4.1.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 5.4.1

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

• Google Mobile Ads SDK เวอร์ชัน 13.10.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.4.1

เวอร์ชัน 5.4.0.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 5.4.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.9.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.4.0

เวอร์ชัน 5.3.0.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 5.3.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 13.8.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.3.0

เวอร์ชัน 5.2.0.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 5.2.0
• ตอนนี้ต้องใช้ Google Mobile Ads SDK เวอร์ชัน 13.6 ขึ้นไป
• เพิ่มการรองรับชิ้นงานวิดีโอในโฆษณาเนทีฟโดยใช้ mediaView API

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

• Google Mobile Ads SDK เวอร์ชัน 13.7.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.2.0

เวอร์ชัน 5.1.1.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 5.1.1 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 13.4.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.1.1

เวอร์ชัน 5.1.0.1

• ตอนนี้อะแดปเตอร์จะส่งต่อแฟล็ก ageRestrictedTreatment Google Mobile Ads SDK ไปยัง COPPA API ของ PubMatic OpenWrap SDK

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

• Google Mobile Ads SDK เวอร์ชัน 13.3.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.1.0

เวอร์ชัน 5.1.0.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 5.1.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 13.3.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.1.0

เวอร์ชัน 5.0.1.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 5.0.1 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 13.2.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.0.1

เวอร์ชัน 5.0.0.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 5.0.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.1.0
• PubMatic OpenWrap SDK เวอร์ชัน 5.0.0

เวอร์ชัน 4.12.0.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 4.12.0 แล้ว
• อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK เป็นเวอร์ชัน 13.0.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.0.0
• PubMatic OpenWrap SDK เวอร์ชัน 4.12.0

เวอร์ชัน 4.11.0.2

• อัปเดตเวอร์ชัน iOS ขั้นต่ำของ CocoaPods เป็น 13.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.0.0
• PubMatic OpenWrap SDK เวอร์ชัน 4.11.0

เวอร์ชัน 4.11.0.1

• เพิ่มการรองรับการส่งต่อพารามิเตอร์ tagForChildDirectedTreatment และ tagForUnderAgeOfConsent ของ Google Mobile Ads SDK ไปยัง PubMatic OpenWrap SDK

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

• Google Mobile Ads SDK เวอร์ชัน 12.14.0
• PubMatic OpenWrap SDK เวอร์ชัน 4.11.0

เวอร์ชัน 4.11.0.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 4.11.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 12.14.0
• PubMatic OpenWrap SDK เวอร์ชัน 4.11.0

เวอร์ชัน 4.10.0.0

• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 4.10.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 12.12.0
• PubMatic OpenWrap SDK เวอร์ชัน 4.10.0

เวอร์ชัน 4.9.0.0

• เพิ่มการรองรับ Waterfall สำหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และรูปแบบโฆษณาเนทีฟ
• แก้ไขข้อบกพร่องที่ตั้งค่าผู้รับมอบสิทธิ์โฆษณาเนทีฟไม่ถูกต้อง
• เพิ่มพร็อพเพอร์ตี้โหมดทดสอบในคลาส GADMediationAdapterPubMaticExtras
• ยืนยันความเข้ากันได้กับ PubMatic OpenWrap SDK เวอร์ชัน 4.9.0

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

• Google Mobile Ads SDK เวอร์ชัน 12.12.0
• PubMatic OpenWrap SDK เวอร์ชัน 4.9.0

เวอร์ชัน 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