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

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

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

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

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

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

1 แหล่งที่มาของโฆษณาซึ่งใช้การเสนอราคาของ Pangle ที่พร้อมให้บริการ ได้แก่ Pangle US, Pangle KR และ Pangle ROW

2 รูปแบบนี้ไม่รองรับแหล่งที่มาของโฆษณาที่ใช้การเสนอราคาของ Pangle ต่อไปนี้: Pangle US

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

  • Google Mobile Ads Unity Plugin เวอร์ชันล่าสุด
  • [สำหรับการเสนอราคาของ Pangle ในสหรัฐอเมริกา]: ใช้อะแดปเตอร์ Pangle เวอร์ชัน 5.1.0 ขึ้นไป
  • Unity Editor เวอร์ชัน 5.6 ขึ้นไป
  • [สำหรับการเสนอราคาของ Pangle KR และการเสนอราคาของ Pangle ROW]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Pangle 2.4.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)
  • หากต้องการติดตั้งใช้งานใน Android
    • Android API ระดับ 24 ขึ้นไป
  • วิธีติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่หัวข้อตั้งค่า Google Mobile Ads Unity Plugin
  • ตั้งค่าสื่อกลาง

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

    ลงชื่อสมัครใช้หรือ เข้าสู่ระบบบัญชี Pangle

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

    ไปที่แท็บ Applications แล้วคลิกปุ่ม Add App

    เลือกระบบปฏิบัติการที่ต้องการสร้างแอปพลิเคชัน แล้วกรอก ข้อมูลที่เหลือในแบบฟอร์ม จากนั้นคลิกส่ง

    Android

    iOS

    จดบันทึกรหัสแอปของแอปพลิเคชัน

    Android

    iOS

    สร้างตำแหน่งโฆษณา

    เมื่อสร้างแอปพลิเคชันแล้ว ให้คลิกปุ่มเพิ่มเพื่อสร้าง ตําแหน่งโฆษณา

    Android

    iOS

    การเสนอราคา

    เลือกรูปแบบโฆษณาและชื่อตำแหน่งโฆษณา แล้วเลือกการเสนอราคาในแอปเป็นประเภทการกำหนดราคา กรอกข้อมูลในแบบฟอร์มส่วนที่เหลือและ คลิกส่ง

    เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดบันทึกรหัสตำแหน่งโฆษณาไว้

    Android

    iOS

    น้ำตก

    เลือกรูปแบบโฆษณาและชื่อตำแหน่งโฆษณา และเลือก CPM ทั่วโลกเป็นประเภทการกำหนดราคา กรอกข้อมูลที่เหลือในแบบฟอร์ม แล้วคลิกส่ง

    เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดบันทึกรหัสตำแหน่งโฆษณาไว้

    Android

    iOS

    อัปเดต app-ads.txt

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

    หากต้องการใช้ app-ads.txt สำหรับ Pangle โปรดดูวิธีเพิ่ม Pangle ลงในไฟล์ app-ads.txt

    เปิดโหมดทดสอบ

    ทำตามวิธีการในคู่มือวิธีเพิ่มโฆษณาทดสอบของ Pangle เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ Pangle

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

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

    Android

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

    iOS

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

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

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

    ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ของ Pangle

    OpenUPM-CLI

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

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

    OpenUPM

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

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

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

    รายละเอียด OpenUPM

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

    Unity Registry

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

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Pangle เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsPangleMediation.unitypackage จากไฟล์ ZIP

    ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือก Assets > Import Package > Custom Package แล้วค้นหา GoogleMobileAdsPangleMediation.unitypackage ไฟล์ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนำเข้า

    นำเข้าจาก Unity

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

    บังคับแก้ไข

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

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

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

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

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

    โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Pangle SDK ตั้งค่าข้อมูลความยินยอมก่อนเริ่มต้น Google Mobile Ads Unity Plugin เพื่อให้มั่นใจว่าระบบจะส่งต่อข้อมูลไปยัง SDK ของ Pangle อย่างถูกต้อง

    using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

    ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในแต่ละวิธีได้ที่คู่มือการผสานรวมของ Pangle

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

    Android

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

    iOS

    การผสานรวม SKAdNetwork

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

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

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

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

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

    หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Pangle ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Pangle (การแสดงโฆษณาตามลำดับขั้น), Pangle US SDK (การเสนอราคา), Pangle KR SDK (การเสนอราคา) และ Pangle ROW SDK (การเสนอราคา)

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

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

    Android

    com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

    iOS

    GADMediationAdapterPangle

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

    Android

    รหัสข้อผิดพลาด โดเมน เหตุผล
    101 com.google.ads.mediation.pangle พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปหรือรหัสตำแหน่งโฆษณา)
    102 com.google.ads.mediation.pangle ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Pangle รองรับ
    103 com.google.ads.mediation.pangle SDK ของ Pangle ไม่รองรับผู้ใช้ที่เป็นเด็ก
    -1-60000 com.pangle.ads SDK ของ Pangle แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Pangle

    iOS

    รหัสข้อผิดพลาด โดเมน เหตุผล
    101 com.google.mediation.pangle พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปหรือรหัสตำแหน่งโฆษณา)
    102 com.google.mediation.pangle ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Pangle รองรับ
    104 com.google.mediation.pangle SDK ของ Pangle ไม่รองรับผู้ใช้ที่เป็นเด็ก
    -1-60000 ส่งโดย Pangle SDK Pangle SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Pangle

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

    เวอร์ชัน 7.2.2 (กำลังดำเนินการ)

    เวอร์ชัน 7.2.1

    เวอร์ชัน 7.2.0

    เวอร์ชัน 7.1.1

    เวอร์ชัน 7.1.0

    เวอร์ชัน 7.0.0 (ย้อนกลับ)

    เวอร์ชัน 6.0.1

    เวอร์ชัน 6.0.0

    เวอร์ชัน 5.9.2

    เวอร์ชัน 5.9.1

    เวอร์ชัน 5.9.0

    • เลิกใช้งานเมธอด SetGDPRConsent() จากคลาส Pangle ตอนนี้ Pangle SDK จัดการความยินยอมโดยอัตโนมัติแล้ว
      • ตอนนี้เมธอดนี้ไม่มีการดำเนินการใดๆ และจะถูกนำออกในรุ่นต่อๆ ไป
    • รองรับPangle Android Adapter เวอร์ชัน 7.9.1.1.0
    • รองรับอแดปเตอร์ Pangle iOS เวอร์ชัน 7.9.0.6.0
    • สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับ Google Mobile Ads เวอร์ชัน 11.0.0

    เวอร์ชัน 5.8.5

    เวอร์ชัน 5.8.4

    เวอร์ชัน 5.8.3

    เวอร์ชัน 5.8.2

    เวอร์ชัน 5.8.1

    เวอร์ชัน 5.8.0

    เวอร์ชัน 5.7.1

    เวอร์ชัน 5.7.0

    เวอร์ชัน 5.6.0

    เวอร์ชัน 5.5.3

    เวอร์ชัน 5.5.2

    เวอร์ชัน 5.5.1

    เวอร์ชัน 5.5.0

    เวอร์ชัน 5.4.0

    เวอร์ชัน 5.3.0

    เวอร์ชัน 5.2.2

    เวอร์ชัน 5.2.1

    เวอร์ชัน 5.2.0

    เวอร์ชัน 5.1.1

    เวอร์ชัน 5.1.0

    เวอร์ชัน 5.0.0

    เวอร์ชัน 4.6.2

    เวอร์ชัน 4.6.1

    เวอร์ชัน 4.6.0

    เวอร์ชัน 4.5.4

    เวอร์ชัน 4.5.3

    เวอร์ชัน 4.5.2

    เวอร์ชัน 4.5.1

    เวอร์ชัน 4.5.0

    เวอร์ชัน 4.4.2

    เวอร์ชัน 4.4.1

    เวอร์ชัน 4.4.0

    เวอร์ชัน 4.3.3

    เวอร์ชัน 4.3.2

    เวอร์ชัน 4.3.1

    เวอร์ชัน 4.3.0

    เวอร์ชัน 4.2.1

    เวอร์ชัน 4.2.0

    เวอร์ชัน 4.1.0

    เวอร์ชัน 4.0.1

    เวอร์ชัน 4.0.0

    เวอร์ชัน 3.0.0

    เวอร์ชัน 2.8.1

    เวอร์ชัน 2.8.0

    เวอร์ชัน 2.7.0

    เวอร์ชัน 2.6.0

    เวอร์ชัน 2.5.0

    เวอร์ชัน 2.4.0

    เวอร์ชัน 2.3.0

    เวอร์ชัน 2.2.0

    เวอร์ชัน 2.1.0

    เวอร์ชัน 2.0.0

    • ย้ายเนื้อหาของอะแดปเตอร์ไปยัง GoogleMobileAds/Mediation/Pangle/ แล้ว
    • เปลี่ยนโครงสร้างภายในเนมสเปซของอะแดปเตอร์เพื่อใช้ GoogleMobileAds.Mediation.Pangle
    • รองรับ Android Adapter ของ Pangle เวอร์ชัน 5.0.0.7.0
    • รองรับอแดปเตอร์ Pangle iOS เวอร์ชัน 5.0.0.6.0
    • สร้างและทดสอบด้วยปลั๊กอิน Unity สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.4.1

    เวอร์ชัน 1.5.1

    เวอร์ชัน 1.5.0

    เวอร์ชัน 1.4.0

    เวอร์ชัน 1.3.1

    เวอร์ชัน 1.3.0

    เวอร์ชัน 1.2.0

    เวอร์ชัน 1.1.0

    เวอร์ชัน 1.0.0