คู่มือนี้จะแสดงวิธีผสานรวมอะแดปเตอร์สื่อกลางกับแอป Flutter
ข้อกำหนดเบื้องต้น
คุณต้องผสานรวมรูปแบบโฆษณานั้นๆ เข้ากับแอปก่อนจึงจะผสานรวมสื่อกลางสำหรับรูปแบบโฆษณาได้ โดยทำดังนี้
- โฆษณาแบนเนอร์
- โฆษณาคั่นระหว่างหน้า
- โฆษณาเนทีฟ
- โฆษณาที่มีการให้รางวัล
- โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
ยังไม่เคยใช้สื่อกลางใช่ไหม อ่าน ข้อมูลเบื้องต้นเกี่ยวกับสื่อกลาง
เริ่มต้นใช้งาน Google Mobile Ads Flutter Plugin
คู่มือเริ่มใช้งานฉบับย่อจะแสดงวิธีเริ่มต้นใช้งานGoogle Mobile Ads Flutter Plugin โดยอะแดปเตอร์สื่อกลางจะเริ่มต้นใช้งานด้วยในระหว่างการเรียกเริ่มต้นใช้งานดังกล่าว คุณต้องรอให้การเริ่มต้นใช้งานเสร็จสมบูรณ์ก่อนที่จะโหลดโฆษณาเพื่อยืนยันการเข้าร่วมอย่างเต็มรูปแบบจากทุกเครือข่ายโฆษณาในคำขอโฆษณาแรก
โค้ดตัวอย่างต่อไปนี้แสดงวิธีตรวจสอบสถานะการเริ่มต้นใช้งานของอะแดปเตอร์แต่ละรายการก่อนที่จะส่งคำขอโฆษณา
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 flutterSdkPath = {
def properties = new Properties()
file("local.properties").withInputStream { properties.load(it) }
def flutterSdkPath = properties.getProperty("flutter.sdk")
assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
return flutterSdkPath
}()
includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
เพิ่มการพึ่งพิงสำหรับเครือข่ายพาร์ทเนอร์
คุณต้องเพิ่มอะแดปเตอร์สื่อกลางและการพึ่งพิงของอะแดปเตอร์ลงในโปรเจ็กต์ Android และ iOS โดยเพิ่มได้ด้วยการอัปเดตไฟล์ build.gradle ระดับแอปใน Android และ Podfile ใน iOS Google มีอะแดปเตอร์โอเพนซอร์สใน GitHub
สำหรับทั้ง
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 เพื่อเพิ่มพาร์ทเนอร์สื่อกลางในรายชื่อพาร์ทเนอร์โฆษณา GDPR หรือรายชื่อพาร์ทเนอร์โฆษณาของรัฐในสหรัฐอเมริกาในความเป็นส่วนตัวและการแสดงข้อความแจ้งผู้ใช้ของ Ad Manager หากไม่ดำเนินการดังกล่าว พาร์ทเนอร์อาจแสดงโฆษณาในแอปของคุณไม่ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้ การประมวลผลข้อมูลแบบจำกัด (RDP) และขอความยินยอมตาม GDPR ด้วย SDK สำหรับ User Messaging Platform (UMP) ของ Google