ผสานรวม Verve HyBid SDK กับสื่อกลาง AdMob

เลือกแพลตฟอร์ม: Android iOS Android (เวอร์ชันเก่า)

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

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

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

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

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

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

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

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

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

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

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

โปรดติดต่อ Verve เพื่อตั้งค่าการกำหนดค่า

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ Verve HyBid SDK ใน UI ของ AdMob

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

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

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

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

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

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

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

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

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

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

คลิกวิธีลงชื่อในข้อตกลงสำหรับพาร์ทเนอร์ แล้ว ตั้งค่าการเป็นพาร์ทเนอร์ด้านการเสนอราคา กับ Verve HyBid SDK



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



หากคุณมีการแมปสำหรับ Verve HyBid SDK อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป



จากนั้นป้อน รหัสโซน และ AppToken ที่ได้รับในส่วนก่อนหน้า แล้วคลิกเสร็จสิ้น

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

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

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

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

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

ใช้ Swift Package Manager

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

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

1. ใน Xcode ให้ไปที่File > Add Package Dependencies...

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

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

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

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

ใช้ CocoaPods

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

  pod 'GoogleMobileAdsMediationVerve'
  

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

  pod install --repo-update

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

• ดาวน์โหลด Verve iOS SDK เวอร์ชันล่าสุดและลิงก์ VerveSDK.framework ในโปรเจ็กต์

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

• เพิ่มเฟรมเวิร์กต่อไปนี้ลงในโปรเจ็กต์

  • AdSupport
  • AVFoundation
  • CoreGraphics
  • CoreMedia
  • CoreTelephony
  • StoreKit
  • SystemConfiguration
  • UIKit
  • WebKit
  • libz.tbd

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

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

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

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

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

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

Verve HyBid SDK รองรับการตั้งค่าความเป็นส่วนตัวผ่านเมธอด โค้ดตัวอย่างต่อไปนี้จะส่งข้อมูลความยินยอมนี้ไปยัง Verve HyBid SDK หากคุณส่งข้อมูลความยินยอม ไปยัง Verve HyBid SDK ด้วยตนเอง เราขอแนะนำให้คุณเรียกใช้ตัวอย่าง ก่อนที่จะขอโฆษณาผ่าน Google Mobile Ads SDK

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)
VerveMediationSwiftSnippets.swift

แทนที่ usPrivacyString ด้วยสตริงความเป็นส่วนตัวของสหรัฐอเมริกา

Objective-C

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];
VerveMediationObjectiveCSnippets.m

แทนที่ kUSPrivacyString ด้วยสตริงความเป็นส่วนตัวของสหรัฐอเมริกา

ดูรายละเอียดได้ที่เอกสารประกอบด้านความเป็นส่วนตัวของ Verve HyBid SDK เกี่ยวกับ การปฏิบัติตามข้อกำหนด CCPA

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

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

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

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

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

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

**สำคัญ:** ปิดใช้โหมดทดสอบสำหรับ AdMob และ Verve HyBid SDK ก่อนเผยแพร่แอป

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

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

ทำตาม เอกสารประกอบของ Verve HyBid SDK เพื่อดูการกำหนดค่าเพิ่มเติม

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

หากอะแดปเตอร์รับโฆษณาจาก Verve HyBid SDK ไม่สำเร็จ ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับของโฆษณาโดยใช้ GADResponseInfo.adNetworkInfoArray ในคลาสต่อไปนี้

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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

รหัสข้อผิดพลาด	เหตุผล
100 ถึง 106	Verve HyBid SDK แสดงข้อผิดพลาด
101	ไม่มี AppToken
102	ผู้ใช้เป็นเด็ก
103	Verve HyBid SDK เริ่มต้นไม่สำเร็จ
104	การกำหนดค่าโฆษณาไม่ถูกต้อง
105	ขนาดแบนเนอร์ไม่รองรับ
106	โฆษณาเต็มหน้าจอไม่พร้อมแสดง
115	ไม่มีรหัสหน่วยโฆษณา โหลดโฆษณาไม่ได้
116	โฆษณาไม่พร้อม แสดงโฆษณาไม่ได้

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

เวอร์ชัน 3.9.0.0

• อัปเดต Google Mobile Ads iOS SDK เวอร์ชันขั้นต่ำเป็น 13.3 เพื่อให้รองรับเวอร์ชันรอง
• ยืนยันความเข้ากันได้กับ HyBid SDK เวอร์ชัน 3.9.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.6.0
• HyBid SDK เวอร์ชัน 3.9.0

เวอร์ชัน 3.8.1.1

• กรองคำขอที่จำกัดอายุสำหรับ Verve SDK เมื่อตั้งค่า ageRestrictedTreatment ใหม่เป็น GADAgeRestrictedTreatmentChild

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

• Google Mobile Ads SDK เวอร์ชัน 13.4.0
• HyBid SDK เวอร์ชัน 3.8.1

เวอร์ชัน 3.8.1.0

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

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

• Google Mobile Ads SDK เวอร์ชัน 13.4.0
• HyBid SDK เวอร์ชัน 3.8.1

เวอร์ชัน 3.8.0.0

• นำการตรวจสอบขนาดแบนเนอร์ออกจากอะแดปเตอร์เพื่อแก้ไขข้อผิดพลาดในการรวบรวมสัญญาณและข้อผิดพลาดในการโหลดโฆษณา
• ยืนยันความเข้ากันได้กับ HyBid SDK เวอร์ชัน 3.8.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.2.0
• HyBid SDK เวอร์ชัน 3.8.0

เวอร์ชัน 3.7.1.3

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

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

• Google Mobile Ads SDK เวอร์ชัน 13.0.0
• HyBid SDK เวอร์ชัน 3.7.1

เวอร์ชัน 3.7.1.2

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

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

• Google Mobile Ads SDK เวอร์ชัน 13.0.0
• HyBid SDK เวอร์ชัน 3.7.1

เวอร์ชัน 3.7.1.1

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

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

• Google Mobile Ads SDK เวอร์ชัน 12.13.0
• HyBid SDK เวอร์ชัน 3.7.1