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

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

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

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

¹ การผสานรวมการเสนอราคาอยู่ใน รุ่นเบต้าแบบจำกัดผู้ใช้งาน โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

² รูปแบบนี้เท่านั้น ได้รับการรองรับในการผสานรวม 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

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

เพิ่ม 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: เพิ่มโค้ดที่จําเป็น

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

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

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

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

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

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

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

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

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

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

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

นี่คือรหัสและข้อความประกอบที่ส่งมาโดยโฆษณา 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