คู่มือนี้จะแสดงวิธีผสานรวมอะแดปเตอร์สื่อกลางกับแอป 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")
เพิ่มทรัพยากร Dependency สำหรับเครือข่ายพาร์ทเนอร์
คุณต้องเพิ่มอะแดปเตอร์สื่อกลางและทรัพยากร Dependency ลงในโปรเจ็กต์ 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 แหล่งที่มาของโฆษณาบุคคลที่สามทั้งหมดสำหรับหน่วยโฆษณาแบนเนอร์ที่ใช้ในสื่อกลาง วิธีนี้จะป้องกันไม่ให้เกิดการรีเฟรชซ้ำ เนื่องจาก Ad Manager จะทริกเกอร์การรีเฟรชตามอัตราการรีเฟรชของหน่วยโฆษณาแบนเนอร์ด้วย
ใช้โฆษณาเนทีฟกับสื่อกลาง
ต่อไปนี้คือแนวทางปฏิบัติแนะนำบางส่วนที่ควรพิจารณาเมื่อใช้สื่อกลางแบบเนทีฟ
- นโยบายการนำเสนอโฆษณาเนทีฟ
- เครือข่ายโฆษณาแต่ละเครือข่ายมีนโยบายของตนเอง เมื่อใช้สื่อกลาง คุณต้องคำนึงถึงว่าแอปยังคงต้องปฏิบัติตามนโยบายของเครือข่ายสื่อกลางที่แสดงโฆษณา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาและ GDPR
หากคุณต้องปฏิบัติตามกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาหรือกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ให้ทำตามขั้นตอนในการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาหรือการตั้งค่า GDPR เพื่อเพิ่มพาร์ทเนอร์สื่อกลางในรายชื่อพาร์ทเนอร์โฆษณาตามกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาหรือ GDPR ในเครื่องมือความเป็นส่วนตัวและการแสดงข้อความแจ้งผู้ใช้ของ Ad Manager มิเช่นนั้นพาร์ทเนอร์อาจแสดงโฆษณาในแอปของคุณไม่ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้การประมวลผลข้อมูลแบบจำกัด (RDP) และการขอความยินยอมตาม GDPR ด้วย SDK สำหรับ User Messaging Platform (UMP) ของ Google