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

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

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

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

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

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

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

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

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

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

ขั้นตอนที่ 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 อยู่แล้ว ก็เลือกได้เลย หรือคลิกเพิ่มการแมป



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

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

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

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

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

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

เพื่อให้เป็นไปตามนโยบายความยินยอมของผู้ใช้ 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 ด้วยตนเอง เราขอแนะนำให้เรียกใช้ตัวอย่างก่อนที่จะขอโฆษณาผ่าน GMA Next-Gen SDK

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.getAdSourceResponses() ในคลาสต่อไปนี้

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

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

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

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง 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