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

เลือกแพลตฟอร์ม: Android iOS Android (เดิม)

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

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

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

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

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

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

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

  • ระดับ API 23 ขึ้นไปของ Android

ขั้นตอนที่ 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 และอแดปเตอร์

ในไฟล์ settings.gradle.kts ระดับโปรเจ็กต์ ให้เพิ่มที่เก็บต่อไปนี้ 

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
    }
  }
}

จากนั้นในไฟล์ build.gradle.kts ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการใช้งานต่อไปนี้ ใช้ Verve HyBid SDK และอะแดปเตอร์เวอร์ชันล่าสุดโดยทำดังนี้ 

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:verve:3.9.2.0")
}

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

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

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

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

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

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

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)

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

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

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

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Verve HyBid SDK

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

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

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

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

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

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

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

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

net.pubnative.lite.sdk
com.google.ads.mediation.verve

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

รหัสข้อผิดพลาด โดเมน เหตุผล
101 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ SDK ของ Verve HyBid รองรับ
102 net.pubnative.lite.sdk ข้อผิดพลาดของ Verve HyBid - โหลดโฆษณาไม่ได้
103 com.google.ads.mediation.verve พยายามแสดงโฆษณาเต็มหน้าจอที่เป็นค่าว่าง
104 com.google.ads.mediation.verve MobileAds.getRequestConfiguration() ระบุว่าผู้ใช้เป็นเด็ก เราจะหยุดให้บริการ Verve

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

เวอร์ชัน 3.9.2.0

  • ปักหมุดการอ้างอิง Kotlin ของอแดปเตอร์เป็น 1.9.0 (เวอร์ชัน Kotlin ขั้นต่ำที่ GMA NextGen SDK รองรับ)
  • ยืนยันความเข้ากันได้กับ Verve HyBid SDK เวอร์ชัน 3.9.2

สร้างขึ้นและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 25.4.0
  • Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
  • Verve HyBid SDK เวอร์ชัน 3.9.2

เวอร์ชัน 3.9.1.0

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

สร้างขึ้นและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 25.4.0
  • Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.3.1
  • Verve HyBid SDK เวอร์ชัน 3.9.1

เวอร์ชัน 3.9.0.0

  • กรองคำขอที่ถูกจำกัดอายุสำหรับ Verve SDK เมื่อตั้งค่า AgeRestrictedTreatment ใหม่เป็น CHILD
  • ยืนยันความเข้ากันได้กับ Verve HyBid SDK เวอร์ชัน 3.9.0

สร้างขึ้นและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 25.4.0
  • Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
  • Verve HyBid SDK เวอร์ชัน 3.9.0

เวอร์ชัน 3.8.2.0

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

สร้างขึ้นและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 25.3.0
  • Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
  • Verve HyBid SDK เวอร์ชัน 3.8.2

เวอร์ชัน 3.8.1.1

  • กรองการดูที่คลิกได้เพื่อแยกความแตกต่างระหว่างการคลิกข้อมูลเนื้อหากับการคลิกโฆษณาปกติสำหรับ VerveNativeAd

สร้างขึ้นและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 25.2.0
  • Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.0.1
  • Verve HyBid SDK เวอร์ชัน 3.8.1

เวอร์ชัน 3.8.1.0

  • เพิ่มพร็อพเพอร์ตี้เพื่อสร้างอะแดปเตอร์ที่มีทรัพยากร Dependency ของ GMA Next-Gen SDK
  • ยืนยันความเข้ากันได้กับ Verve HyBid SDK เวอร์ชัน 3.8.1

สร้างขึ้นและทดสอบกับ

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

เวอร์ชัน 3.7.1.1

  • นำการตรวจสอบขนาดแบนเนอร์ออกจาก Verve Adapter เพื่อแก้ไขความล้มเหลวในการรวบรวมสัญญาณ

สร้างขึ้นและทดสอบกับ

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

เวอร์ชัน 3.7.1.0

  • รุ่นแรก
  • ยืนยันความเข้ากันได้กับ Verve HyBid SDK เวอร์ชัน 3.7.1

สร้างขึ้นและทดสอบกับ

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