ผสานรวม PubMatic กับสื่อกลาง

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

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

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

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

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

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

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

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

  • Google Mobile Ads Unity Plugin เวอร์ชันล่าสุด
  • Unity Editor เวอร์ชัน 2019.4 ขึ้นไป
  • วิธีติดตั้งใช้งานใน Android
    • Android API ระดับ 24 ขึ้นไป
  • วิธีติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่หัวข้อตั้งค่า Google Mobile Ads Unity Plugin
  • ตั้งค่าสื่อกลาง

    • ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ PubMatic OpenWrap SDK

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

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

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

    แดชบอร์ดของแอป

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

    Android

    ในส่วนเส้นทางการผสานรวม ให้เลือก Unity แล้วเลือกการเสนอราคา SDK ของ AdMob เป็นเส้นทางการผสานรวมย่อย จากนั้นคลิกปุ่มเพิ่มแอป

    แบบฟอร์มแอปใหม่

    iOS

    ในส่วนเส้นทางการผสานรวม ให้เลือก Unity แล้วเลือกการเสนอราคา SDK ของ AdMob เป็นเส้นทางการผสานรวมย่อย จากนั้นคลิกปุ่มเพิ่มแอป

    แบบฟอร์มแอปใหม่

    อัปเดต app-ads.txt

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

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

    app-aps.txt

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

    รหัสโปรไฟล์

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

    รหัสโปรไฟล์แอป

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

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

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

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

    สร้างแบบฟอร์มหน่วยโฆษณา

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

    รหัสหน่วยโฆษณาในแอป

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

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

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

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

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

    Android

    ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android

    iOS

    ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

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

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

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

    OpenUPM-CLI

    หากติดตั้ง OpenUPM-CLI ไว้ คุณสามารถติดตั้งปลั๊กอินสื่อกลาง PubMatic OpenWrap SDK ของ Google Mobile Ads สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีรากของโปรเจ็กต์

    openupm add com.google.ads.mobile.mediation.pubmatic

    OpenUPM

    ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

    ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็น Scoped Registry โดยระบุรายละเอียดต่อไปนี้

    • ชื่อ: OpenUPM
    • URL: https://package.openupm.com
    • ขอบเขต: com.google

    รายละเอียด OpenUPM

    จากนั้นไปที่ Window > Package Manager เพื่อเปิด Unity Package Manager แล้วเลือกMy Registries จากเมนูแบบเลื่อนลง

    Unity Registry

    เลือกแพ็กเกจ Google Mobile Ads PubMatic Mediation แล้วคลิกติดตั้ง

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

    ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ SDK ของ PubMatic OpenWrap จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsPubMaticMediation.unitypackage จากไฟล์ ZIP

    ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกชิ้นงาน > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsPubMaticMediation.unitypackage ที่ดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนำเข้า

    นำเข้าจาก Unity

    จากนั้นเลือก Assets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ไขทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

    บังคับให้แก้ไข

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

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

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

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

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

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

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

    Android

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

    iOS

    การผสานรวม SKAdNetwork

    ทำตามเอกสารประกอบของ PubMatic OpenWrap SDK เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

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

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

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

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

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

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

    หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก PubMatic ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่สำคัญจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo ในคลาสต่อไปนี้

    Android

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

    iOS

    GADMediationAdapterPubMatic

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

    Android

    รหัสข้อผิดพลาด โดเมน เหตุผล
    101 com.google.ads.mediation.pubmatic การกำหนดค่าเซิร์ฟเวอร์ไม่มีรหัสผู้เผยแพร่โฆษณาที่จำเป็น
    102 com.google.ads.mediation.pubmatic PubMatic ไม่รองรับรูปแบบโฆษณาหรือไม่มีข้อมูลสัญญาณ RTB
    103 com.google.ads.mediation.pubmatic แสดงโฆษณาไม่สำเร็จเนื่องจากโฆษณาไม่พร้อม
    104 com.google.ads.mediation.pubmatic ไม่มีรหัสโปรไฟล์หรือรหัสโปรไฟล์ไม่ถูกต้อง
    105 com.google.ads.mediation.pubmatic ไม่มีรหัสหน่วยโฆษณาหรือรหัสหน่วยโฆษณาว่างเปล่า
    106 com.google.ads.mediation.pubmatic โฆษณาที่มีการให้รางวัลที่แสดงผลเป็นค่าว่าง
    107 com.google.ads.mediation.pubmatic ขนาดโฆษณาแบนเนอร์ไม่ถูกต้อง
    1001-5002 ส่งโดย PubMatic SDK PubMatic SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ PubMatic

    iOS

    รหัสข้อผิดพลาด โดเมน เหตุผล
    101 com.google.ads.mediation.pubmatic การกำหนดค่าเซิร์ฟเวอร์ไม่มีรหัสผู้เผยแพร่โฆษณาที่จำเป็น
    102 com.google.ads.mediation.pubmatic คำขอรวบรวมสัญญาณการเสนอราคาไม่สำเร็จเนื่องจากมีการระบุหลายรูปแบบ ไม่มีรูปแบบ หรือรูปแบบที่ไม่รองรับในพารามิเตอร์คำขอ
    103 com.google.ads.mediation.pubmatic การกำหนดค่าโฆษณาไม่ถูกต้องสำหรับการโหลดโฆษณา
    104 com.google.ads.mediation.pubmatic แสดงโฆษณาคั่นระหว่างหน้าไม่สำเร็จเนื่องจากโฆษณาไม่พร้อม
    105 com.google.ads.mediation.pubmatic แสดงโฆษณาที่มีการให้รางวัลไม่สำเร็จเนื่องจากโฆษณาไม่พร้อม
    106 com.google.ads.mediation.pubmatic โหลดแหล่งที่มาของรูปภาพโฆษณาเนทีฟรายการหนึ่งไม่สำเร็จ
    107 com.google.ads.mediation.pubmatic การกำหนดค่าโฆษณาไม่มีรหัสผู้เผยแพร่โฆษณา
    108 com.google.ads.mediation.pubmatic การกำหนดค่าโฆษณาไม่มีรหัสโปรไฟล์
    109 com.google.ads.mediation.pubmatic การกำหนดค่าโฆษณามีรหัสโปรไฟล์ที่ไม่ใช่ตัวเลข
    110 com.google.ads.mediation.pubmatic การกำหนดค่าโฆษณาไม่มีรหัสหน่วยโฆษณา
    111 com.google.ads.mediation.pubmatic PubMatic OpenWrap SDK ไม่สามารถสร้างอินสแตนซ์ขนาดโฆษณาได้
    1001-5002 ส่งโดย PubMatic SDK PubMatic SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ PubMatic

    บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง PubMatic Unity

    เวอร์ชัน 2.4.1

    เวอร์ชัน 2.4.0

    เวอร์ชัน 2.3.0

    เวอร์ชัน 2.2.0

    เวอร์ชัน 2.1.3

    เวอร์ชัน 2.1.2

    เวอร์ชัน 2.1.1

    เวอร์ชัน 2.1.0

    เวอร์ชัน 2.0.1

    เวอร์ชัน 2.0.0

    เวอร์ชัน 1.5.0

    เวอร์ชัน 1.4.1

    เวอร์ชัน 1.4.0

    เวอร์ชัน 1.3.1

    เวอร์ชัน 1.3.0

    เวอร์ชัน 1.2.0

    เวอร์ชัน 1.1.0

    เวอร์ชัน 1.0.0