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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ โปรดตรวจสอบสิ่งต่อไปนี้

  • เวอร์ชัน Google Mobile Ads Flutter Plugin ล่าสุด
  • เฟรมเวิร์ก Flutter เวอร์ชัน 3.7.0 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • ระดับ API 24 ขึ้นไปของ Android
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
  • โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่ ตั้งค่า Google Mobile Ads Flutter Plugin
  • ตั้งค่าสื่อกลาง

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

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

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

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

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

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

Android

iOS

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

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

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

การเสนอราคา

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

Android

iOS

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

Android

iOS

น้ำตก

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

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

ค้นหาคีย์ Reporting API

การเสนอราคา

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

น้ำตก

คลิกแท็บ API ใน หน้าบัญชีของฉัน และจดคีย์ลับและโทเค็นการรีเฟรช

อัปเดต 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: นำเข้า ironSource Ads SDK และอะแดปเตอร์

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

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

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

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

dependencies:
  gma_mediation_ironsource: ^2.7.0

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

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

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

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

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

โฆษณา ironSource จะอ่านความยินยอมตาม GDPR ที่แพลตฟอร์มการจัดการความยินยอมตั้งค่าไว้โดยอัตโนมัติ ซึ่งรองรับ ข้อกําหนดความยินยอมเพิ่มเติมของ Google รวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ที่ การสนับสนุน UMP ของ Google และ CMP ที่รองรับความยินยอมเพิ่มเติมของ Google

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

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

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

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

GmaMediationIronsource().setDoNotSell(true);

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

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

Android

กฎ Proguard

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

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับกฎ ProGuard ที่จำเป็นสำหรับโปรเจ็กต์ของคุณในคู่มือการผสานรวม Android SDK ของ ironSource Ads และเพิ่มกฎเหล่านั้นลงในไฟล์ 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

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

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

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

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

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

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

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

iOS

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

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

เวอร์ชัน 2.7.0

เวอร์ชัน 2.6.0

เวอร์ชัน 2.5.1

เวอร์ชัน 2.5.0

เวอร์ชัน 2.4.3

เวอร์ชัน 2.4.2

เวอร์ชัน 2.4.1

เวอร์ชัน 2.4.0

เวอร์ชัน 2.3.0

เวอร์ชัน 2.2.0

เวอร์ชัน 2.1.0

เวอร์ชัน 2.0.1

เวอร์ชัน 2.0.0

เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.1

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.1

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0