ผสานรวม PubMatic OpenWrap (เบต้า) กับสื่อกลาง

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

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

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

¹ การผสานรวม Waterfall อยู่ในเวอร์ชันอัลฟ่า

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

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

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

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

• ตั้งค่าสื่อกลาง

ขั้นตอนที่ 1: ตั้งค่าใน UI ของ PubMatic

ลงชื่อสมัครใช้หรือ เข้าสู่ระบบบัญชี PubMatic แล้ว เลือกการ์ด OpenWrap SDK

เพิ่มแอปพลิเคชันใหม่

ไปที่แท็บแอป แล้วคลิกปุ่มเพิ่มแอป

เลือกแพลตฟอร์ม รวมถึง URL ของ App Store และชื่อแอปสำหรับแอปของคุณ

ในส่วนเส้นทางการผสานรวม ให้เลือก Android (Java / Kotlin) และเลือกการเสนอราคา SDK ของ AdMob เป็นเส้นทางการผสานรวมย่อย จากนั้นคลิกปุ่มเพิ่มแอป

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับ Ad Manager

ก่อนที่แอปจะเสร็จสมบูรณ์ คุณจะเห็นรายการที่เหมาะสมเพื่อ เพิ่มลงใน app-ads.txt

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ app-ads.txt สำหรับ PubMatic ได้ที่วิธีใช้ app-ads.txt

รหัสโปรไฟล์

เมื่อสร้างแอปแล้ว ให้ไปที่แท็บแอป และจดบันทึกรหัสโปรไฟล์ของแอปพลิเคชันที่สร้างขึ้นใหม่

สร้างหน่วยโฆษณา

ในแท็บหน่วยโฆษณา ให้เลือกแอปที่คุณสร้างไว้ในส่วนก่อนหน้า แล้วคลิกปุ่มสร้างหน่วยโฆษณา

กรอกรายละเอียดของหน่วยโฆษณาในแบบฟอร์ม แล้วคลิกบันทึก

จดบันทึกรหัสหน่วยโฆษณา OpenWrap ที่สร้างขึ้นใหม่

รับรหัสผู้เผยแพร่โฆษณา

ไปที่แดชบอร์ด Analytics วางเมาส์เหนือไอคอนโปรไฟล์และจดรหัสของคุณ

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ PubMatic ใน UI ของ Ad Manager

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่ม PubMatic OpenWrap SDK ในบริษัท

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

กำหนดค่าการเสนอราคา SDK ของ PubMatic OpenWrap

กำหนดค่าการแมปหน่วยโฆษณา

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

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

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

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

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
  }
}

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}

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

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

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

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

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

PubMatic จะอ่านความยินยอม GPP ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมที่รองรับข้อกำหนดความยินยอมเพิ่มเติมของ Google โดยอัตโนมัติ ซึ่งรวมถึง UMP SDK ด้วย ดูข้อมูลเพิ่มเติมได้ที่ส่งต่อความยินยอม GPP

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

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

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

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

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

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

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

ขั้นตอนที่ไม่บังคับ

โฆษณาเนทีฟ

การแสดงโฆษณา

อแดปเตอร์ PubMatic จะแสดงโฆษณาเนทีฟเป็นออบเจ็กต์ NativeAd โดยจะป้อนข้อมูลในช่องต่อไปนี้สำหรับ NativeAd

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

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

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

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

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

เวอร์ชัน 5.4.1.0

• อัปเดตระดับ API ขั้นต่ำของ Android ที่จำเป็นเป็น 24
• ยืนยันความเข้ากันได้กับ Pubmatic SDK 5.4.1 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 25.5.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.5.0
• Pubmatic SDK เวอร์ชัน 5.4.1

เวอร์ชัน 5.4.0.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 5.4.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• Pubmatic SDK เวอร์ชัน 5.4.0

เวอร์ชัน 5.3.0.1

• ปักหมุดทรัพยากร Dependency ของ Kotlin ของอะแดปเตอร์เป็น 1.9.0 (เวอร์ชัน Kotlin ขั้นต่ำที่ GMA NextGen SDK รองรับ)

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

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• Pubmatic SDK เวอร์ชัน 5.3.0

เวอร์ชัน 5.3.0.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 5.3.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• Pubmatic SDK เวอร์ชัน 5.3.0

เวอร์ชัน 5.2.0.0

• ได้รับการยืนยันว่าเข้ากันได้กับ Pubmatic SDK 5.2.0

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

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.3.0
• Pubmatic SDK เวอร์ชัน 5.2.0

เวอร์ชัน 5.1.2.2

