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

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

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

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

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

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

1 รูปแบบนี้รองรับเฉพาะในการผสานรวม Waterfall

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

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

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

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

    ลงชื่อสมัครใช้และลงชื่อเข้าใช้บัญชี ironSource Ads

    เพิ่มแอปใหม่

    หากต้องการเพิ่มแอปใหม่ ให้ไปที่โฆษณา > แอป แล้วคลิกเพิ่มแอป

    กรอกแบบฟอร์ม แล้วคลิกเพิ่มแอป

    จดบันทึกคีย์แอป แล้วเลือกรูปแบบโฆษณาที่แอปรองรับ แล้วคลิกต่อไป

    Android

    iOS

    สร้างอินสแตนซ์

    จากนั้นกำหนดค่าอินสแตนซ์สำหรับแอปที่คุณเพิ่ม

    ไปที่โฆษณา > การตั้งค่า > อินสแตนซ์ เลือกแอปแล้วคลิกสร้างอินสแตนซ์

    การเสนอราคา

    กรอกแบบฟอร์มแล้วเลือกการเสนอราคาสำหรับการกำหนดราคา คลิกบันทึกและปิด

    Android

    iOS

    จดบันทึกรหัสอินสแตนซ์

    Android

    iOS

    น้ำตก

    กรอกแบบฟอร์ม แล้วคลิกบันทึกและปิด

    จดบันทึกรหัสอินสแตนซ์

    ค้นหาคีย์ Reporting API

    การเสนอราคา

    ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา

    น้ำตก

    คลิกแท็บ API ในหน้าบัญชีของฉัน แล้วจดบันทึกคีย์ลับและโทเค็นการรีเฟรช

    อัปเดต app-ads.txt

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

    หากต้องการใช้ app-ads.txt สำหรับ ironSource โปรดดูตัวแทนจำหน่ายที่ได้รับอนุญาตของ ironSource

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

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

    ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณา ironSource ใน UI ของ Ad Manager

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

    Android

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

    iOS

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

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

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

    ขั้นตอนที่ 3: นำเข้า SDK โฆษณาและอะแดปเตอร์ ironSource Ads

    OpenUPM-CLI

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

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

    OpenUPM

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

    ในแท็บ 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 IronSource Mediation แล้วคลิกติดตั้ง

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

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

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

    นำเข้าจาก Unity

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

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

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

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

    อะแดปเตอร์ Unity ของ ironSource Ads เวอร์ชัน 2.6.0 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จาก UMP SDK และแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับข้อกำหนดความยินยอมเพิ่มเติมของ Google

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

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

    ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ ironSource Ads เวอร์ชัน 2.2.4 มีเมธอด IronSource.SetMetaData() โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง ironSource SDK โฆษณา คุณต้องตั้งค่าตัวเลือกเหล่านี้ก่อนที่จะเริ่มต้น Google Mobile Ads Unity Plugin เพื่อให้แน่ใจว่าตัวเลือกเหล่านี้จะส่งต่อไปยัง ironSource Ads SDK อย่างถูกต้อง

    using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

    ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในเมธอดได้ที่เอกสารประกอบของ ironSource Ads เกี่ยวกับการตั้งค่าขั้นสูงของกฎระเบียบสำหรับทั้ง Android และ iOS

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

    Android

    กฎ Proguard

    หากคุณลดขนาด ปรับให้ยากต่อการอ่าน (Obfuscate) และเพิ่มประสิทธิภาพแอป ironSource Ads จะต้องใช้กฎ ProGuard เพิ่มเติมสำหรับโปรเจ็กต์ของคุณ

    เมื่อสร้างโปรเจ็กต์ ให้เลือก Android เป็นแพลตฟอร์ม จากนั้นเปิดการตั้งค่าโปรแกรมเล่น แล้วเลือกไฟล์ Proguard ของผู้ใช้ในแท็บการตั้งค่าการเผยแพร่ Unity ควรแสดงตำแหน่งที่สร้างไฟล์ proguard-user.txt ที่กำหนดเองเพื่อให้คุณแก้ไข

    ไฟล์ Proguard ของผู้ใช้ Unity

    ดูข้อมูลเพิ่มเติมเกี่ยวกับกฎ ProGuard ที่จำเป็นสำหรับโปรเจ็กต์ของคุณได้ที่คู่มือการผสานรวม Android SDK ของ ironSource Ads และเพิ่มกฎเหล่านั้นลงในไฟล์ proguard-user.txt

    iOS

    การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

    Android

    com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

    iOS

    GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

    Android

    รหัสข้อผิดพลาด เหตุผล
    101 พารามิเตอร์เซิร์ฟเวอร์ ironSource Ads ที่กำหนดค่าใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
    102 ironSource Ads ต้องใช้บริบทกิจกรรมเพื่อเริ่มต้น SDK
    103 ironSource Ads โหลดโฆษณาได้เพียง 1 รายการต่อรหัสอินสแตนซ์ ironSource
    105 ironSource Ads ไม่รองรับขนาดโฆษณาแบนเนอร์ที่ขอ
    106 ไม่ได้เริ่มต้น ironSource SDK โฆษณา
    107 มีการส่งคำขอแสดงโฆษณาก่อนที่โฆษณาจะโหลดสำเร็จ
    108 SDK โฆษณาของ ironSource แสดงสัญญาณการเสนอราคาเป็นค่าว่างหรือไม่มีค่า
    501-1056 ข้อผิดพลาดของ SDK โฆษณา ironSource ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบ

    iOS

    รหัสข้อผิดพลาด เหตุผล
    101 พารามิเตอร์เซิร์ฟเวอร์ ironSource Ads ที่กำหนดค่าใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
    102 อะแดปเตอร์ ironSource Ads ไม่รองรับรูปแบบโฆษณาที่ขอ
    103 โหลดโฆษณา ironSource สำหรับการกำหนดค่าเครือข่ายนี้แล้ว
    104 ironSource Ads ไม่รองรับขนาดโฆษณาแบนเนอร์ที่ขอ
    105 ironSource Ads แสดงโฆษณาไม่สำเร็จ
    508-1037 ข้อผิดพลาดของ SDK โฆษณา ironSource ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบ

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

    เวอร์ชัน 4.8.1 (อยู่ระหว่างดำเนินการ)

    เวอร์ชัน 4.8.0

    เวอร์ชัน 4.7.0

    เวอร์ชัน 4.6.0

    เวอร์ชัน 4.5.3

    เวอร์ชัน 4.5.2

    เวอร์ชัน 4.5.1

    เวอร์ชัน 4.5.0

    เวอร์ชัน 4.4.1

    เวอร์ชัน 4.4.0

    เวอร์ชัน 4.3.0

    เวอร์ชัน 4.2.0

    เวอร์ชัน 4.1.0

    เวอร์ชัน 4.0.0

    เวอร์ชัน 3.11.1

    เวอร์ชัน 3.11.0

    เวอร์ชัน 3.10.0

    เวอร์ชัน 3.9.1

    เวอร์ชัน 3.9.0

    เวอร์ชัน 3.8.1

    เวอร์ชัน 3.8.0

    เวอร์ชัน 3.7.0

    เวอร์ชัน 3.6.1

    เวอร์ชัน 3.6.0

    เวอร์ชัน 3.5.2

    เวอร์ชัน 3.5.1

    เวอร์ชัน 3.5.0

    เวอร์ชัน 3.4.0

    เวอร์ชัน 3.3.1

    เวอร์ชัน 3.3.0

    เวอร์ชัน 3.2.1

    เวอร์ชัน 3.2.0

    เวอร์ชัน 3.1.1

    เวอร์ชัน 3.1.0

    เวอร์ชัน 3.0.1

    เวอร์ชัน 3.0.0

    เวอร์ชัน 2.6.1

    เวอร์ชัน 2.6.0

    เวอร์ชัน 2.5.0

    เวอร์ชัน 2.4.0

    เวอร์ชัน 2.3.1

    เวอร์ชัน 2.3.0

    เวอร์ชัน 2.2.7

    เวอร์ชัน 2.2.6

    เวอร์ชัน 2.2.5

    เวอร์ชัน 2.2.4

    เวอร์ชัน 2.2.3

    เวอร์ชัน 2.2.2

    เวอร์ชัน 2.2.1

    เวอร์ชัน 2.2.0

    เวอร์ชัน 2.1.5

    เวอร์ชัน 2.1.4

    เวอร์ชัน 2.1.3

    เวอร์ชัน 2.1.2

    เวอร์ชัน 2.1.1

    เวอร์ชัน 2.1.0

    เวอร์ชัน 2.0.3

    เวอร์ชัน 2.0.2

    เวอร์ชัน 2.0.1

    เวอร์ชัน 2.0.0

    เวอร์ชัน 1.10.0

    เวอร์ชัน 1.9.1

    เวอร์ชัน 1.9.0

    เวอร์ชัน 1.8.2

    เวอร์ชัน 1.8.1

    เวอร์ชัน 1.8.0

    เวอร์ชัน 1.7.0

    เวอร์ชัน 1.6.0

    เวอร์ชัน 1.5.0

    เวอร์ชัน 1.4.0

    เวอร์ชัน 1.3.2

    เวอร์ชัน 1.3.1

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.10.0.0
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.8.6.0

    เวอร์ชัน 1.3.0

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.10.0.0
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.8.4.1.0

    เวอร์ชัน 1.2.0

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.9.0.1
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.8.4.1.0

    เวอร์ชัน 1.1.2

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.8.4.1
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.8.4.1

    เวอร์ชัน 1.1.1

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.8.4.1
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.8.3.0

    เวอร์ชัน 1.1.0

    • อัปเดตปลั๊กอินเพื่อรองรับ Rewarded API เวอร์ชันเบต้าแบบเปิดใหม่
    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.8.1.2
    • รองรับอะแดปเตอร์ IronSource เวอร์ชัน 6.8.0.1 สำหรับ iOS

    เวอร์ชัน 1.0.4

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.7.11.0
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.7.11.0

    เวอร์ชัน 1.0.3

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.7.10.0
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.7.10.0

    เวอร์ชัน 1.0.2

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.7.9.1.1
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.7.10.0
    • แก้ไขข้อขัดแย้งกับปลั๊กอินสื่อกลาง Unity ของ Chartboost

    เวอร์ชัน 1.0.1

    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.7.9.0
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.7.9.2.0

    เวอร์ชัน 1.0.0

    • รุ่นแรก
    • รองรับอะแดปเตอร์ IronSource สำหรับ Android เวอร์ชัน 6.7.9.0
    • รองรับอะแดปเตอร์ IronSource iOS เวอร์ชัน 6.7.9.1.0