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

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

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

AdMob Mediation Adapter สำหรับ Meta Audience Network มีความสามารถดังนี้

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

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

ข้อกำหนด

  • Google Mobile Ads SDK เวอร์ชันล่าสุด
  • Unity 5.6 ขึ้นไป
  • ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Meta Audience Network 2.11.0 (แนะนำให้ใช้เวอร์ชันล่าสุด)
  • หากต้องการติดตั้งใช้งานใน Android
    • API ระดับ 23 ขึ้นไปของ Android
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 10.0 ขึ้นไป
    • โดยปกติแล้ว SDK ของ Meta Audience Network เวอร์ชันล่าสุดจะต้องใช้ Xcode เวอร์ชันล่าสุด
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย 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 สำหรับแอป

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI ไว้ คุณจะติดตั้งปลั๊กอินสื่อกลางของ Google Mobile Ads Meta Audience Network สำหรับ Unity ในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จาก ไดเรกทอรีรากของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > Package Manager เพื่อเปิด การตั้งค่า Unity Package Manager

ในแท็บรีจิสทรีที่กำหนดขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตโดยใช้รายละเอียดต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > ตัวจัดการแพ็กเกจเพื่อเปิด ตัวจัดการแพ็กเกจ Unity แล้ว เลือกรีจิสทรีของฉันจากเมนูแบบเลื่อนลง

รีจิสทรีของ Unity

เลือกแพ็กเกจ Google Mobile Ads MetaAudienceNetwork Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google บนอุปกรณ์เคลื่อนที่เวอร์ชันล่าสุดสำหรับ Meta Audience Network จากลิงก์ดาวน์โหลดใน บันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage จากไฟล์ ZIP

ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือกชิ้นงาน > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนำเข้า

นำเข้าจาก Unity

จากนั้นเลือกAssets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ปัญหาทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับให้ปิด

ขั้นตอนที่ 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: ทดสอบการติดตั้งใช้งาน

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

โปรดตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน 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

บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง Unity ของ Meta Audience Network

เวอร์ชัน 3.17.1

เวอร์ชัน 3.17.0

เวอร์ชัน 3.16.0

เวอร์ชัน 3.15.0

เวอร์ชัน 3.14.0

เวอร์ชัน 3.13.1

เวอร์ชัน 3.13.0

เวอร์ชัน 3.12.2

เวอร์ชัน 3.12.1

เวอร์ชัน 3.12.0

เวอร์ชัน 3.11.0

เวอร์ชัน 3.10.0

เวอร์ชัน 3.9.1

เวอร์ชัน 3.9.0

เวอร์ชัน 3.8.0

เวอร์ชัน 3.7.0

เวอร์ชัน 3.6.1

เวอร์ชัน 3.6.0

เวอร์ชัน 3.5.0

เวอร์ชัน 3.4.0

เวอร์ชัน 3.3.2

เวอร์ชัน 3.3.1

เวอร์ชัน 3.3.0

เวอร์ชัน 3.2.0

เวอร์ชัน 3.1.0

เวอร์ชัน 3.0.0

เวอร์ชัน 2.12.0

เวอร์ชัน 2.11.1

เวอร์ชัน 2.11.0

เวอร์ชัน 2.10.0

เวอร์ชัน 2.9.2

เวอร์ชัน 2.9.1

เวอร์ชัน 2.9.0

เวอร์ชัน 2.8.1

เวอร์ชัน 2.8.0

เวอร์ชัน 2.7.1 (เลิกใช้งานแล้ว โปรดใช้เวอร์ชัน 2.8.0 ขึ้นไป)

เวอร์ชัน 2.7.0 (เลิกใช้งานแล้ว ให้ใช้ 2.8.0 หรือใหม่กว่า)

เวอร์ชัน 2.6.1 (เลิกใช้งานแล้ว ใช้ 2.8.0 หรือใหม่กว่า)

เวอร์ชัน 2.6.0

เวอร์ชัน 2.5.1

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.5.0.0
  • รองรับอแดปเตอร์ Facebook iOS เวอร์ชัน 5.5.1.0

เวอร์ชัน 2.5.0

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.5.0.0
  • รองรับอแดปเตอร์ Facebook iOS เวอร์ชัน 5.5.0.0

เวอร์ชัน 2.4.1

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.4.1.1
  • รองรับอแดปเตอร์ Facebook iOS เวอร์ชัน 5.4.0.0

เวอร์ชัน 2.4.0

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.4.0.0
  • รองรับอแดปเตอร์ Facebook iOS เวอร์ชัน 5.4.0.0

เวอร์ชัน 2.3.2

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.3.1.2
  • รองรับ Facebook iOS Adapter เวอร์ชัน 5.3.2.0

เวอร์ชัน 2.3.1

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.3.1.0
  • รองรับ Facebook iOS Adapter เวอร์ชัน 5.3.2.0

เวอร์ชัน 2.3.0

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.3.0.0
  • รองรับ Facebook iOS Adapter เวอร์ชัน 5.3.0.0

เวอร์ชัน 2.2.0

  • อัปเดตปลั๊กอินให้รองรับ Rewarded API ใหม่ในเวอร์ชันเบต้าแบบเปิด
  • รองรับ Facebook Android Adapter เวอร์ชัน 5.2.0.1
  • รองรับอแดปเตอร์ Facebook iOS เวอร์ชัน 5.2.0.1

เวอร์ชัน 2.1.1

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.1.0.1
  • รองรับอแดปเตอร์ Facebook iOS เวอร์ชัน 5.1.0.0

เวอร์ชัน 2.1.0

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.1.0.0
  • รองรับอแดปเตอร์ Facebook iOS เวอร์ชัน 5.1.0.0

เวอร์ชัน 2.0.0

  • รองรับ Facebook Android Adapter เวอร์ชัน 5.0.1.0
  • รองรับ Facebook iOS Adapter เวอร์ชัน 5.0.1.0

เวอร์ชัน 1.2.1

  • รองรับ Facebook Android Adapter เวอร์ชัน 4.99.3.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 4.99.3.0

เวอร์ชัน 1.2.0

  • รองรับ Facebook Android Adapter เวอร์ชัน 4.99.1.1
  • รองรับ Facebook iOS Adapter เวอร์ชัน 4.99.2.0

เวอร์ชัน 1.1.3

  • รองรับ Facebook Android Adapter เวอร์ชัน 4.28.2.1
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 4.28.1.2

เวอร์ชัน 1.1.2

  • แก้ไขข้อขัดแย้งที่อาจเกิดขึ้นกับปลั๊กอินสื่อกลาง Unity ของ Unity Ads

เวอร์ชัน 1.1.1

  • รองรับ Facebook Android Adapter เวอร์ชัน 4.28.2.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 4.28.1.1

เวอร์ชัน 1.1.0

  • รองรับ Facebook Android SDK เวอร์ชัน 4.28.1
  • รองรับ Facebook iOS SDK เวอร์ชัน 4.28.1

เวอร์ชัน 1.0.0

  • เปิดตัวครั้งแรก
  • รองรับ Facebook Android SDK เวอร์ชัน 4.27.0
  • รองรับ Facebook iOS SDK เวอร์ชัน 4.27.1