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

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

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

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

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

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

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

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

  • Google Mobile Ads SDK for React Native เวอร์ชันล่าสุด
  • เฟรมเวิร์ก React Native เวอร์ชัน 0.85.0 ขึ้นไป
  • วิธีติดตั้งใช้งานใน Android
    • Android API ระดับ 24 ขึ้นไป
  • วิธีติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 15.0 ขึ้นไป
    • SDK ของ Meta Audience Network เวอร์ชันล่าสุดมักต้องใช้ Xcode เวอร์ชันล่าสุด
  • โปรเจ็กต์ React Native ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK for React Native ดูรายละเอียดได้ที่ตั้งค่า Google Mobile Ads SDK for React Native
    • ตรวจสอบว่าคุณได้ดาวน์โหลดและแตกโฟลเดอร์ adapters จากโฟลเดอร์ gma-sdk-react-native แล้ว หากไม่มีโฟลเดอร์ adapters ให้ทำตามขั้นตอนที่ 1, 2 และ 3 ในหัวข้อติดตั้ง Google Mobile Ads SDK for React Native
  • ตั้งค่าสื่อกลาง AdMob

ขั้นตอนที่ 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

ในไดเรกทอรีรากของโปรเจ็กต์ ให้ติดตั้งGoogle Mobile Ads SDK for React Native อะแดปเตอร์สื่อกลางสำหรับ Meta Audience Network ดำเนินการต่อไปนี้ให้เสร็จสมบูรณ์

  1. คัดลอกไฟล์ tar ของอะแดปเตอร์ Google Mobile Ads SDK for React Native จากไดเรกทอรี gma-sdk-react-native/adapters/meta/ ไปยังไดเรกทอรี local_packages/ ของโปรเจ็กต์ หากไม่มีโฟลเดอร์ adapters โปรดดูข้อกำหนดเบื้องต้น

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/meta/gma-mediation-meta-0.1.0.tgz local_packages/

    แทนที่ EXTRACT_DIR ด้วยเส้นทางไปยังไดเรกทอรีที่คุณแตกไฟล์เก็บถาวร

  2. ติดตั้งแพ็กเกจอะแดปเตอร์โดยใช้เครื่องมือจัดการแพ็กเกจที่ต้องการ ดังนี้

    npm

    npm install ./local_packages/gma-mediation-meta-0.1.0.tgz

    ไหมพรม

    yarn add ./local_packages/gma-mediation-meta-0.1.0.tgz

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

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

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

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

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

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

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

เวอร์ชัน 0.1.0

  • การเผยแพร่ครั้งแรก