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

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

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

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

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

ข้อกำหนด

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
• Flutter 3.7.0 ขึ้นไป
• เพื่อทำให้ใช้งานได้ใน Android
  • Android API ระดับ 21 ขึ้นไป
• เพื่อทำให้ใช้งานได้ใน iOS
  • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
• โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดในเริ่มต้นใช้งาน
• ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน

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

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

หากต้องการเพิ่มแอปพลิเคชันไปยังแดชบอร์ด ironSource ให้คลิกปุ่มแอปใหม่

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

เลือกแอปที่เผยแพร่อยู่ ป้อน URL ของแอป แล้วคลิกนำเข้าข้อมูลแอป

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

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

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

Android

iOS

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

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

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

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

หมายเหตุ: IronSource จำกัดให้คุณสร้างรหัสอินสแตนซ์ได้ตามจำนวนสูงสุด หากได้รับข้อผิดพลาดที่ระบุว่าคุณไม่สามารถสร้างรหัสอินสแตนซ์เพิ่มได้ โปรดติดต่อทีมสนับสนุนของ IronSource เพื่อขอความช่วยเหลือ

ประเด็นสำคัญ: หากต้องการรองรับโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล ให้เลือกรูปแบบวิดีโอที่มีการให้รางวัล และใช้รหัสอินสแตนซ์ดังกล่าวเพื่อเพิ่ม IronSource เป็นแหล่งที่มาของโฆษณาในขั้นตอนที่ 2 นอกจากนี้ คุณจะต้องติดต่อทีมสนับสนุนของ IronSource ที่ [e-mail] เพื่อตั้งค่ารหัสอินสแตนซ์สำหรับการสนับสนุนโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

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

นอกเหนือจาก APP KEY และInstance IDแล้ว คุณยังต้องใช้Secret Key ของ ironSource และโทเค็นการรีเฟรชเพื่อตั้งค่าAdMob รหัสหน่วยโฆษณาด้วย

หมายเหตุ: เฉพาะผู้ใช้ที่มีสิทธิ์ระดับผู้ร่วมให้ข้อมูลหรือผู้ดูแลระบบเท่านั้นที่จะใช้ API เหล่านี้ได้

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

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

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

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

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

Android

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

iOS

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

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

สำคัญ: ยืนยันว่าคุณมีสิทธิ์การจัดการบัญชีเพื่อกำหนดค่าสำหรับคำยินยอมในสหภาพยุโรปและ GDPR, CPRA และ User Messaging Platform ให้เสร็จสมบูรณ์ โปรดดูรายละเอียดที่จัดการสิทธิ์ของผู้ใช้ในการเข้าถึงบัญชีของคุณ

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

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

หมายเหตุ: การไม่ผสานรวมเวอร์ชัน ironSource และ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ที่เข้ากันได้อาจทำให้เกิดปัญหาการสร้าง

การผสานรวมผ่าน pub.dev

(Android เท่านั้น) เพิ่มที่เก็บต่อไปนี้ลงในไฟล์ build.gradle ภายในไดเรกทอรี android ของโปรเจ็กต์

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วยironSource SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_ironsource: ^1.0.0

การผสานรวมด้วยตนเอง

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ ironSource ดึงข้อมูลไฟล์ที่ดาวน์โหลด และเพิ่มโฟลเดอร์ปลั๊กอินที่ดึงมา (และเนื้อหาในไฟล์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

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

ความยินยอมของสหภาพยุโรปและ GDPR

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

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

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setConsent(true);

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

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

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

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

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

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

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

Android

กฎ ProGuard

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

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

วงจรการใช้งานแอปพลิเคชัน

ลบล้างเมธอด onPause() และ onResume() ในแต่ละกิจกรรมเพื่อเรียกใช้เมธอด ironSource ที่เกี่ยวข้องดังนี้

Java

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

Kotlin

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

iOS

การผสานรวม SKAdNetwork

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ ironSource ก่อนเปิดตัวแอป

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

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

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

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Flutter ของ ironSource

1.0.0

• การเผยแพร่ครั้งแรก
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ Android ของ ironSource เวอร์ชัน 8.0.0.0
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ iOS ของ ironSource เวอร์ชัน 8.0.0.0.0
• สร้างและทดสอบด้วยปลั๊กอิน Google Mobile Ads Flutter เวอร์ชัน 5.1.0