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

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

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

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

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

¹ การผสานการเสนอราคาอยู่ในรุ่นเบต้าแบบเปิด

² รูปแบบนี้รองรับเฉพาะในการผสานรวม Waterfall

ข้อกำหนด

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

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

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

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

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

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

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

AndroidiOS

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

ถัดไป ให้กําหนดค่าอินสแตนซ์สําหรับแอปที่เพิ่ม

การเสนอราคาน้ำตก

ไปที่ LevelPlay > การตั้งค่า > อินสแตนซ์ แล้วเลือกแอปของคุณ ในส่วนการเสนอราคา ให้คลิก ironSource

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

AndroidiOS

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

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

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

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

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

ค้นหาคีย์ Reporting API

การเสนอราคาน้ำตก

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

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

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

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

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

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

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

AndroidiOS

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

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

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

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

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

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

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

การผสานรวมผ่าน 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: ^1.1.0

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

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

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

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

ความยินยอมของผู้ใช้ EU และ GDPR

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

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

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

GmaMediationIronsource().setConsent(true);

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

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

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

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

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

GmaMediationIronsource().setDoNotSell(true);

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

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

AndroidiOS

กฎ Proguard

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

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

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

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

JavaKotlin

@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)
}

การผสานรวม SKAdNetwork

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสําหรับ AdMob และ AdSense ของ ironSource ก่อนเผยแพร่แอป

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

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

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

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

AndroidiOS

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

AndroidiOS

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

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

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

1.1.0

• ตอนนี้ปลั๊กอิน iOS เป็นเฟรมเวิร์กแบบคงที่

• รองรับอะแดปเตอร์ Android ของ ironSource เวอร์ชัน 8.6.1.0
• รองรับอะแดปเตอร์ iOS เวอร์ชัน 8.6.0.0.0 ของ ironSource

• สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.3.1

1.0.0

• การเผยแพร่ครั้งแรก

• รองรับอะแดปเตอร์ Android เวอร์ชัน 8.0.0.0 ของ ironSource
• รองรับอะแดปเตอร์ iOS เวอร์ชัน 8.0.0.0.0 ของ ironSource

• สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0