• แมป AgeRestrictedTreatment กับ COPPA API ของ PubMatic

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

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
• Pubmatic SDK เวอร์ชัน 5.1.2

เวอร์ชัน 5.1.2.1

• เพิ่มการรองรับวิดีโอโฆษณาเนทีฟ(VAST) โดยใช้ PubMatic OpenWrapSDK MediaView API

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

• Google Mobile Ads SDK เวอร์ชัน 25.2.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
• Pubmatic SDK เวอร์ชัน 5.1.2

เวอร์ชัน 5.1.2.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ Pubmatic SDK 5.1.2 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 25.2.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.1.0
• Pubmatic SDK เวอร์ชัน 5.1.2

เวอร์ชัน 5.1.1.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 5.1.1 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 25.2.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.0.1
• Pubmatic SDK เวอร์ชัน 5.1.1

เวอร์ชัน 5.1.0.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 5.1.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 25.2.0
• Pubmatic SDK เวอร์ชัน 5.1.0

เวอร์ชัน 5.0.0.1

• เพิ่มพร็อพเพอร์ตี้เพื่อสร้างอะแดปเตอร์ที่มีทรัพยากร Dependency ของ GMA Next-Gen SDK
• แก้ไขข้อบกพร่องในเรื่องที่ไม่ได้เริ่มต้นออบเจ็กต์ mediationUtils

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

• Google Mobile Ads SDK เวอร์ชัน 25.1.0
• Pubmatic SDK เวอร์ชัน 5.0.0

เวอร์ชัน 5.0.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ Pubmatic SDK 5.0.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 25.0.0
• Pubmatic SDK เวอร์ชัน 5.0.0

เวอร์ชัน 4.12.0.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 4.12.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• Pubmatic SDK เวอร์ชัน 4.12.0

เวอร์ชัน 4.11.0.1

• เพิ่มการรองรับการส่งต่อพารามิเตอร์ tagForUnderAgeOfConsent ของ Google Mobile Ads SDK ไปยัง PubMatic SDK

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

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• Pubmatic SDK เวอร์ชัน 4.11.0

เวอร์ชัน 4.11.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ Pubmatic SDK 4.11.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• Pubmatic SDK เวอร์ชัน 4.11.0

เวอร์ชัน 4.10.0.1

• เพิ่มรายการชิ้นงานสำหรับรูปแบบโฆษณาเนทีฟ Waterfall

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

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• Pubmatic SDK เวอร์ชัน 4.10.0

เวอร์ชัน 4.10.0.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 4.10.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• Pubmatic SDK เวอร์ชัน 4.10.0

เวอร์ชัน 4.9.1.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 4.9.1 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 24.6.0
• Pubmatic SDK เวอร์ชัน 4.9.1

เวอร์ชัน 4.8.0.1

• เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าแบบ Waterfall
• เพิ่มการรองรับโฆษณาที่มีการให้รางวัลแบบ Waterfall
• เพิ่มการรองรับโฆษณาแบนเนอร์ Waterfall
• เพิ่มการรองรับโฆษณาเนทีฟแบบ Waterfall
• ยืนยันความเข้ากันได้กับ Pubmatic SDK 4.8.0

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

• Google Mobile Ads SDK เวอร์ชัน 24.6.0
• Pubmatic SDK เวอร์ชัน 4.8.0

เวอร์ชัน 4.8.0.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 4.8.0

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

• Google Mobile Ads SDK เวอร์ชัน 24.4.0
• Pubmatic SDK เวอร์ชัน 4.8.0

เวอร์ชัน 4.7.1.1

• ขนาดคงที่ของไอคอนตัวเลือกโฆษณาอื่นๆ

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

• Google Mobile Ads SDK เวอร์ชัน 24.4.0
• Pubmatic SDK เวอร์ชัน 4.7.1

เวอร์ชัน 4.7.1.0

• ยืนยันความเข้ากันได้กับ Pubmatic SDK 4.7.1 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 24.4.0
• Pubmatic SDK เวอร์ชัน 4.7.1

เวอร์ชัน 4.7.0.1

• แก้ไขทรัพยากร Dependency ภายใน

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

• Google Mobile Ads SDK เวอร์ชัน 24.4.0
• Pubmatic SDK เวอร์ชัน 4.7.0

เวอร์ชัน 4.7.0.0

• การเผยแพร่ครั้งแรก
• เพิ่มการรองรับการเสนอราคาสําหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และรูปแบบโฆษณาเนทีฟ
• ยืนยันความเข้ากันได้กับ Pubmatic SDK 4.7.0 แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 24.4.0
• Pubmatic SDK เวอร์ชัน 4.7.0