คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก PubMatic โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม PubMatic ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม PubMatic และอแดปเตอร์เข้ากับแอป Android
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อแดปเตอร์สื่อกลางสำหรับ PubMatic มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | |
| น้ำตก | |
| รูปแบบ | |
| โฆษณาเปิดแอป | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
ข้อกำหนด
- API ระดับ 23 ขึ้นไป ของ Android
Google Mobile Ads SDK เวอร์ชันล่าสุด
ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์
ขั้นตอนที่ 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 สำหรับ Ad Manager
ก่อนที่จะสรุปแอป คุณจะเห็นรายการที่เหมาะสมเพื่อ
เพิ่มลงใน app-ads.txt
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีติดตั้งใช้งาน app-ads.txt สำหรับ PubMatic ได้ที่วิธีติดตั้งใช้งาน app-ads.txt
รหัสโปรไฟล์
เมื่อสร้างแอปแล้ว ให้ไปที่แท็บแอปและจดรหัสโปรไฟล์ของแอปพลิเคชันที่สร้างขึ้นใหม่
สร้างหน่วยโฆษณา
ในแท็บหน่วยโฆษณา ให้เลือกแอปที่คุณสร้างไว้ในส่วนก่อนหน้า แล้วคลิกปุ่มสร้างหน่วยโฆษณา
กรอกรายละเอียดหน่วยโฆษณาในแบบฟอร์ม แล้วคลิกบันทึก
จดบันทึกรหัสหน่วยโฆษณา OpenWrap ที่สร้างขึ้นใหม่
รับรหัสผู้เผยแพร่โฆษณา
ไปที่แดชบอร์ดข้อมูลวิเคราะห์ วางเมาส์เหนือไอคอนโปรไฟล์และจดรหัสของคุณ
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ PubMatic ใน UI ของ Ad Manager
ลงชื่อเข้าใช้บัญชี Ad Manager
เปิดใช้การแชร์สัญญาณที่ปลอดภัย
ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก
แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ
ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ค้นหา PubMatic แล้วเปิดเปิดใช้การผสานรวมแอป
คลิกบันทึก
อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK
ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่า เริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK
คลิกบันทึก
กำหนดค่าการเสนอราคาของ PubMatic
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK
คลิกผู้เสนอราคารายใหม่
เลือก PubMatic เป็นผู้เสนอราคา
คลิกดำเนินการต่อเพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้
คลิกเสร็จสิ้น
กำหนดค่าการแมปหน่วยโฆษณา
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK
เลือกบริษัทสำหรับ PubMatic OpenWrap SDK
ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่
เลือกหน่วยโฆษณาที่เฉพาะเจาะจง เลือกหน่วยโฆษณาและรูปแบบ แอปบนอุปกรณ์เคลื่อนที่เป็น ประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อนรหัสหน่วยโฆษณา OpenWrap ที่ได้รับ ในส่วนก่อนหน้า
หากกําลังกำหนดค่าการแมปหน่วยโฆษณาสำหรับโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัลภายใน UI ของ Ad Manager ให้เลือกรูปแบบมีการให้รางวัลและใช้รหัสตำแหน่งโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
สุดท้าย ให้คลิกบันทึก
เพิ่ม PubMatic ลงในรายการพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม PubMatic ลงใน รายชื่อพาร์ทเนอร์โฆษณาที่ปฏิบัติตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ของ PubMatic
การผสานรวม Android Studio (แนะนํา)
ในไฟล์ settings.gradle.kts ระดับโปรเจ็กต์ ให้เพิ่มที่เก็บต่อไปนี้
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
}
จากนั้นในไฟล์ build.gradle.kts ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการใช้งานต่อไปนี้
ใช้ SDK และอะแดปเตอร์ของ PubMatic เวอร์ชันล่าสุด
dependencies {
implementation("com.google.android.gms:play-services-ads:24.7.0")
implementation("com.google.ads.mediation:pubmatic:4.9.1.0")
}
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน PubMatic SDK
เพื่อปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอรับความยินยอมจากผู้ใช้สำหรับการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมายกำหนด และสำหรับการเก็บรวบรวม การแชร์ และการใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน ห่วงโซ่สื่อกลาง
PubMatic จะอ่านความยินยอมตาม GDPR ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรองรับข้อกําหนดความยินยอมเพิ่มเติมของ Google รวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ที่ ส่งความยินยอมตาม GDPR และ GDPR
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ์ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัด สำหรับการแสดงโฆษณา Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางของคุณ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจเข้าร่วมในการขายข้อมูลส่วนตัว และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้ เป็นไปตามข้อกำหนด
PubMatic จะอ่านความยินยอม GPP ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรองรับข้อกำหนดความยินยอมเพิ่มเติมของ Google รวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ที่ ส่งต่อความยินยอมของ GPP
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม PubMatic
ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก PubMatic OpenWrap SDK ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา PubMatic (การเสนอราคา)
ขั้นตอนที่ไม่บังคับ
โฆษณาเนทีฟ
การแสดงโฆษณา
อแดปเตอร์ PubMatic จะแสดงโฆษณาเนทีฟเป็น
NativeAd
ออบเจ็กต์ โดยจะป้อนข้อมูลต่อไปนี้
ฟิลด์
สำหรับ
NativeAd
| ช่อง | ชิ้นงานที่อะแดปเตอร์ PubMatic รวมไว้เสมอ |
|---|---|
| บรรทัดแรก | |
| รูปภาพ | |
| เนื้อความ | |
| Icon | |
| คำกระตุ้นการตัดสินใจ | |
| การให้ดาว | |
| ร้านค้า | |
| ราคา | |
| ผู้ลงโฆษณา |
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก PubMatic คุณสามารถตรวจสอบ
ข้อผิดพลาดพื้นฐานจากการตอบกลับของโฆษณาได้โดยใช้
ResponseInfo.getAdapterResponses()
ภายใต้คลาสต่อไปนี้
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกันซึ่งอแดปเตอร์ PubMatic แสดงเมื่อโหลดโฆษณาไม่สำเร็จ
| รหัสข้อผิดพลาด | โดเมน | เหตุผล |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | การกำหนดค่าเซิร์ฟเวอร์ไม่มีรหัสผู้เผยแพร่โฆษณาที่จำเป็น |
| 102 | com.google.ads.mediation.pubmatic | การกำหนดค่าโฆษณาไม่ถูกต้องสำหรับการโหลดโฆษณา |
| 103 | com.google.ads.mediation.pubmatic | แสดงโฆษณาไม่สำเร็จเนื่องจากโฆษณายังไม่พร้อม |
| 1001-5002 | ส่งโดย SDK ของ PubMatic | SDK ของ PubMatic แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ PubMatic |
บันทึกการเปลี่ยนแปลงของ PubMatic Android Mediation Adapter
เวอร์ชัน 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
- เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าแบบสื่อกลางตามลำดับขั้น
- เพิ่มการรองรับโฆษณาที่มีการให้รางวัลแบบสื่อกลางตามลำดับขั้น
- เพิ่มการรองรับโฆษณาแบนเนอร์สื่อกลางตามลำดับขั้น
- เพิ่มการรองรับโฆษณาเนทีฟแบบสื่อกลางตามลำดับขั้น
- ยืนยันความเข้ากันได้กับ 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