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

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

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

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

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

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

ข้อกำหนด

  • 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 สำหรับแอป

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI ไว้ คุณจะติดตั้งปลั๊กอินสื่อกลางโฆษณา Google Mobile Ads ironSource สำหรับ 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 ไม่สามารถส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ

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

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

IronSource.SetConsent(true);

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

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

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

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

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

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

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

iOS

รหัสข้อผิดพลาด เหตุผล
101 พารามิเตอร์เซิร์ฟเวอร์โฆษณา ironSource ที่กำหนดค่าไว้ใน UI ของ AdMob ขาดหายไป/ไม่ถูกต้อง
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
  • รองรับอะแดปเตอร์ iOS ของ IronSource เวอร์ชัน 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
  • แก้ไขข้อขัดแย้งกับปลั๊กอินสื่อกลาง Unity ของ Chartboost

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