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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ โปรดตรวจสอบสิ่งต่อไปนี้

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

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

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

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

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

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

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

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

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

    Android

    iOS

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

    เลือก Google Ad Manager เป็นแพลตฟอร์มสื่อกลาง แล้วคลิกสร้างตำแหน่งโฆษณา

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

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

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

    อัปเดต 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: ^1.7.1

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

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ 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) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง (Mediation Chain)

    อ่านคำแนะนำของ Meta เพื่อดูข้อมูลเกี่ยวกับ GDPR และการโฆษณาของ 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 และเปิดใช้โหมดทดสอบใน UI ของ Meta Audience Network

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

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

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

    การแคชใน Android 9

    Android

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

    เวอร์ชัน 1.7.1

    เวอร์ชัน 1.7.0

    เวอร์ชัน 1.6.0

    เวอร์ชัน 1.5.4

    เวอร์ชัน 1.5.3

    รุ่น 1.5.2

    รุ่น 1.5.1

    เวอร์ชัน 1.5.0

    เวอร์ชัน 1.4.3

    เวอร์ชัน 1.4.2

    เวอร์ชัน 1.4.1

    เวอร์ชัน 1.4.0

    เวอร์ชัน 1.3.0

    เวอร์ชัน 1.2.0

    เวอร์ชัน 1.1.0

    เวอร์ชัน 1.0.1

    เวอร์ชัน 1.0.0