ผสานรวม 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
น้ำตก
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
ได้รับรางวัลแล้ว
เนทีฟ

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

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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



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



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



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

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

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

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

ใช้ Swift Package Manager

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

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

  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

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

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

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

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

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

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)

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

Objective-C

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];

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

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

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

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

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

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

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

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

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

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

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

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

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

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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

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

บันทึกการเปลี่ยนแปลงของ Verve iOS Mediation Adapter

เวอร์ชัน 3.9.0.0 (อยู่ระหว่างดำเนินการ)

  • อัปเดตเวอร์ชัน iOS ขั้นต่ำเพื่อลดการพึ่งพา SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่ออนุญาตเวอร์ชันย่อย

เวอร์ชัน 3.8.1.1

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

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

  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 13.4.0
  • HyBid SDK เวอร์ชัน 3.8.1

เวอร์ชัน 3.8.1.0

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

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

  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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