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