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

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

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

Ad Manager Mediation Adapter สําหรับ ironSource Ads มีความสามารถดังต่อไปนี้

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

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

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

ข้อกำหนด

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

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

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

หากต้องการเพิ่มแอปพลิเคชันลงในแดชบอร์ดโฆษณาของ ironSource ให้คลิกปุ่มแอปใหม่

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

เลือกแอปเวอร์ชันที่เผยแพร่ ป้อนชื่อแอป แล้วคลิกนําเข้าข้อมูลแอป

หากแอปไม่พร้อมให้บริการ ให้เลือกแอปไม่พร้อมให้บริการใน Store ของแอปพลิเคชัน แล้วระบุชื่อชั่วคราวของแอป เลือกแพลตฟอร์ม

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

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

Android

iOS

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

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

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

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

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

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

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

ค้นหาคีย์ Reporting API

นอกจากคีย์แอปและรหัสอินสแตนซ์แล้ว คุณจะต้องมีคีย์ลับและโทเค็นรีเฟรชของ IronSource Ads ด้วยเพื่อตั้งค่ารหัสหน่วยโฆษณา Ad Manager

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

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

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

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

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

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

Android

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

iOS

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

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

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

ขั้นตอนที่ 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.0.0

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

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

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

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

ความยินยอมของ EU และ GDPR

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

ปลั๊กอินสื่อกลาง Google Mobile Ads สําหรับโฆษณา ironSource มีวิธี 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 มีวิธี 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: เพิ่มโค้ดที่จำเป็น

Android

กฎ Proguard

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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

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

เวอร์ชันถัดไป

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

1.1.0

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

1.0.0

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