คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก Meta Audience Network โดยใช้ สื่อกลาง, ที่ครอบคลุมการเสนอราคา การผสานรวม ซึ่งครอบคลุมถึงวิธีเพิ่ม Meta Audience Network ลงในหน่วยโฆษณา การกำหนดค่าสื่อกลาง และวิธีผสานรวม Meta Audience Network อะแดปเตอร์ลงใน Flutter แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับ Meta Audience เครือข่ายมีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
การแสดงวิดีโอตามลำดับขั้น 1 | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล |
1 เครือข่ายกลุ่มเป้าหมายของ Meta กลายเป็น การเสนอราคาเท่านั้น ในปี 2021
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Flutter 3.7.0 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 10.0 ขึ้นไป
- Meta Audience Network SDK ล่าสุดมักจะต้องใช้ Xcode
- โครงการ Flutter ที่ใช้งานอยู่ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์
ขั้นตอนที่ 1: กำหนดค่าใน UI ของ Meta Audience Network
ขั้นตอนที่ 2: ตั้งค่าความต้องการใน Meta Audience Network ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Facebook ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Facebook ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน AdMob
ขั้นตอนที่ 3: นำเข้า Meta Audience Network SDK และอะแดปเตอร์
การผสานรวมผ่าน pub.dev
เพิ่มการอ้างอิงต่อไปนี้ด้วยเวอร์ชันล่าสุดของ
Meta Audience Network SDK และอะแดปเตอร์ในแพ็กเกจ
ไฟล์ pubspec.yaml
:
dependencies:
gma_mediation_meta: ^1.0.0
การผสานรวมด้วยตนเอง
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ
Meta Audience Network
แยกไฟล์ที่ดาวน์โหลด และเพิ่มโฟลเดอร์ปลั๊กอินที่ดึงมา
(และเนื้อหาภายใน) ลงในโปรเจ็กต์ Flutter ของคุณ จากนั้นให้อ้างอิงปลั๊กอินใน
pubspec.yaml
ด้วยการเพิ่มทรัพยากร Dependency ต่อไปนี้
dependencies:
gma_mediation_meta:
path: path/to/local/package
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน Meta Audience Network SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้ความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้มีการเปิดเผยข้อมูลบางอย่าง และ ความยินยอมที่ได้รับจาก ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับ การใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นไปตาม ข้อกำหนดด้าน ePrivacy และการคุ้มครองข้อมูลทั่วไปของสหภาพยุโรป กฎระเบียบ (GDPR) เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจรวบรวม ได้รับ หรือใช้ข้อมูลส่วนตัว และ ให้ข้อมูลเกี่ยวกับการใช้งานของแต่ละเครือข่าย ขณะนี้ Google ไม่สามารถ ส่งต่อตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
อ่านคำแนะนำของเมตาเพื่อดูข้อมูลเกี่ยวกับ การโฆษณาด้วย GDPR และ Meta
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
สหรัฐอเมริกา กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐ ต้องให้ผู้ใช้ได้รับ เพื่อเลือกไม่ใช้ "การลดราคา" ของ "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ข้อกำหนดดังกล่าว) โดยการเลือกไม่ใช้ที่นำเสนอผ่านโฆษณาว่า "อย่าขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นได้ชัด ข้อมูล" ลิงก์ใน "การขาย" หน้าแรกของพรรคการเมือง สหรัฐอเมริกา สถานะความเป็นส่วนตัว คู่มือการปฏิบัติตามกฎหมายช่วยให้คุณ การประมวลผลข้อมูลแบบจำกัด สําหรับการแสดงโฆษณาของ Google แต่ Google ใช้การตั้งค่านี้กับโฆษณาแต่ละรายการไม่ได้ เครือข่ายในเชนสื่อกลาง (Mediation Chain) ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่สามารถเข้าร่วมการขาย และปฏิบัติตามคำแนะนำ จากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อ การปฏิบัติตามข้อกำหนด
สำหรับผู้ใช้ในแคลิฟอร์เนีย โปรดอ่านการประมวลผลข้อมูลของ Meta ตัวเลือกเพิ่มเติม
ขั้นตอนที่ 5: เพิ่มโค้ดที่จําเป็น
Android
ไม่ต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Meta Audience Network
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Meta Audience Network
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
เปิดใช้การติดตามการโฆษณา
หากคุณจะสร้างแอปสำหรับ iOS 14 ขึ้นไป ให้ตรวจสอบ คำแนะนำเกี่ยวกับวิธีตั้งค่า การติดตามการโฆษณา แจ้งว่าไม่เหมาะสม
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน Meta Audience Network UI
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Meta Audience Network ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ Meta Audience Network (Bidding) แหล่งที่มาของโฆษณา
ขั้นตอนที่ไม่บังคับ
การแคชใน Android 9
Android
ตั้งแต่ Android 9 (API ระดับ 28) ระบบจะปิดใช้การรองรับ cleartext โดย ค่าเริ่มต้น, ซึ่งจะส่งผลต่อฟังก์ชันการแคชสื่อของ Meta Audience SDK เครือข่าย และอาจส่งผลต่อประสบการณ์ของผู้ใช้และรายได้จากโฆษณา ติดตาม Meta's เอกสารประกอบ เพื่ออัปเดตการกำหนดค่าความปลอดภัยของเครือข่ายในแอปของคุณ
iOS
ไม่เกี่ยวข้องกับการผสานรวม iOS
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Audience Network คุณสามารถตรวจสอบ
ข้อผิดพลาดสำคัญจากการตอบกลับโฆษณาโดยใช้
ResponseInfo
ภายใต้ชั้นเรียนต่อไปนี้
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
นี่คือรหัสและข้อความประกอบที่ส่งโดย Meta Audience อะแดปเตอร์เครือข่ายเมื่อโฆษณาโหลดไม่สำเร็จ
Android
รหัสข้อผิดพลาด | เหตุผล |
---|---|
101 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่ง) |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Meta Audience Network รองรับ |
103 | ผู้เผยแพร่โฆษณาต้องขอโฆษณาที่มีบริบท Activity |
104 | เริ่มต้น Meta Audience Network SDK ไม่สําเร็จ |
105 | ผู้เผยแพร่โฆษณาไม่ได้ขอโฆษณาเนทีฟแบบรวม |
106 | โฆษณาเนทีฟที่โหลดเป็นออบเจ็กต์ที่แตกต่างจากที่คาดไว้ |
107 | ออบเจ็กต์ Context ที่ใช้ไม่ถูกต้อง |
108 | โฆษณาที่โหลดไม่มีชิ้นงานโฆษณาเนทีฟที่จำเป็น |
109 | สร้างโฆษณาเนทีฟจากเพย์โหลดราคาเสนอไม่สำเร็จ |
110 | Meta Audience Network SDK แสดงโฆษณาคั่นระหว่างหน้า/โฆษณาที่มีการให้รางวัลไม่สำเร็จ |
111 | มีการส่งข้อยกเว้นเมื่อสร้างออบเจ็กต์ AdView ของ Meta Audience Network |
1000-9999 | Meta Audience Network แสดงผลข้อผิดพลาดเฉพาะ SDK โปรดดู เอกสารประกอบของ Meta Audience Network เพื่อดูรายละเอียดเพิ่มเติม |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
101 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่ง) |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Meta Audience Network รองรับ |
103 | เริ่มต้นออบเจ็กต์โฆษณา Meta Audience Network ไม่สำเร็จ |
104 | Meta Audience Network SDK แสดงโฆษณาคั่นระหว่างหน้า/โฆษณาที่มีการให้รางวัลไม่สำเร็จ |
105 | ตัวควบคุมมุมมองรูทของโฆษณาแบนเนอร์คือ nil |
106 | เริ่มต้น Meta Audience Network SDK ไม่สําเร็จ |
1000-9999 | Meta Audience Network แสดงผลข้อผิดพลาดเฉพาะ SDK โปรดดู เอกสารประกอบของ Meta Audience Network เพื่อดูรายละเอียดเพิ่มเติม |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Meta Audience Network Flutter
1.0.1
- เพิ่มคลาสลูกดอกเพื่อให้มีการวิเคราะห์ความเข้ากันได้กับแพลตฟอร์มโฮสต์อย่างถูกต้อง
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ Meta Android เวอร์ชัน 6.17.0.0
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ Meta iOS เวอร์ชัน 6.15.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Flutter Plugin เวอร์ชัน 5.1.0
1.0.0
- การเผยแพร่ครั้งแรก
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ Meta Android เวอร์ชัน 6.17.0.0
- ตรวจสอบความเข้ากันได้กับอะแดปเตอร์ Meta iOS เวอร์ชัน 6.15.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Flutter Plugin เวอร์ชัน 5.0.0