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

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

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

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

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

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

• ตั้งค่าสื่อกลาง 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 (Legacy) เวอร์ชันที่เข้ากันไม่ได้อาจทำให้เกิดปัญหาในการสร้าง

การผสานรวมกับ Android Studio (แนะนำ)

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

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

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

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

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

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

เพื่อปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ 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 (Legacy)

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);
VerveMediationSnippets.java

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)
VerveMediationSnippets.kt

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

รหัสข้อผิดพลาด	เหตุผล
100 ถึง 103	Verve HyBid SDK แสดงข้อผิดพลาด
101	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Verve HyBid SDK รองรับ
102	ไม่มี AppToken หรือ AppToken ว่างเปล่า
103	บริบทเป็น Null

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

เวอร์ชัน 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 เพื่อแก้ไขข้อผิดพลาดในการเก็บรวบรวมสัญญาณ

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

• 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