คู่มือนี้จะแสดงวิธีผสานรวมอะแดปเตอร์สื่อกลางกับแอป 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")
เพิ่มการขึ้นต่อกันสำหรับเครือข่ายพาร์ทเนอร์
คุณต้องเพิ่มอะแดปเตอร์สื่อกลางและทรัพยากร 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