คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก ironSource โฆษณาโดยใช้ สื่อกลาง ซึ่งครอบคลุม Waterfall การผสานรวม ซึ่งครอบคลุมถึงวิธีเพิ่มโฆษณา ironSource ไปยังหน่วยโฆษณา การกำหนดค่าสื่อกลางและวิธีผสานรวม SDK โฆษณา ironSource และอะแดปเตอร์ ลงในแอป Flutter
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับโฆษณา ironSource ความสามารถต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | 1 |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | 2 |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | 2 |
1 การผสานรวมการเสนอราคาอยู่ใน รุ่นเบต้าแบบจำกัดผู้ใช้งาน โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
2 รูปแบบนี้เท่านั้น ได้รับการรองรับในการผสานรวม Waterfall
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ที่ Flutter กำลังทำงานซึ่งกำหนดค่าด้วย Google SDK โฆษณาในอุปกรณ์เคลื่อนที่ โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน ironSource Ads UI
ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณาใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม ironSource Mobile ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม ironSource Mobile ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน AdMob
ขั้นตอนที่ 3: นำเข้า SDK โฆษณา ironSource และอะแดปเตอร์
การผสานรวมผ่าน pub.dev
(Android เท่านั้น) เพิ่มที่เก็บต่อไปนี้ลงในไฟล์ build.gradle
ภายใน
ไดเรกทอรี android
ของโปรเจ็กต์ของคุณ:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
เพิ่มการอ้างอิงต่อไปนี้ด้วยเวอร์ชันล่าสุดของ
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 Ads SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้ความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้มีการเปิดเผยข้อมูลบางอย่าง และ ความยินยอมที่ได้รับจาก ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับ การใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นไปตาม ข้อกำหนดด้าน ePrivacy และการคุ้มครองข้อมูลทั่วไปของสหภาพยุโรป กฎระเบียบ (GDPR) เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจรวบรวม ได้รับ หรือใช้ข้อมูลส่วนตัว และ ให้ข้อมูลเกี่ยวกับการใช้งานของแต่ละเครือข่าย ขณะนี้ Google ไม่สามารถ ส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับโฆษณา ironSource
ประกอบด้วย
GmaMediationIronsource().SetConsent()
โค้ดตัวอย่างต่อไปนี้แสดงวิธีผ่าน
ข้อมูลความยินยอมต่อ ironSource Ads SDK หากคุณเลือกที่จะโทรถึง
เราขอแนะนำให้คุณดำเนินการก่อนที่จะขอโฆษณาผ่าน
SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
ดูเอกสารประกอบของ ironSource Ads ใน การตั้งค่าขั้นสูงสำหรับกฎระเบียบ เพื่อดูรายละเอียดเพิ่มเติม
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
สหรัฐอเมริกา กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐ ต้องให้ผู้ใช้ได้รับ เพื่อเลือกไม่ใช้ "การลดราคา" ของ "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ข้อกำหนดดังกล่าว) โดยการเลือกไม่ใช้ที่นำเสนอผ่านโฆษณาว่า "อย่าขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นได้ชัด ข้อมูล" ลิงก์ในหน้า "การขาย" หน้าแรกของพรรคการเมือง สหรัฐอเมริกา สถานะความเป็นส่วนตัว คู่มือการปฏิบัติตามกฎหมายช่วยให้คุณ การประมวลผลข้อมูลแบบจำกัด สําหรับการแสดงโฆษณาของ Google แต่ Google ใช้การตั้งค่านี้กับโฆษณาแต่ละรายการไม่ได้ เครือข่ายในเชนสื่อกลาง (Mediation Chain) ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่สามารถเข้าร่วมการขาย และปฏิบัติตามคำแนะนำ จากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อ การปฏิบัติตามข้อกำหนด
ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับโฆษณา ironSource
ประกอบด้วย
GmaMediationIronsource().setDoNotSell
โค้ดตัวอย่างต่อไปนี้แสดงวิธีผ่าน
ข้อมูลความยินยอมต่อ ironSource Ads SDK ต้องตั้งค่าตัวเลือกเหล่านี้ก่อน
คุณเริ่มต้นโฆษณาบนมือถือของ Google
SDK
เพื่อให้แน่ใจว่าจะมีการส่งต่อ URL ไปยัง ironSource Ads SDK อย่างถูกต้อง
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
โปรดดูเอกสารประกอบของ ironSource Ads เกี่ยวกับการตั้งค่ากฎระเบียบขั้นสูงสำหรับทั้ง 2 กลุ่ม Android และ iOS เพื่อดูรายละเอียดเพิ่มเติมและค่าที่ระบุในเมธอด
ขั้นตอนที่ 5: เพิ่มโค้ดที่จําเป็น
Android
กฎ Proguard
หากคุณย่อ ปรับให้ยากต่อการอ่าน (Obfuscate) และเพิ่มประสิทธิภาพแอป โฆษณา IronSource ต้องใช้กฎ ProGuard เพิ่มเติมสำหรับโปรเจ็กต์ของคุณ
ปรึกษา
คู่มือการผสานรวม Android SDK ของโฆษณา IronSource
เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับกฎ ProGuard ที่จำเป็นสำหรับโปรเจ็กต์ของคุณ
แล้วเพิ่มกฎเหล่านั้นลงในไฟล์ proguard-user.txt
วงจรแอปพลิเคชัน
ลบล้างเมธอด onPause()
และ onResume()
ในแต่ละเมธอด
กิจกรรมของคุณเพื่อเรียกใช้เมธอด ironSource Ads ที่เกี่ยวข้องด้วยวิธีต่อไปนี้
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
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก IronSource ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ ironSource Ads (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก ironSource Ads ผู้เผยแพร่โฆษณาสามารถตรวจสอบ
ข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณาโดยใช้
ResponseInfo
ภายใต้
ชั้นเรียนต่อไปนี้
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
นี่คือรหัสและข้อความประกอบที่ส่งมาโดยโฆษณา ironSource อะแดปเตอร์เมื่อโฆษณาโหลดไม่สำเร็จ
Android
รหัสข้อผิดพลาด | เหตุผล |
---|---|
101 | พารามิเตอร์เซิร์ฟเวอร์ ironSource Ads ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
102 | โฆษณา ironSource จำเป็นต้องมีบริบทกิจกรรมเพื่อเริ่มต้น SDK |
103 | โฆษณา ironSource สามารถโหลดโฆษณาได้เพียง 1 รายการต่อรหัสอินสแตนซ์ ironSource |
105 | โฆษณา ironSource ไม่สนับสนุนขนาดโฆษณาแบนเนอร์ที่ขอ |
106 | ironSource Ads SDK ไม่เริ่มต้น |
501-1056 | ข้อผิดพลาดของ SDK โฆษณา ironSource ดูเอกสารประกอบ เพื่อดูรายละเอียดเพิ่มเติม |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
101 | พารามิเตอร์เซิร์ฟเวอร์ ironSource Ads ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
102 | อะแดปเตอร์โฆษณา ironSource ไม่สนับสนุนรูปแบบโฆษณาที่ร้องขอ |
103 | โหลดโฆษณา ironSource สำหรับการกำหนดค่าเครือข่ายนี้แล้ว |
104 | โฆษณา ironSource ไม่สนับสนุนขนาดโฆษณาแบนเนอร์ที่ขอ |
508-1037 | ข้อผิดพลาดของ SDK โฆษณา ironSource ดูเอกสารประกอบ เพื่อดูรายละเอียดเพิ่มเติม |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Flutter ironSource
1.0.0
- การเผยแพร่ครั้งแรก
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ Android ironSource เวอร์ชัน 8.0.0.0
- ยืนยันความเข้ากันได้กับอะแดปเตอร์ iOS รุ่น 8.0.0.0.0 ของ ironSource
- สร้างและทดสอบด้วย Google Mobile Ads Flutter Plugin เวอร์ชัน 5.1.0