หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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

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

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

² รูปแบบนี้รองรับเฉพาะในการผสานรวม 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 ให้คลิกปุ่มแอปใหม่

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

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

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

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

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

Android

iOS

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

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

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

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

ประเด็นสำคัญ: หากต้องการรองรับโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล ให้เลือกรูปแบบวิดีโอที่มีการให้รางวัล และใช้รหัสอินสแตนซ์นั้นเพื่อเพิ่มโฆษณา ironSource เป็นแหล่งที่มาของโฆษณาในขั้นตอนที่ 2 นอกจากนี้ คุณจะต้องติดต่อทีมสนับสนุนของ IronSource Ads ที่ Mobile-is-support@ironsrc.com เพื่อตั้งค่ารหัสอินสแตนซ์สำหรับการรองรับโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

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

ค้นหาคีย์ Reporting API

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

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

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

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

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

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

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 Ads Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก 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 และ GDPR

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

iOS

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