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

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

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

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

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

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

ข้อกำหนด

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

ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของเครือข่ายกลุ่มเป้าหมายของ Meta

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

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

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

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

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

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

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

Android

iOS

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

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

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

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

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

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

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

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

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

Android

โปรดดูวิธีการที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android

iOS

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

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

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

ขั้นตอนที่ 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 ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

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

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

รายละเอียด OpenUPM

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

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

เลือกแพ็กเกจสื่อกลางเครือข่ายกลุ่มเป้าหมาย Meta ของ Google Ads บนอุปกรณ์เคลื่อนที่ แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Ads สําหรับมือถือเวอร์ชันล่าสุดสําหรับเครือข่ายกลุ่มเป้าหมาย Meta จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage จากไฟล์ ZIP

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

นำเข้าจาก Unity

จากนั้นเลือกชิ้นงาน > เครื่องมือจัดการทรัพยากรภายนอก > เครื่องมือแก้ไขของ Android > บังคับแก้ไข ไลบรารีเครื่องมือจัดการทรัพยากร Dependency ภายนอกจะทำการแก้ไข Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับแก้ไข

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

ภายใต้นโยบายความยินยอมของผู้ใช้ 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: ทดสอบการใช้งาน

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

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

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

เวอร์ชัน 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 เวอร์ชัน 5.5.0.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 5.5.1.0

เวอร์ชัน 2.5.0

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 5.5.0.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 5.5.0.0

เวอร์ชัน 2.4.1

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

เวอร์ชัน 2.4.0

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 5.4.0.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 5.4.0.0

เวอร์ชัน 2.3.2

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 5.3.1.2
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 5.3.2.0

เวอร์ชัน 2.3.1

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 5.3.1.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 5.3.2.0

เวอร์ชัน 2.3.0

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 5.3.0.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 5.3.0.0

เวอร์ชัน 2.2.0

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

เวอร์ชัน 2.1.1

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

เวอร์ชัน 2.1.0

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 5.1.0.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 5.1.0.0

เวอร์ชัน 2.0.0

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 5.0.1.0
  • รองรับอะแดปเตอร์ Facebook iOS เวอร์ชัน 5.0.1.0

เวอร์ชัน 1.2.1

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

เวอร์ชัน 1.2.0

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 4.99.1.1
  • รองรับอะแดปเตอร์ iOS ของ Facebook เวอร์ชัน 4.99.2.0

เวอร์ชัน 1.1.3

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

เวอร์ชัน 1.1.2

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

เวอร์ชัน 1.1.1

  • รองรับอะแดปเตอร์ Facebook สำหรับ Android เวอร์ชัน 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