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

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

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

AdMob อะแดปเตอร์สื่อกลางสำหรับโฆษณา ironSource ความสามารถต่อไปนี้

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

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

2 รูปแบบนี้เท่านั้น ได้รับการรองรับในการผสานรวม Waterfall

ข้อกำหนด

  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
  • Unity 4 ขึ้นไป
  • เพื่อทำให้ใช้งานได้ใน Android
    • API ของ Android ระดับ 21 ขึ้นไป
  • เพื่อทำให้ใช้งานได้บน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ที่ Unity กำลังทำงานซึ่งกำหนดค่าด้วย Google SDK โฆษณาในอุปกรณ์เคลื่อนที่ โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
  • ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน

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

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

หากต้องการเพิ่มแอปพลิเคชันไปยังหน้าแดชบอร์ด ironSource Ads ให้คลิกปุ่มแอปใหม่

ป้อนรายละเอียดแอป

เลือกแอปที่เผยแพร่อยู่ ป้อน URL ของแอป แล้วคลิกนำเข้าข้อมูลแอป

หากแอปของคุณไม่พร้อมใช้งาน ให้เลือกแอปไม่ได้แสดงอยู่ใน Application Store และระบุชื่อชั่วคราวสําหรับแอปของคุณ แล้วเลือกแพลตฟอร์ม

กรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ แล้วคลิกเพิ่มแอป

จดคีย์แอปใหม่ ซึ่งจะแสดงหลังจากที่เพิ่มแอปแล้ว ซึ่งคุณจะต้องใช้ค่านี้เพื่อตั้งค่าAdMob รหัสหน่วยโฆษณา เลือกรูปแบบโฆษณาที่แอป รองรับ แล้วคลิกดำเนินการต่อ

Android

iOS

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

ถัดไป ให้กำหนดค่าอินสแตนซ์ของเครือข่ายสำหรับแอปที่คุณเพิ่ม

การเสนอราคา

ไปที่ LevelPlay > การตั้งค่า > เครือข่าย SDK แล้วเลือกแอปของคุณ ในส่วนการเสนอราคา ให้คลิกไอคอนแก้ไขเพื่อดูรหัสอินสแตนซ์การเสนอราคา

Android

iOS

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

Android

iOS

น้ำตก

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

ป้อนรายละเอียดที่จำเป็น แล้วคลิกบันทึกและปิด

เมื่อสร้างอินสแตนซ์แล้ว รหัสอินสแตนซ์จะแสดงอยู่ในช่องรหัสอินสแตนซ์

ค้นหาคีย์ API การรายงาน

การเสนอราคา

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

น้ำตก

นอกเหนือจากคีย์แอปและรหัสอินสแตนซ์แล้ว คุณยังต้องใช้คีย์ลับและโทเค็นการรีเฟรชของโฆษณา ironSource เพื่อตั้งค่าAdMob รหัสหน่วยโฆษณา

ไปที่บัญชีของฉันในหน้าแดชบอร์ดผู้เผยแพร่โฆษณาของ ironSource Ads แล้วคลิกแท็บ API จดบันทึก Secret Key และ การปรับปรุงโทเค็น

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

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

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

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

Android

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

iOS

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

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

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

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

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ ironSource โฆษณาจากลิงก์ดาวน์โหลดใน Changelog และดึงข้อมูล GoogleMobileAdsIronSourceMediation.unitypackage จากไฟล์ ZIP

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

จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play > รีโซลเวอร์ Android > แรง แก้ปัญหา ไลบรารีตัวแปลค่าบริการ Unity Play จะดำเนินการ Dependency แก้ไขตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยัง ไดเรกทอรี Assets/Plugins/Android ของแอป Unity

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

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

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

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

IronSource.SetConsent(true);

ดูเอกสารประกอบของ ironSource Ads ใน การตั้งค่าขั้นสูงสำหรับกฎระเบียบ เพื่อดูรายละเอียดเพิ่มเติม

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

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

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

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

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

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

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

Android

กฎ Proguard

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

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

ไฟล์ User Proguard ของ Unity

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

iOS

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของโฆษณา ironSource เพื่อเพิ่มตัวระบุ SKAdNetwork ลงใน Info.plist ของโครงการ

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

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

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน IronSource UI

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

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

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

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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

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

เวอร์ชัน 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

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

เวอร์ชัน 1.3.0

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

เวอร์ชัน 1.2.0

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

เวอร์ชัน 1.1.2

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

เวอร์ชัน 1.1.1

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

เวอร์ชัน 1.1.0

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

เวอร์ชัน 1.0.4

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

เวอร์ชัน 1.0.3

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

เวอร์ชัน 1.0.2

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

เวอร์ชัน 1.0.1

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

เวอร์ชัน 1.0.0

  • เปิดตัวครั้งแรก
  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.7.9.0
  • รองรับอะแดปเตอร์ iOS IronSource เวอร์ชัน 6.7.9.1.0