คู่มือนี้จะแสดงวิธีผสานรวมอะแดปเตอร์สื่อกลางกับแอป Flutter
ข้อกำหนดเบื้องต้น
ก่อนที่คุณจะสามารถผสานรวมสื่อกลางสำหรับรูปแบบโฆษณา คุณจะต้องผสานรวม รูปแบบโฆษณาลงในแอปของคุณ
- โฆษณาแบนเนอร์
- โฆษณาคั่นระหว่างหน้า
- โฆษณาเนทีฟ
- โฆษณาที่มีการให้รางวัล
- โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล โฆษณา
หากเพิ่งเคยใช้สื่อกลาง อ่านข้อมูลเบื้องต้นเกี่ยวกับสื่อกลาง
เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่
คู่มือเริ่มใช้งานฉบับย่อแสดงวิธีเริ่มต้นโฆษณาบนมือถือ SDK ในระหว่างการเรียกใช้การเริ่มต้นนั้น ระบบจะเริ่มต้นอะแดปเตอร์สื่อกลางด้วย คุณต้องรอให้เริ่มต้นเสร็จสมบูรณ์ก่อนโหลดโฆษณาเพื่อให้มั่นใจว่าเครือข่ายโฆษณาทุกเครือข่ายจะเข้าร่วมในคำขอโฆษณาแรก
โค้ดตัวอย่างต่อไปนี้แสดงวิธีตรวจสอบการเริ่มต้นของอะแดปเตอร์แต่ละรายการ ก่อนส่งคำขอโฆษณา
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize()
.then((initializationStatus) {
initializationStatus.adapterStatuses.forEach((key, value) {
debugPrint('Adapter status for $key: ${value.description}');
});
});
runApp(MyApp());
}
อัปเดตการตั้งค่า Gradle (Android เท่านั้น)
เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ settings.gradle
เพื่อให้ใช้ Android API ของปลั๊กอินได้
def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
pluginsFile.withInputStream { stream -> plugins.load(stream) }
}
plugins.each { name, path ->
def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
include ":$name"
project(":$name").projectDir = pluginDirectory
}
เพิ่มทรัพยากร Dependency สำหรับเครือข่ายพาร์ทเนอร์
ต้องเพิ่มอะแดปเตอร์สื่อกลางและทรัพยากร Dependency ใน Android
และโปรเจ็กต์ iOS เพิ่มแอปได้โดยการอัปเดตระดับแอป build.gradle
ใน Android และ Podfile
ใน iOS Google มีอะแดปเตอร์โอเพนซอร์สใน GitHub
สำหรับทั้ง 2 กลุ่ม
Android
และ
iOS
ดูคำแนะนำโดยละเอียดเกี่ยวกับวิธีเพิ่มอะแดปเตอร์ของเครือข่ายพาร์ทเนอร์แต่ละรายในเอกสารประกอบของ Android และ iOS เครือข่ายพาร์ทเนอร์แต่ละราย
ตรวจสอบคลาสอะแดปเตอร์เครือข่ายโฆษณาที่โหลดโฆษณา
โค้ดตัวอย่างต่อไปนี้แสดงวิธีบันทึกชื่อคลาสเครือข่ายโฆษณาสำหรับ โฆษณาแบนเนอร์
final bannerAd = AdManagerBannerAd(
size: [AdSize.banner],
adUnitId: '<your-ad-unit>',
listener: AdManagerBannerAdListener(
onAdLoaded: (ad) {
debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
},
),
request: AdManagerAdRequest(),
);
ใช้โฆษณาแบนเนอร์กับสื่อกลาง
อย่าลืมปิดการรีเฟรชใน UI แหล่งที่มาของโฆษณาบุคคลที่สามทั้งหมดสําหรับโฆษณาแบนเนอร์ หน่วยที่ใช้ในสื่อกลาง ซึ่งจะป้องกันไม่ให้ รีเฟรช 2 ครั้งเนื่องจาก Ad Manager จะทริกเกอร์การรีเฟรชด้วย ขึ้นอยู่กับอัตราการรีเฟรชของหน่วยโฆษณาแบนเนอร์
ใช้โฆษณาเนทีฟกับสื่อกลาง
ต่อไปนี้คือแนวทางปฏิบัติแนะนำที่ควรพิจารณาเมื่อใช้โฆษณาเนทีฟ สื่อกลาง
- นโยบายการนำเสนอโฆษณาเนทีฟ
- เครือข่ายโฆษณาแต่ละเครือข่ายมีนโยบายของตนเอง เมื่อใช้สื่อกลาง สิ่งสำคัญคือ อย่าลืมว่าแอปของคุณยังคงต้องเป็นไปตามนโยบายของสื่อกลาง เครือข่ายที่แสดงโฆษณาดังกล่าว
กฎหมายคุ้มครองความเป็นส่วนตัวและ GDPR ของรัฐในสหรัฐอเมริกา
หากคุณต้องปฏิบัติตามประเทศสหรัฐอเมริกา สถานะความเป็นส่วนตัว กฎหมายหรือการคุ้มครองข้อมูลทั่วไป กฎระเบียบ (GDPR) ให้ปฏิบัติตาม ขั้นตอนในกฎระเบียบของรัฐในสหรัฐอเมริกา การตั้งค่าหรือ GDPR การตั้งค่าเพื่อเพิ่ม พาร์ทเนอร์สื่อกลางใน "ความเป็นส่วนตัวและ" ของ Ad Manager ของการรับส่งข้อความ รายชื่อรัฐในสหรัฐอเมริกาหรือรายชื่อพาร์ทเนอร์โฆษณา GDPR มิเช่นนั้น อาจมีพาร์ทเนอร์ ไม่ได้แสดงโฆษณาในแอป
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้การประมวลผลข้อมูลแบบจำกัด (RDP) และการรับความยินยอมตาม GDPR ด้วย SDK สำหรับ User Messaging Platform (UMP) ของ Google