คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจากเครือข่ายกลุ่มเป้าหมายของ Meta โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมการเสนอราคา ซึ่งจะอธิบายวิธีเพิ่ม Meta Audience Network ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ของ Meta Audience Network เข้ากับแอป Android
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสําหรับ Meta Audience Network มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
Waterfall 1 | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
เนทีฟ |
1 Meta Audience Network ได้เปลี่ยนไปใช้การเสนอราคาเท่านั้นในปี 2021
ข้อกำหนด
Google Mobile Ads SDK เวอร์ชันล่าสุด
สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน
- Android API ระดับ 21 ขึ้นไป
- อะแดปเตอร์ Meta Audience Network 5.10.0.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของเครือข่ายกลุ่มเป้าหมายของ Meta
ลงชื่อสมัครใช้และเข้าสู่ระบบหน้าเริ่มต้นของ Business Manager
คลิกเริ่มต้นใช้งาน แล้วคลิกสร้างบัญชีใหม่
กรอกรายละเอียดธุรกิจในช่องที่ต้องกรอก แล้วคลิกถัดไป
สร้างพร็อพเพอร์ตี้
หลังจากกรอกข้อมูลที่จำเป็นแล้ว ระบบจะแจ้งให้คุณสร้างพร็อพเพอร์ตี้สําหรับแอป ป้อนชื่อพร็อพเพอร์ตี้ที่ต้องการสําหรับแอป แล้วคลิกถัดไป
ถัดไป ให้เลือกแพลตฟอร์มที่จะสร้างรายได้
เพิ่มรายละเอียดแอป แล้วคลิกถัดไป
ตั้งค่าบัญชีการชําระเงินโดยคลิกเพิ่มบัญชีการชําระเงินใหม่ ระบบจะเปลี่ยนเส้นทางคุณไปยังหน้าใหม่เพื่อป้อนข้อมูลการชำระเงิน กรอกรายละเอียดที่จําเป็น แล้วคลิกถัดไป
เลือก Google AdMob เป็นแพลตฟอร์มสื่อกลาง แล้วคลิกสร้างตําแหน่งโฆษณา
เลือกรูปแบบ กรอกแบบฟอร์ม แล้วคลิกสร้าง
จดรหัสตําแหน่งโฆษณาไว้
คลิกเสร็จสิ้น
เปิดโหมดทดสอบ
ดูวิธีการโดยละเอียดในการเปิดใช้โฆษณาทดสอบของ Meta Audience Network ได้ที่คู่มือการทดสอบการติดตั้งใช้งาน Audience Network
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของเครือข่าย Audience ของ Meta ใน UI ของ Ad Manager
ลงชื่อเข้าใช้บัญชี Ad Manager
เปิดใช้การแชร์สัญญาณที่ปลอดภัย
ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก
กำหนดค่าการเสนอราคาตามข้อมูลเมตา
Ad Manager 360
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกผู้เสนอราคารายใหม่ในแท็บการเสนอราคา SDK
เลือก Meta เป็นผู้เสนอราคา
สลับเพิ่มคลังสัญญาณของผู้เสนอราคารายนี้ลงในรายการสัญญาณที่อนุญาตและอนุญาตให้แชร์สัญญาณกับผู้เสนอราคารายนี้ จากนั้นคลิกดำเนินการต่อ
คลิกต่อไป
คลิกเสร็จสิ้น
Ad Manager
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกผู้เสนอราคารายใหม่ในแท็บการเสนอราคา SDK
เลือก Meta เป็นผู้เสนอราคา
คลิกเริ่มใช้งานทางออนไลน์เลย จากนั้นคลิกใช่ ฉันยอมรับในกล่องโต้ตอบเพื่อเปลี่ยนเส้นทางไปยังเว็บไซต์ของ Facebook เพื่อเริ่มขั้นตอนการเริ่มต้นใช้งาน
ลงชื่อเข้าใช้ด้วยบัญชี Business Manager
เลือกธุรกิจ
หลังจากเลือกธุรกิจแล้ว กล่องโต้ตอบต่อไปนี้จะปรากฏขึ้น คลิกกลับ
สลับเพิ่มคลังสัญญาณของผู้เสนอราคารายนี้ลงในรายการสัญญาณที่อนุญาตและอนุญาตให้แชร์สัญญาณกับผู้เสนอราคารายนี้ จากนั้นคลิกดำเนินการต่อ
คลิกต่อไป
คลิกเสร็จสิ้น
กำหนดค่าการแมปหน่วยโฆษณา
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วเลือกบริษัทสําหรับ Meta ในแท็บการเสนอราคา SDK
ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่
เลือกหน่วยโฆษณาที่เจาะจง เลือกหน่วยโฆษณาและรูปแบบ แอปบนอุปกรณ์เคลื่อนที่เป็นประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อนรหัสตําแหน่งที่ได้ในส่วนก่อนหน้า สุดท้าย ให้คลิกบันทึก
เพิ่ม Meta ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนในการตั้งค่า GDPR และการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม Meta ลงในรายการพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ Meta Audience Network
การผสานรวม Android Studio (แนะนำ)
ในไฟล์ build.gradle.kts
ระดับแอป ให้เพิ่มข้อกําหนดในการนําไปใช้และการกำหนดค่าต่อไปนี้ ใช้ SDK และอะแดปเตอร์เครือข่ายกลุ่มเป้าหมายของ Meta เวอร์ชันล่าสุด
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:facebook:6.18.0.0")
}
การผสานรวมด้วยตนเอง
ดาวน์โหลด Meta Audience Network SDK สําหรับ Android เวอร์ชันล่าสุด แตกไฟล์
AudienceNetwork.aar
ในโฟลเดอร์AudienceNetwork/bin
แล้วเพิ่มลงในโปรเจ็กต์ไปที่อาร์ติแฟกต์ของอะแดปเตอร์ Meta Audience Network ที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์
.aar
ของ Meta AdAudience Network Adapter แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน Meta Audience Network SDK
ความยินยอมของผู้ใช้ EU และ GDPR
ภายใต้นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างแก่ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) และต้องได้รับความยินยอมจากผู้ใช้เกี่ยวกับการใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่อาจรวบรวม รับ หรือใช้ข้อมูลส่วนตัว และให้ข้อมูลเกี่ยวกับการใช้ของแต่ละเครือข่าย ปัจจุบัน Google ไม่สามารถส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ทำตามคำแนะนำในเอกสารประกอบของ Meta สำหรับ GDPR และการโฆษณาของ Meta
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกากำหนดให้ผู้ใช้มีสิทธิ์เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัดสําหรับการแสดงโฆษณาของ Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางได้ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่อาจมีส่วนร่วมในการขายข้อมูลส่วนบุคคล และทำตามคำแนะนำจากเครือข่ายแต่ละเครือข่ายเพื่อให้เป็นไปตามข้อกําหนด
ทําตามคําแนะนําในเอกสารประกอบของ Meta เกี่ยวกับตัวเลือกการประมวลผลข้อมูลสําหรับผู้ใช้ในแคลิฟอร์เนีย
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Meta Audience Network
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสําหรับ Ad Manager และเปิดใช้โหมดทดสอบใน UI ของ Meta Audience Network แล้ว
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Meta Audience Network ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Meta Audience Network (การเสนอราคา)
ขั้นตอนที่ไม่บังคับ
โฆษณาเนทีฟ
ชิ้นงานโฆษณาเนทีฟของ Meta Audience Network บางรายการไม่ได้แมปกับชิ้นงานโฆษณาเนทีฟของ Google แบบ 1:1 ระบบจะส่งชิ้นงานดังกล่าวกลับไปยังผู้เผยแพร่โฆษณาเป็นกลุ่มผ่านเมธอด getExtras()
ใน NativeAd
อะแดปเตอร์รองรับการส่งชิ้นงานต่อไปนี้
พารามิเตอร์และค่าคำขอ | |
---|---|
FacebookMediationAdapter.KEY_ID
|
สตริง รหัสที่ไม่ซ้ำกันของโฆษณาเนทีฟ |
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET
|
สตริง บริบททางสังคมของโฆษณา |
ตัวอย่างโค้ดที่แสดงวิธีดึงข้อมูลชิ้นงานเหล่านี้มีดังนี้
ตัวอย่าง
Java
Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
// ...
}
Kotlin
val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
// ...
}
การใช้โฆษณาเนทีฟของ Meta Audience Network ที่ไม่มี MediaView
รูปแบบโฆษณาเนทีฟของ Meta Audience Network กำหนดให้ต้องแสดงผลชิ้นงาน
MediaView
หากคุณวางแผนที่จะแสดงโฆษณาเนทีฟโดยไม่มีชิ้นงานดังกล่าว โปรดใช้รูปแบบโฆษณาแบนเนอร์เนทีฟของ Meta Audience Network
หากต้องการใช้โฆษณาแบนเนอร์เนทีฟของ Meta Audience Network แทน คุณต้องเลือกรูปแบบ Native Banner
เมื่อตั้งค่า Meta Audience Network และอะแดปเตอร์จะโหลดรูปแบบโฆษณาเนทีฟที่เกี่ยวข้องโดยอัตโนมัติ
การแสดงโฆษณา
อะแดปเตอร์เครือข่ายกลุ่มเป้าหมายจะแสดงโฆษณาเนทีฟเป็น
NativeAd
ออบเจ็กต์ โดยจะป้อนข้อมูลในช่องต่อไปนี้สำหรับNativeAd
ช่อง | ป้อนข้อมูลโดยอะแดปเตอร์ Meta Audience Network |
---|---|
บรรทัดแรก | |
รูปภาพ | 1 |
เนื้อความ | |
ไอคอนแอป | |
คำกระตุ้นการตัดสินใจ | |
ชื่อผู้ลงโฆษณา | |
การให้ดาว | |
ร้านค้า | |
ราคา |
1 ตัวแปลงโฆษณา Meta Audience Network ไม่ได้ให้สิทธิ์เข้าถึงชิ้นงานรูปภาพหลักโดยตรงสําหรับโฆษณาเนทีฟ แต่อะแดปเตอร์จะป้อนข้อมูลใน MediaView
ด้วยวิดีโอหรือรูปภาพแทน
การติดตามการแสดงผลและการคลิก
ตารางต่อไปนี้ไฮไลต์เวลาที่ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google บันทึกการแสดงผลและการคลิกโฆษณาเนทีฟ
การบันทึกการแสดงผล | คลิกการบันทึก |
---|---|
ชิ้นงานโฆษณาเนทีฟขนาด 1 พิกเซลของ Meta Audience Network บนหน้าจอ + ข้อกําหนดการแสดงผลชิ้นงาน | การเรียกกลับ Meta Audience Network SDK |
Meta Audience Network มีข้อกําหนดเฉพาะในการแสดงผลชิ้นงานเพื่อให้ระบบถือว่าการแสดงผลนั้นถูกต้อง โดยขึ้นอยู่กับว่าคุณเลือกรูปแบบเนทีฟหรือแบนเนอร์เนทีฟเมื่อตั้งค่า Meta Audience Network หรือไม่
รูปแบบเนทีฟของ Meta Audience Network | ชิ้นงานที่จําเป็น | คลาสการแสดงผลที่จำเป็น |
---|---|---|
เนทีฟ | มุมมองสื่อ |
MediaView
|
แบนเนอร์เนทีฟ | ไอคอนแอป |
ImageView
|
การแคชใน Android 9
ตั้งแต่ Android 9 (API ระดับ 28) เป็นต้นไป ระบบจะปิดใช้การรองรับข้อความธรรมดาโดยค่าเริ่มต้น ซึ่งจะส่งผลต่อฟังก์ชันการแคชสื่อของ SDK เครือข่ายกลุ่มเป้าหมายของ Meta และอาจส่งผลต่อประสบการณ์ของผู้ใช้และรายได้จากโฆษณา ทำตามเอกสารประกอบของ Meta เพื่ออัปเดตการกำหนดค่าความปลอดภัยของเครือข่ายในแอป
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจากเครือข่าย Audience คุณสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo.getAdapterResponses()
ในส่วนคลาสต่อไปนี้
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกับข้อผิดพลาดที่เกิดจากอะแดปเตอร์เครือข่ายกลุ่มเป้าหมายเมื่อโหลดโฆษณาไม่สําเร็จ
รหัสข้อผิดพลาด | เหตุผล |
---|---|
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 |
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Android ของ Meta Audience Network
เวอร์ชัน 6.18.0.0
- ยืนยันความเข้ากันได้กับ Meta Audience Network SDK เวอร์ชัน 6.18.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.3.0
- Meta Audience Network SDK เวอร์ชัน 6.18.0
เวอร์ชัน 6.17.0.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 23.0.0
- ยืนยันความเข้ากันได้กับ Meta Audience Network SDK เวอร์ชัน 6.17.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 23.0.0
- Meta Audience Network SDK เวอร์ชัน 6.17.0
เวอร์ชัน 6.16.0.0
- อัปเดตอะแดปเตอร์ให้เรียก MediationInterstitialAdCallback#onAdFailedToShow() เมื่อ Meta SDK รายงานว่าการแสดงโฆษณาคั่นระหว่างหน้าไม่สําเร็จ
- ยืนยันความเข้ากันได้กับ Meta Audience Network SDK เวอร์ชัน 6.16.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.3.0
- Meta Audience Network SDK เวอร์ชัน 6.16.0
เวอร์ชัน 6.15.0.0
- ยืนยันความเข้ากันได้กับ Meta Audience Network SDK เวอร์ชัน 6.15.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 22.2.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.2.0
- Meta Audience Network SDK เวอร์ชัน 6.15.0
เวอร์ชัน 6.14.0.0
- ยืนยันความเข้ากันได้กับ Meta Audience Network SDK เวอร์ชัน 6.14.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.0.0
- Meta Audience Network SDK เวอร์ชัน 6.14.0
เวอร์ชัน 6.13.7.1
- อัปเดตอะแดปเตอร์ให้ใช้คลาส
VersionInfo
ใหม่ - อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 22.0.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 22.0.0
- Meta Audience Network SDK เวอร์ชัน 6.13.7
เวอร์ชัน 6.13.7.0
- ยืนยันความเข้ากันได้กับ Meta Audience Network SDK เวอร์ชัน 6.13.7
- อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 21.5.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 21.5.0
- Meta Audience Network SDK เวอร์ชัน 6.13.7
เวอร์ชัน 6.12.0.0
- ยืนยันความเข้ากันได้กับ Meta Audience Network SDK เวอร์ชัน 6.12.0
- อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 21.2.0
- เปลี่ยนชื่อแบรนด์อะแดปเตอร์เป็น "Meta Audience Network"
- นําการผสานรวม Waterfall ออก
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 21.2.0
- Meta Audience Network SDK เวอร์ชัน 6.12.0
เวอร์ชัน 6.11.0.1
- อัปเดต
compileSdkVersion
และtargetSdkVersion
เป็น API 31 แล้ว - อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 21.0.0
- อัปเดตระดับ API ขั้นต่ำของ Android เป็น 19
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 21.0.0
- Facebook SDK เวอร์ชัน 6.11.0
เวอร์ชัน 6.11.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.11.0
- เพิ่มข้อความเตือนเกี่ยวกับการเลิกใช้งานสื่อกลางตามลำดับขั้น ดูข้อมูลเพิ่มเติมได้ที่บล็อกของ Meta
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.6.0
- Facebook SDK เวอร์ชัน 6.11.0
เวอร์ชัน 6.10.0.0
- เข้ากันได้กับ Facebook SDK เวอร์ชัน 6.10.0 ที่ได้รับการยืนยันแล้ว
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.6.0
- Facebook SDK เวอร์ชัน 6.10.0
เวอร์ชัน 6.8.0.1
- เพิ่มการรองรับการส่งต่อการเรียกกลับการคลิกและการแสดงผลในโฆษณาสำหรับการเสนอราคา
- เพิ่มการรองรับการส่งต่อการเรียกคืน
onAdFailedToShow()
เมื่อโฆษณาคั่นระหว่างหน้าซึ่งใช้การเสนอราคาไม่แสดง - อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 20.6.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.6.0
- Facebook SDK เวอร์ชัน 6.8.0
เวอร์ชัน 6.8.0.0
- ใช้งานได้กับ Facebook SDK เวอร์ชัน 6.8.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 20.4.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.4.0
- Facebook SDK เวอร์ชัน 6.8.0
เวอร์ชัน 6.7.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.7.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.3.0
- Facebook SDK เวอร์ชัน 6.7.0
เวอร์ชัน 6.6.0.0
- ใช้งานร่วมกับ Facebook SDK เวอร์ชัน 6.6.0 ได้
- อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 20.3.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.3.0
- Facebook SDK เวอร์ชัน 6.6.0
เวอร์ชัน 6.5.1.1
- แก้ไขข้อบกพร่องที่เกิดขึ้นใน 6.5.1.0 ซึ่งระบบแสดงโฆษณาทดสอบแทนโฆษณาจริง
- อัปเดตอะแดปเตอร์ให้ใช้
AdError
API ใหม่
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.2.0
- Facebook SDK เวอร์ชัน 6.5.1
เวอร์ชัน 6.5.1.0 (เลิกใช้งานแล้ว)
- เราตรวจพบและยืนยันปัญหาเกี่ยวกับเวอร์ชัน 6.5.1.0 แล้ว เราขอแนะนำให้อัปเกรดเป็นเวอร์ชัน 6.5.1.1
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.5.1
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 20.2.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.2.0
- Facebook SDK เวอร์ชัน 6.5.1
เวอร์ชัน 6.5.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.5.0
- แก้ไขปัญหาที่โฆษณาเนทีฟไม่มีภาพหน้าปกของ Facebook
- อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 20.1.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.1.0
- Facebook SDK เวอร์ชัน 6.5.0
เวอร์ชัน 6.4.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.4.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 20.0.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 20.0.0
- Facebook SDK เวอร์ชัน 6.4.0
เวอร์ชัน 6.3.0.1
- แก้ไขปัญหาที่ระบบแสดง
ClassCastException
เมื่อแสดงผลโฆษณาเนทีฟในแอปที่ไม่ได้ใช้ImageView
เพื่อแสดงผลชิ้นงานรูปภาพ
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.7.0
- Facebook SDK เวอร์ชัน 6.3.0
เวอร์ชัน 6.3.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.3.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.7.0
- Facebook SDK เวอร์ชัน 6.3.0
เวอร์ชัน 6.2.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.2.1
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.7.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.7.0
- Facebook SDK เวอร์ชัน 6.2.1
เวอร์ชัน 6.2.0.1
- นำการรองรับรูปแบบ
NativeAppInstallAd
ที่เลิกใช้งานแล้วออก แอปควรขอโฆษณาเนทีฟแบบรวม - อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.6.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.6.0
- Facebook SDK เวอร์ชัน 6.2.0
เวอร์ชัน 6.2.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.2.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.5.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.5.0
- Facebook SDK เวอร์ชัน 6.2.0
เวอร์ชัน 6.1.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.1.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.4.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.4.0
- Facebook SDK เวอร์ชัน 6.1.0
เวอร์ชัน 6.0.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 6.0.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.3.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.3.0
- Facebook SDK เวอร์ชัน 6.0.0
เวอร์ชัน 5.11.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.11.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.2.0
- Facebook SDK เวอร์ชัน 5.11.0
เวอร์ชัน 5.10.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.10.1
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.2.0
- Facebook SDK เวอร์ชัน 5.10.1
เวอร์ชัน 5.10.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.10.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.2.0
- Facebook SDK เวอร์ชัน 5.10.0
เวอร์ชัน 5.9.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.9.1
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.2.0
- Facebook SDK เวอร์ชัน 5.9.1
เวอร์ชัน 5.9.0.2
- เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
- อัปเดตอะแดปเตอร์ให้รองรับคําขอแบนเนอร์แบบปรับขนาดได้แบบแทรกในบรรทัด
- แก้ไขปัญหาที่โฆษณาแบนเนอร์สำหรับการเสนอราคาแสดงผลแบบเต็มความกว้างเสมอ
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.2.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.2.0
- Facebook SDK เวอร์ชัน 5.9.0
เวอร์ชัน 5.9.0.1
- ตอนนี้อะแดปเตอร์จะส่งต่อข้อผิดพลาดหาก FAN SDK พบข้อผิดพลาดขณะแสดงโฆษณาคั่นระหว่างหน้า/โฆษณาที่มีการให้รางวัล
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- Facebook SDK เวอร์ชัน 5.9.0
เวอร์ชัน 5.9.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.9.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- Facebook SDK เวอร์ชัน 5.9.0
เวอร์ชัน 5.8.0.2
- แก้ไขการอ้างอิงตัวแปรที่ไม่ถูกต้องซึ่งทําให้ระบบขัดข้องในบางสถานการณ์เมื่อโหลดโฆษณาเนทีฟ
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- Facebook SDK เวอร์ชัน 5.8.0
เวอร์ชัน 5.8.0.1
- เพิ่มรหัสข้อผิดพลาดที่สื่อความหมายและเหตุผลเพิ่มเติมสำหรับการโหลด/แสดงอะแดปเตอร์ไม่สำเร็จ
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.1.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- Facebook SDK เวอร์ชัน 5.8.0
เวอร์ชัน 5.8.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.8.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.0.1
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 19.0.1
- Facebook SDK เวอร์ชัน 5.8.0
เวอร์ชัน 5.7.1.1
- เพิ่มการรองรับข้อผิดพลาดเกี่ยวกับอะแดปเตอร์ของ Facebook Audience Network
- เพิ่มรหัสข้อผิดพลาดที่สื่อความหมายและสาเหตุของการโหลด/แสดงอะแดปเตอร์ไม่สำเร็จ
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- Facebook SDK เวอร์ชัน 5.7.1
เวอร์ชัน 5.7.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.7.1
- เพิ่มการรองรับโฆษณาแบนเนอร์เนทีฟของ Facebook เมื่อใช้การเสนอราคา
- ตอนนี้โฆษณาเนทีฟใช้ "Drawable" สำหรับชิ้นงานไอคอน
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- Facebook SDK เวอร์ชัน 5.7.1
เวอร์ชัน 5.7.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.7.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- Facebook SDK เวอร์ชัน 5.7.0
เวอร์ชัน 5.6.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.6.1
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 18.3.0
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- Facebook SDK เวอร์ชัน 5.6.1
เวอร์ชัน 5.6.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.6.0
- อัปเดตอะแดปเตอร์ Facebook เพื่อใช้
AdChoicesView
สร้างขึ้นและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 18.2.0
- Facebook SDK เวอร์ชัน 5.6.0
เวอร์ชัน 5.5.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.5.0
เวอร์ชัน 5.4.1.1
- แก้ไขปัญหาที่ทำให้แอปขัดข้องเมื่อนำโฆษณาเนทีฟออก
เวอร์ชัน 5.4.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.4.1
- เพิ่มการรองรับโฆษณาแบนเนอร์เนทีฟของ Facebook สําหรับสื่อกลางตามลำดับขั้น
- ใช้
setNativeBanner()
จากคลาสFacebookExtras
เพื่อขอโฆษณาแบนเนอร์เนทีฟ
- ใช้
- แก้ไขปัญหาที่ทำให้คําขอโฆษณาแบนเนอร์อัจฉริยะไม่สําเร็จ
- แก้ไขปัญหาที่โฆษณาวิดีโอที่มีการให้รางวัลไม่ส่งต่อเหตุการณ์
onAdClosed()
ในบางกรณีที่แอปทำงานอยู่เบื้องหลังขณะที่วิดีโอเล่นอยู่ - ย้ายข้อมูลอะแดปเตอร์ไปยัง
AndroidX
แล้ว - อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 18.1.1
เวอร์ชัน 5.4.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.4.0
เวอร์ชัน 5.3.1.2
- แก้ไขข้อบกพร่องที่การเสนอราคาของ Facebook เริ่มต้นไม่สําเร็จเนื่องจาก "ไม่พบรหัสตําแหน่ง"
เวอร์ชัน 5.3.1.1
- อัปเดตการติดตามการแสดงโฆษณา RTB ที่เป็นโฆษณาเนทีฟ
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 17.2.1
เวอร์ชัน 5.3.1.0
- เพิ่มความสามารถในการเสนอราคาลงในอะแดปเตอร์สําหรับโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.3.1
เวอร์ชัน 5.3.0.0
- อัปเดตชื่อบริการสื่อกลางสําหรับ Google Mobile Ads
- เพิ่มเวอร์ชันอะแดปเตอร์ลงในคอลเริ่มต้น
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.3.0
เวอร์ชัน 5.2.0.2
- เพิ่มการรองรับขนาดโฆษณาแบนเนอร์ที่ยืดหยุ่น
เวอร์ชัน 5.2.0.1
- อัปเดตอะแดปเตอร์เพื่อรองรับ Rewarded API เวอร์ชันเบต้าแบบเปิดใหม่
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 17.2.0
เวอร์ชัน 5.2.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.2.0
เวอร์ชัน 5.1.1.1
- อัปเดตอะแดปเตอร์เพื่อป้อนข้อมูลชื่อผู้ลงโฆษณาสําหรับโฆษณาเนทีฟแบบรวม
เวอร์ชัน 5.1.1.0
- แทนที่มุมมองตัวเลือกโฆษณาด้วยมุมมองตัวเลือกโฆษณา
- ใช้งานร่วมกับ Facebook SDK เวอร์ชัน 5.1.1 ได้
เวอร์ชัน 5.1.0.1
- แก้ไขปัญหา ANR ที่เกิดจาก "getGMSVersionCode()"
เวอร์ชัน 5.1.0.0
- เริ่มต้นใช้งาน Facebook SDK สําหรับโฆษณาแต่ละรูปแบบ
เวอร์ชัน 5.0.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.0.1
เวอร์ชัน 5.0.0.1
- อัปเดตอะแดปเตอร์เพื่อสร้างออบเจ็กต์โฆษณาที่มีการให้รางวัล ณ เวลาที่มีคำขอโฆษณา
เวอร์ชัน 5.0.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 5.0.0
เวอร์ชัน 4.99.3.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.99.3
เวอร์ชัน 4.99.1.1
- แก้ไขข้อบกพร่องที่ไอคอนตัวเลือกโฆษณาอื่นๆ ไม่แสดงสําหรับโฆษณาเนทีฟแบบรวม
- แก้ไขข้อบกพร่องที่ทำให้อะแดปเตอร์แสดงข้อยกเว้นเมื่อพยายามดาวน์โหลดรูปภาพ
เวอร์ชัน 4.99.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.99.1
เวอร์ชัน 4.28.2.1
- อัปเดตอะแดปเตอร์เพื่อเรียกเหตุการณ์โฆษณา
onRewardedVideoComplete()
เวอร์ชัน 4.28.2.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.28.2
เวอร์ชัน 4.28.1.1
- แก้ไขปัญหาที่ระบบไม่บันทึกการคลิกสําหรับโฆษณาเนทีฟแบบรวม
เวอร์ชัน 4.28.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.28.1
เวอร์ชัน 4.28.0.0
- ใช้งานร่วมกับ Facebook SDK เวอร์ชัน 4.28.0 ได้
เวอร์ชัน 4.27.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.27.1
เวอร์ชัน 4.27.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.27.0
เวอร์ชัน 4.26.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.26.1
- อัปเดตโปรเจ็กต์อะแดปเตอร์สำหรับ Android Studio 3.0
เวอร์ชัน 4.26.0.0
- เพิ่มการรองรับโฆษณาวิดีโอที่มีการให้รางวัล
- เพิ่มการรองรับโฆษณาวิดีโอเนทีฟ
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.26.0
เวอร์ชัน 4.25.0.0
- แก้ไขปัญหาที่ระบบแสดงผลแบนเนอร์ที่มีขนาดไม่ถูกต้อง
- อัปเดตการติดตามการดูของอะแดปเตอร์สําหรับโฆษณาเนทีฟเพื่อบันทึกการดูชิ้นงานแต่ละรายการกับ Facebook SDK แทนการดูโฆษณาทั้งชิ้น ซึ่งหมายความว่าการคลิกพื้นหลัง (หรือ "ช่องว่าง") ของโฆษณาเนทีฟจะไม่ส่งผลให้เกิดการคลิกผ่านอีกต่อไป
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.25.0
เวอร์ชัน 4.24.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.24.0
เวอร์ชัน 4.23.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.23.0
เวอร์ชัน 4.22.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.22.1
เวอร์ชัน 4.22.0.0
- อัปเดตอะแดปเตอร์ให้ใช้งานร่วมกับ Facebook SDK เวอร์ชัน 4.22.0 ได้
เวอร์ชัน 4.21.1.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.21.1
เวอร์ชัน 4.21.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.21.0
เวอร์ชัน 4.20.0.0
- อัปเดตระดับ API ขั้นต่ำที่รองรับของ Android เป็น 14 ขึ้นไป
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.20.0
เวอร์ชัน 4.19.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.19.0
เวอร์ชัน 4.18.0.0
- ยืนยันความเข้ากันได้กับ Facebook SDK เวอร์ชัน 4.18.0
เวอร์ชัน 4.17.0.0
- เพิ่มการรองรับโฆษณาเนทีฟ
เวอร์ชัน 4.15.0.0
- เปลี่ยนระบบการตั้งชื่อเวอร์ชันเป็น [FAN SDK version].[adapter patch version]
- อัปเดต FAN SDK ขั้นต่ำที่จำเป็นเป็นเวอร์ชัน 4.15.0
- อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น v9.2.0
- แก้ไขข้อบกพร่องที่ระบบส่งต่อการเรียกกลับการคลิกของ Facebook สําหรับโฆษณาคั่นระหว่างหน้าอย่างไม่ถูกต้อง
- ตอนนี้อะแดปเตอร์จะส่งต่อ onAdLeftApplication เมื่อมีการคลิกโฆษณาด้วย
เวอร์ชัน 1.2.0
- แก้ไขข้อบกพร่องที่ทำให้ AdSize.SMART_BANNER เป็นขนาดที่ถูกต้อง
เวอร์ชัน 1.1.0
- เพิ่มการรองรับรูปแบบแบบเต็มความกว้าง x 250 เมื่อคำขอสำหรับ AdSize.MEDIUM_RECTANGLE
เวอร์ชัน 1.0.1
- เพิ่มการรองรับ AdSize.SMART_BANNER
เวอร์ชัน 1.0.0
- รุ่นแรก