ผสานรวม Verve HyBid SDK กับการเสนอราคา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก

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

ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ค้นหา Verve HyBid SDK แล้วเปิดเปิดใช้การผสานรวมแอป

คลิกบันทึก

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

ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่าเริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัย สำหรับการเสนอราคา SDK

คลิกบันทึก

กำหนดค่าการเสนอราคา Verve HyBid SDK

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

คลิกผู้เสนอราคารายใหม่

เลือก Verve Group เป็นผู้เสนอราคา

คลิกดำเนินการต่อ เพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้

คลิกเสร็จสิ้น

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

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

เลือกบริษัทสำหรับ Verve HyBid SDK

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

เลือกหน่วยโฆษณาที่เฉพาะเจาะจง เลือกหน่วยโฆษณาและรูปแบบ แอปบนอุปกรณ์เคลื่อนที่ เป็น ประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อนรหัสโซน และAppToken ที่ได้รับในส่วนก่อนหน้า

หากกําลังกำหนดค่าการแมปหน่วยโฆษณาสำหรับ โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัลภายใน UI ของ Ad Manager ให้เลือกรูปแบบ**มีการให้รางวัล** และใช้รหัสตำแหน่งโฆษณาคั่นระหว่างหน้า ที่มีการให้รางวัล

สุดท้าย ให้คลิกบันทึก

**สำคัญ:** กำหนดเป้าหมายหน่วยโฆษณาที่เลือกโดยกลุ่มผลตอบแทนอย่างน้อย 1 กลุ่ม

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

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

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

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

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

ใช้ Swift Package Manager

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

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

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

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: ทดสอบการติดตั้งใช้งาน

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

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

**สำคัญ:** ปิดใช้โหมดทดสอบสำหรับ Ad Manager และ 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

• อัปเดต CocoaPods iOS เวอร์ชันขั้นต่ำเป็น 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