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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

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

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

Android

iOS

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

ถัดไป ให้กําหนดค่าอินสแตนซ์สําหรับแอปที่เพิ่ม

การเสนอราคา

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

จดรหัสอินสแตนซ์ไว้

Android

iOS

น้ำตก

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

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

จดรหัสอินสแตนซ์ไว้

ค้นหาคีย์ Reporting API

การเสนอราคา

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

น้ำตก

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

ในแท็บรีจิสทรีที่มีขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่มีขอบเขตพร้อมรายละเอียดต่อไปนี้

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

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิดเครื่องมือจัดการแพ็กเกจ Unity แล้วเลือกที่เก็บของฉันจากเมนูแบบเลื่อนลง

รีจิสทรีของ Unity

เลือกแพ็กเกจสื่อกลางโฆษณา Google Mobile Ads ของ ironSource แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสําหรับโฆษณา IronSource จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsIronSourceMediation.unitypackage จากไฟล์ ZIP

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

นำเข้าจาก Unity

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

บังคับแก้ไข

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

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

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

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

IronSource.SetConsent(true);

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

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

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

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

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

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

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

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

Android

กฎ Proguard

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

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

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

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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

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

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

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

เวอร์ชัน 1.3.0

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

เวอร์ชัน 1.2.0

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

เวอร์ชัน 1.1.2

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

เวอร์ชัน 1.1.1

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

เวอร์ชัน 1.1.0

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

เวอร์ชัน 1.0.4

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

เวอร์ชัน 1.0.3

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 6.7.10.0 ของ IronSource
  • รองรับอะแดปเตอร์ 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 ของ IronSource เวอร์ชัน 6.7.9.2.0

เวอร์ชัน 1.0.0

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