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

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

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

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

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

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

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

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

• เวอร์ชัน GMA Next-Gen SDK ล่าสุด

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

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

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

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

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

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

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

อัปเดต app-ads.txt

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

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

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

รหัสโปรไฟล์

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

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

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

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

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

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

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

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

กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

คุณต้องเพิ่ม PubMatic OpenWrap SDK ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

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

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่แล้วอย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่ม PubMatic OpenWrap SDK เป็นแหล่งที่มาของโฆษณา

การเสนอราคา

ในส่วนแหล่งที่มาของโฆษณา ให้ค้นหาการ์ดการเสนอราคา แล้วเลือกเพิ่ม แหล่งที่มาของโฆษณา จากนั้นเลือก PubMatic OpenWrap SDK

คลิกรับทราบและยอมรับ แล้วคลิกบันทึก



หากมีการแมปสำหรับ PubMatic OpenWrap SDK อยู่แล้ว คุณก็เลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป



จากนั้น ป้อน รหัสหน่วยโฆษณา OpenWrap ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

น้ำตก

ในการ์ดสื่อกลางตามลำดับขั้นในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

เลือก PubMatic OpenWrap SDK จากนั้นป้อนค่า eCPM สำหรับ PubMatic OpenWrap SDK แล้วคลิกต่อไป




หากมีการแมปสำหรับ PubMatic OpenWrap SDK อยู่แล้ว คุณก็เลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป



จากนั้น ป้อน รหัสหน่วยโฆษณา OpenWrap ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.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: ใช้การตั้งค่าความเป็นส่วนตัวใน PubMatic

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

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

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

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

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

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

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

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

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

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

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

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

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

เวอร์ชัน 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

• ปักหมุดการอ้างอิง 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

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

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

• 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
• ยืนยันความเข้ากันได้กับ 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