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

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

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

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

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

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

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

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

• เวอร์ชันล่าสุด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 Group ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

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

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

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

ในไฟล์ 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.5.0")
    implementation("com.google.ads.mediation:verve:3.9.3.0")
}

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

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

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

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

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

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

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

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

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

แทนที่ 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

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

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

เวอร์ชัน 3.9.3.0

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

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

• Google Mobile Ads SDK เวอร์ชัน 25.5.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.5.0
• Verve HyBid SDK เวอร์ชัน 3.9.3

เวอร์ชัน 3.9.2.0

• ตรึงทรัพยากร Dependency ของ 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 เพื่อแก้ไขข้อผิดพลาดในการรวบรวมสัญญาณ

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

• 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