คู่มือนี้จะแสดงวิธีผสานรวมตัวกลางสื่อกลางกับแอป Flutter
ข้อกำหนดเบื้องต้น
ก่อนที่จะผสานรวมสื่อกลางสำหรับรูปแบบโฆษณา คุณต้องผสานรวมรูปแบบโฆษณานั้นเข้ากับแอปก่อน โดยทำดังนี้
- โฆษณาแบนเนอร์
- โฆษณาคั่นระหว่างหน้า
- โฆษณาเนทีฟ
- โฆษณาที่มีการให้รางวัล
- โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
หากเพิ่งเริ่มใช้สื่อกลาง อ่าน ข้อมูลเบื้องต้นเกี่ยวกับสื่อกลาง
เริ่มต้น Google Mobile Ads SDK
คู่มือเริ่มต้นฉบับย่อจะแสดงวิธีเริ่มต้นใช้งาน Google Mobile Ads SDK ในระหว่างการเรียกใช้การเริ่มต้นนั้น ระบบจะเริ่มต้นใช้งาน Mediation Adapter ด้วย คุณควรรอให้การเริ่มต้นเสร็จสมบูรณ์ก่อนที่จะโหลดโฆษณาเพื่อยืนยันการเข้าร่วมอย่างเต็มรูปแบบจากเครือข่ายโฆษณาทุกเครือข่ายในคำขอโฆษณาแรก
โค้ดตัวอย่างต่อไปนี้แสดงวิธีตรวจสอบสถานะการเริ่มต้นของอแดปเตอร์แต่ละตัวก่อนที่จะส่งคำขอโฆษณา
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")
เพิ่มการขึ้นต่อกันสำหรับเครือข่ายพาร์ทเนอร์
คุณต้องเพิ่ม Ad Mediation Adapter และทรัพยากร Dependency ของ Adapter เหล่านั้นลงในโปรเจ็กต์ 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