ผสานรวม Meta Audience Network กับการเสนอราคา

คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจากเครือข่ายผู้ชมของ Meta โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม Meta Audience Network ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Meta Audience Network และ อแดปเตอร์เข้ากับแอป Flutter

การผสานรวมและรูปแบบโฆษณาที่รองรับ

อแดปเตอร์สื่อกลาง Ad Manager สำหรับ Meta Audience Network มีความสามารถดังนี้

การผสานรวม
การเสนอราคา
Waterfall  1
รูปแบบ
ป้ายประกาศ
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
เนทีฟ

1 Meta Audience Network เปลี่ยนเป็น การเสนอราคาเท่านั้น ในปี 2021

ข้อกำหนด

  • Google Mobile Ads SDK เวอร์ชันล่าสุด
  • Flutter 3.7.0 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • API ระดับ 23 ขึ้นไปของ Android
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 10.0 ขึ้นไป
    • โดยปกติแล้ว SDK ของ Meta Audience Network เวอร์ชันล่าสุดจะต้องใช้ Xcode เวอร์ชันล่าสุด
  • โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
  • ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ Meta Audience Network

ลงชื่อสมัครใช้และเข้าสู่ระบบหน้าเริ่มต้นของ Business Manager

คลิกเริ่มต้นใช้งาน แล้วคลิกสร้างบัญชีใหม่

กรอกข้อมูลธุรกิจในช่องที่ต้องกรอก แล้วคลิกถัดไป

สร้างพร็อพเพอร์ตี้

หลังจากกรอกข้อมูลที่จำเป็นแล้ว ระบบจะแจ้งให้คุณสร้างพร็อพเพอร์ตี้สำหรับแอป ป้อนชื่อพร็อพเพอร์ตี้ที่ต้องการสำหรับแอป แล้วคลิกถัดไป

จากนั้นเลือกแพลตฟอร์มที่จะสร้างรายได้

เพิ่มรายละเอียดแอป แล้วคลิกถัดไป

Android

iOS

ตั้งค่าบัญชีการชำระเงินโดยคลิกเพิ่มบัญชีการชำระเงินใหม่ ระบบจะเปลี่ยนเส้นทางคุณไปยังหน้าใหม่เพื่อป้อนข้อมูลการชำระเงิน กรอกรายละเอียดที่ จำเป็น แล้วคลิกถัดไป

เลือก Google AdMob เป็นแพลตฟอร์มสื่อกลาง แล้วคลิก สร้างตําแหน่ง

เลือกรูปแบบ กรอกแบบฟอร์ม แล้วคลิกสร้าง

จดรหัสตําแหน่งโฆษณา

คลิกเสร็จสิ้น

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้ สร้างไฟล์ app-ads.txt สำหรับ Ad Manager

หากต้องการใช้ app-ads.txt สำหรับ Meta Audience Network โปรดดู การระบุผู้ขายที่ได้รับอนุญาตด้วย app-ads.txt

เปิดโหมดทดสอบ

ดูวิธีการโดยละเอียดเกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ Meta Audience Network ได้ในคู่มือการทดสอบการติดตั้งใช้งาน Audience Network

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ Meta Audience Network ใน UI ของ Ad Manager

กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ Android

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ iOS

เพิ่ม Meta ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Meta ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager

ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ของ Meta Audience Network

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วย SDK และอแดปเตอร์ Meta Audience Network เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_meta: ^

การผสานรวมด้วยตนเอง

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ Meta Audience Network แตกไฟล์ที่ดาวน์โหลด แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา (และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_meta:
    path: path/to/local/package

ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน SDK ของ Meta Audience Network

เพื่อปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อ ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอ ความยินยอมในการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมาย กำหนด และสำหรับการเก็บรวบรวม แชร์ และใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง Google ไม่สามารถส่งต่อตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ

ดูข้อมูลเกี่ยวกับ GDPR และการโฆษณาของ Meta ได้ในคำแนะนำของ Meta

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา

กฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ์ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัด สำหรับการแสดงโฆษณาของ Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางของคุณ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจเข้าร่วมในการขายข้อมูลส่วนตัว และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้ เป็นไปตามข้อกำหนด

สำหรับผู้ใช้ในแคลิฟอร์เนีย โปรดดูตัวเลือกการประมวลผลข้อมูลของ Meta

ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Meta Audience Network

iOS

การผสานรวม SKAdNetwork

ทําตามเอกสารประกอบของ Meta Audience Network เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

เปิดใช้การติดตามการโฆษณา

หากคุณสร้างแอปสำหรับ iOS 14 ขึ้นไป โปรดดูวิธีการตั้งค่าแฟล็กการติดตามโฆษณาของ Meta Audience Network

ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน

เปิดใช้โฆษณาทดสอบ

ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager และเปิดใช้โหมดทดสอบใน Meta Audience Network UI แล้ว

ยืนยันโฆษณาทดสอบ

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Meta Audience Network ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Meta Audience Network (การเสนอราคา)

ขั้นตอนที่ไม่บังคับ

การแคชใน Android 9

Android

ตั้งแต่ Android 9 (API ระดับ 28) เป็นต้นไป ระบบจะปิดใช้การรองรับข้อความที่ไม่ได้เข้ารหัสโดยค่าเริ่มต้น ซึ่งจะส่งผลต่อฟังก์ชันการทำงานของการแคชสื่อของ Meta Audience Network SDK และอาจส่งผลต่อประสบการณ์ของผู้ใช้และรายได้จากโฆษณา โปรดทำตามเอกสารประกอบของ Meta เพื่ออัปเดตการกำหนดค่าความปลอดภัยของเครือข่ายในแอป

iOS

ใช้ไม่ได้กับการผสานรวม iOS

รหัสข้อผิดพลาด

หากอแดปเตอร์ไม่ได้รับโฆษณาจาก Audience Network คุณสามารถตรวจสอบ ข้อผิดพลาดพื้นฐานจากคำตอบของโฆษณาได้โดยใช้ 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 ข้อยกเว้นที่เกิดขึ้นเมื่อสร้างออบเจ็กต์ Meta Audience Network AdView
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 Root view controller ของโฆษณาแบนเนอร์คือ nil
106 เริ่มต้น SDK ของ Meta Audience Network ไม่สำเร็จ
1000-9999 Meta Audience Network แสดงข้อผิดพลาดเฉพาะ SDK ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Meta Audience Network

บันทึกการเปลี่ยนแปลงของอแดปเตอร์สื่อกลาง Flutter ของ Meta Audience Network

เวอร์ชัน 1.4.1

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.1

  • เพิ่มคลาส Dart เพื่อให้วิเคราะห์ความเข้ากันได้อย่างถูกต้องกับแพลตฟอร์มโฮสต์
  • สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 5.1.0

เวอร์ชัน 1.0.0

  • รุ่นแรก
  • สร้างและทดสอบด้วยปลั๊กอิน Flutter สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 5.0.0