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

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

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

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

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

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

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

ข้อกำหนด

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

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

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

หากต้องการเพิ่มแอปพลิเคชันลงในแดชบอร์ดโฆษณาของ ironSource ให้คลิกปุ่มแอปใหม่

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

เลือกแอปเวอร์ชันที่เผยแพร่ ป้อนชื่อแอป แล้วคลิกนําเข้าข้อมูลแอป

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

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

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

Android

iOS

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

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

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

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

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

ค้นหาคีย์ Reporting API

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

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

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

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

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

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

Android

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

iOS

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

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

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

ขั้นตอนที่ 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 เวอร์ชันล่าสุดสําหรับ AdironSource Ads จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsIronSourceMediation.unitypackage จากไฟล์ ZIP

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

นำเข้าจาก Unity

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

บังคับแก้ไข

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

ภายใต้นโยบายความยินยอมของผู้ใช้ 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: ทดสอบการใช้งาน

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

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

iOS

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

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

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

เวอร์ชัน 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
  • แก้ไขข้อขัดแย้งกับปลั๊กอินสื่อกลาง Unity ของ Chartboost

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