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

เลือกแพลตฟอร์ม: Android (เบต้า) Android iOS Unity Flutter

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

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

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

ข้อกำหนด

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

• [สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ Pangle Adapter 5.5.0.4.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)

• ล่าสุดGMA Next-Gen SDK

• ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

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

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

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

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

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

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

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

อัปเดต 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

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่ม Pangle ในส่วนบริษัท

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

กำหนดค่าการเสนอราคาของ Pangle

กำหนดค่าการแมปหน่วยโฆษณา

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

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

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

การผสานรวมกับ Android Studio (แนะนำ)

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

ในไฟล์ Gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการติดตั้งใช้งานต่อไปนี้

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:pangle:7.9.1.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:pangle:7.9.1.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

การผสานรวมด้วยตนเอง

1. ดาวน์โหลด Pangle SDK เวอร์ชันล่าสุดสำหรับ Android แล้วแตกไฟล์ open_ad_sdk.aar จากโฟลเดอร์เก็บถาวรที่ดาวน์โหลดมา แล้วเพิ่มลงในโปรเจ็กต์

2. ไปที่ อาร์ติแฟกต์อะแดปเตอร์ Pangle ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอะแดปเตอร์ Pangle แล้วเพิ่มลงในโปรเจ็กต์

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

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

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

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

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

อะแดปเตอร์ Pangle มีเมธอด PangleMediationAdapter.setPAConsent() ที่ส่งต่อข้อมูลความยินยอมไปยังอะแดปเตอร์ Pangle แล้วจึงส่งต่อไปยัง Pangle SDK โค้ดตัวอย่างต่อไปนี้ แสดงวิธีส่งข้อมูลความยินยอมไปยัง Pangle SDK ตั้งค่าข้อมูลความยินยอมก่อนที่คุณ จะเริ่มต้น GMA Next-Gen SDK เพื่อให้มั่นใจว่าข้อมูลจะถูกส่งต่ออย่างถูกต้องไปยัง Pangle SDK

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

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

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

การปรับให้ยากต่อการอ่านของ ProGuard

หากคุณใช้ ProGuard เพื่อปรับโค้ด Android ให้ยากต่อการอ่าน ให้ทำตามวิธีการใน เอกสารประกอบของ Pangle เพื่อให้มั่นใจว่าโค้ด Pangle SDK จะไม่ถูกปรับให้ยากต่อการอ่าน

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

¹ อะแดปเตอร์ Pangle ไม่ได้ ให้สิทธิ์เข้าถึงชิ้นงานรูปภาพหลักสำหรับโฆษณาเนทีฟโดยตรง แต่จะป้อนข้อมูลวิดีโอหรือรูปภาพลงใน MediaView แทน

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

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

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

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