ผสานรวม PubMatic กับการเสนอราคา

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

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

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

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

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

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

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

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

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

ขั้นตอนที่ 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.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 ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง (Mediation Chain) ของคุณได้ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง (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.getAdSourceResponses() ในคลาสต่อไปนี้

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