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

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

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

Ad Manager Mediation Adapter สำหรับ ironSource Ads มีความสามารถต่อไปนี้

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

1 รูปแบบนี้รองรับเฉพาะการผสานรวมแบบลำดับขั้นเท่านั้น

ข้อกำหนด

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

ขั้นตอนที่ 1: ตั้งค่าใน UI ของโฆษณา ironSource

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

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

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

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

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

Android

iOS

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

จากนั้นกำหนดค่าอินสแตนซ์สำหรับแอปที่คุณเพิ่ม

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

การเสนอราคา

กรอกแบบฟอร์มแล้วเลือกการเสนอราคาสำหรับการกำหนดราคา คลิกบันทึกและ ปิด

Android

iOS

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

Android

iOS

น้ำตก

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

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

ค้นหาคีย์ API ของ Reporting

การเสนอราคา

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

น้ำตก

คลิกแท็บ API ใน หน้าบัญชีของฉัน และจดSecret Key และRefresh Token

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้ สร้างไฟล์ app-ads.txt สำหรับ Ad Manager

หากต้องการใช้ app-ads.txt สำหรับ ironSource โปรดดูตัวแทนจำหน่ายที่ได้รับอนุญาตของ ironSource

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

รายละเอียด OpenUPM

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

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

เลือกแพ็กเกจ การผสานรวม IronSource Mediation ของโฆษณา Google ในอุปกรณ์เคลื่อนที่ แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

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

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

นำเข้าจาก Unity

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

บังคับให้ปิด

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

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

ตั้งแต่เวอร์ชัน 2.6.0 ของปลั๊กอิน Unity ของอแดปเตอร์ ironSource เป็นต้นไป ironSource จะอ่านความยินยอมตาม GDPR ที่แพลตฟอร์มการจัดการความยินยอมตั้งค่าไว้โดยอัตโนมัติ ซึ่งรองรับข้อกำหนดความยินยอมเพิ่มเติมของ Google รวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ที่ การสนับสนุน UMP ของ Google และ CMP ที่รองรับความยินยอมเพิ่มเติมของ Google

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

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

ปลั๊กอินสื่อกลางโฆษณา Google บนอุปกรณ์เคลื่อนที่สำหรับโฆษณา 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 เกี่ยวกับการตั้งค่าขั้นสูงด้านกฎระเบียบสำหรับทั้ง Android และ iOS

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

Android

กฎ Proguard

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

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

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

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

iOS

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

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

เวอร์ชัน 3.10.0

เวอร์ชัน 3.9.1

เวอร์ชัน 3.9.0

เวอร์ชัน 3.8.1

เวอร์ชัน 3.8.0

เวอร์ชัน 3.7.0

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

  • รองรับ IronSource Android Adapter เวอร์ชัน 6.10.0.0
  • รองรับ IronSource iOS Adapter เวอร์ชัน 6.8.6.0

เวอร์ชัน 1.3.0

  • รองรับ IronSource Android Adapter เวอร์ชัน 6.10.0.0
  • รองรับ IronSource iOS Adapter เวอร์ชัน 6.8.4.1.0

เวอร์ชัน 1.2.0

  • รองรับ IronSource Android Adapter เวอร์ชัน 6.9.0.1
  • รองรับ IronSource iOS Adapter เวอร์ชัน 6.8.4.1.0

เวอร์ชัน 1.1.2

  • รองรับ IronSource Android Adapter เวอร์ชัน 6.8.4.1
  • รองรับ IronSource iOS Adapter เวอร์ชัน 6.8.4.1

เวอร์ชัน 1.1.1

  • รองรับ IronSource Android Adapter เวอร์ชัน 6.8.4.1
  • รองรับ IronSource iOS Adapter เวอร์ชัน 6.8.3.0

เวอร์ชัน 1.1.0

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

เวอร์ชัน 1.0.4

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

เวอร์ชัน 1.0.3

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

เวอร์ชัน 1.0.2

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

เวอร์ชัน 1.0.1

  • รองรับ IronSource Android Adapter เวอร์ชัน 6.7.9.0
  • รองรับ IronSource iOS Adapter เวอร์ชัน 6.7.9.2.0

เวอร์ชัน 1.0.0

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