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

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

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

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

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

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

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

ข้อกำหนด

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

ขั้นตอนที่ 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 Ads เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน 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 Regulation Advanced Settings

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

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

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

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

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

ดูรายละเอียดเพิ่มเติมและค่าที่ระบุในเมธอดได้ในเอกสารประกอบของโฆษณา ironSource Ads เกี่ยวกับการตั้งค่ากฎระเบียบขั้นสูงของทั้ง 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 Ads แสดงเมื่อโฆษณาโหลดไม่สำเร็จ

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.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