Hướng dẫn này trình bày cách sử dụng SDK quảng cáo trên thiết bị di động của Google để tải và hiển thị quảng cáo từ Mạng quảng cáo của Meta bằng cách sử dụng tính năng dàn xếp, bao gồm cả việc tích hợp tính năng đặt giá thầu. Hướng dẫn này trình bày cách thêm Meta Audience Network vào cấu hình dàn xếp của một đơn vị quảng cáo, cũng như cách tích hợp SDK và bộ chuyển đổi Meta Audience Network vào một ứng dụng Android.
Các định dạng quảng cáo và công cụ tích hợp được hỗ trợ
Bộ chuyển đổi dàn xếp cho Meta Audience Network có những chức năng sau:
Tích hợp | |
---|---|
Đặt giá thầu | |
Thác nước 1 | |
Định dạng | |
Biểu ngữ | |
Quảng cáo xen kẽ | |
Được thưởng | |
Quảng cáo xen kẽ có tặng thưởng | |
Mã gốc |
1 Meta Audience Network đã chuyển sang chỉ đặt giá thầu vào năm 2021.
Yêu cầu
SDK Quảng cáo của Google trên thiết bị di động mới nhất
Xem hết Hướng dẫn bắt đầu sử dụng tính năng dàn xếp
- API Android cấp 24 trở lên
- Bộ chuyển đổi Meta Audience Network 5.10.0.0 trở lên (nên dùng phiên bản mới nhất)
Bước 1: Thiết lập cấu hình trong giao diện người dùng của Mạng đối tượng của Meta
Đăng ký và đăng nhập vào trang Bắt đầu của Business Manager.
Nhấp vào Bắt đầu rồi nhấp vào Tạo tài khoản mới.
Điền thông tin chi tiết về doanh nghiệp của bạn vào các trường bắt buộc rồi nhấp vào Tiếp theo.
Tạo tài sản
Sau khi điền thông tin bắt buộc, bạn sẽ được nhắc tạo một tài sản cho ứng dụng của mình. Hãy nhập tên tài sản mong muốn cho ứng dụng của bạn rồi nhấp vào Tiếp theo.
Tiếp theo, hãy chọn nền tảng mà bạn muốn kiếm tiền.
Thêm thông tin chi tiết về ứng dụng rồi nhấp vào Tiếp theo.

Thiết lập tài khoản thanh toán bằng cách nhấp vào Thêm tài khoản thanh toán mới. Bạn sẽ được chuyển hướng đến một trang mới để nhập thông tin thanh toán. Điền thông tin cần thiết, rồi nhấp vào Tiếp theo.
Chọn Google AdMob làm Nền tảng dàn xếp, rồi nhấp vào Tạo vị trí.
Chọn một định dạng, điền thông tin vào biểu mẫu rồi nhấp vào Tạo.
Ghi lại Mã vị trí.
Nhấp vào Xong.
Cập nhật tệp app-ads.txt
Người bán được uỷ quyền cho ứng dụng app-ads.txt là một sáng kiến của IAB Tech Lab giúp đảm bảo rằng khoảng không quảng cáo trong ứng dụng của bạn chỉ được bán thông qua những kênh mà bạn đã xác định là được uỷ quyền. Để tránh mất nhiều doanh thu từ quảng cáo, bạn cần phải triển khai tệp app-ads.txt
.
Nếu chưa làm, hãy tạo tệp app-ads.txt cho Ad Manager.
Để triển khai app-ads.txt
cho Mạng quảng cáo của Meta, hãy xem phần Xác định người bán được uỷ quyền bằng tệp app-ads.txt.
Bật chế độ thử nghiệm
Hãy xem Hướng dẫn kiểm thử việc triển khai Mạng đối tượng để biết hướng dẫn chi tiết về cách bật quảng cáo thử nghiệm trên Mạng đối tượng của Meta.
Bước 2: Thiết lập nhu cầu của Mạng đối tượng của Meta trong giao diện người dùng Ad Manager
Đăng nhập vào tài khoản Ad Manager.
Bật tính năng chia sẻ tín hiệu an toàn
Chuyển đến mục Quản trị > Cài đặt chung. Chuyển đến thẻ Chế độ cài đặt tài khoản Ad Exchange, sau đó xem xét và bật chế độ Chia sẻ tín hiệu an toàn. Nhấp vào Lưu.
Chia sẻ tín hiệu an toàn trong yêu cầu giá thầu
Chuyển đến mục Khoảng không quảng cáo > Tín hiệu an toàn. Trong phần Tín hiệu bảo mật, hãy tìm Facebook rồi bật chế độ Cho phép tích hợp ứng dụng.
Nhấp vào Lưu.
Cho phép chia sẻ tín hiệu an toàn cho tính năng Đặt giá thầu qua SDK
Chuyển đến phần Phân phối > Cài đặt kênh nhu cầu. Trong thẻ Chế độ cài đặt mặc định, hãy bật chế độ Cho phép chia sẻ tín hiệu an toàn cho Đặt giá thầu SDK.
Nhấp vào Lưu.
Định cấu hình chiến lược đặt giá thầu của Meta
Chuyển đến mục Phân phối > Bên đặt giá thầu, rồi nhấp vào Chuyển đến tính năng Đặt giá thầu qua SDK.
Nhấp vào Người đặt giá thầu mới.
Chọn Meta làm bên đặt giá thầu.
Nhấp vào Tiếp tục để bật tính năng Đặt giá thầu qua SDK cho bên đặt giá thầu này.
Nhấp vào Xong.
Định cấu hình mối liên kết đơn vị quảng cáo
Chuyển đến mục Phân phối > Bên đặt giá thầu, rồi nhấp vào Chuyển đến tính năng Đặt giá thầu qua SDK.
Chọn công ty cho Meta Audience Network.
Chuyển đến thẻ Liên kết đơn vị quảng cáo rồi nhấp vào Liên kết đơn vị quảng cáo mới.
Chọn Đơn vị quảng cáo cụ thể. Chọn một đơn vị quảng cáo và định dạng, Ứng dụng di động làm Loại khoảng không quảng cáo và Ứng dụng di động của bạn. Sau đó, hãy nhập Mã vị trí mà bạn đã nhận được ở phần trước.
Nếu bạn đang định cấu hình mối liên kết đơn vị quảng cáo cho một quảng cáo xen kẽ có tặng thưởng trong giao diện người dùng Ad Manager, hãy chọn định dạng Có tặng thưởng và sử dụng mã vị trí quảng cáo xen kẽ có tặng thưởng.
Cuối cùng, hãy nhấp vào Lưu.
Thêm Meta vào danh sách đối tác quảng cáo theo GDPR và quy định của tiểu bang tại Hoa Kỳ
Làm theo các bước trong phần Chế độ cài đặt theo quy định của Châu Âu và Chế độ cài đặt theo quy định của các tiểu bang tại Hoa Kỳ để thêm Meta vào danh sách đối tác quảng cáo theo quy định của Châu Âu và các tiểu bang tại Hoa Kỳ trong giao diện người dùng Ad Manager.
Bước 3: Nhập SDK và bộ chuyển đổi Meta Audience Network
Tích hợp Android Studio (nên dùng)
Trong tệp build.gradle.kts
ở cấp ứng dụng, hãy thêm các cấu hình và phần phụ thuộc triển khai sau đây. Sử dụng phiên bản mới nhất của SDK và bộ chuyển đổi Mạng quảng cáo của Meta:
dependencies {
implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.18.0-beta01")
implementation("com.google.ads.mediation:facebook:6.20.0.0")
}
configurations {
all {
exclude(group = "com.google.android.gms", module = "play-services-ads")
exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}
}
Tích hợp thủ công
Tải phiên bản mới nhất của SDK Meta Audience Network cho Android. Trích xuất
AudienceNetwork.aar
trong thư mụcAudienceNetwork/bin
rồi thêm vào dự án của bạn.Chuyển đến các cấu phần phần mềm của bộ chuyển đổi Meta Audience Network trên Kho lưu trữ Maven của Google. Chọn phiên bản mới nhất, tải tệp
.aar
của bộ chuyển đổi Mạng quảng cáo của Meta xuống rồi thêm tệp đó vào dự án của bạn.
Bước 4: Triển khai chế độ cài đặt quyền riêng tư trên Meta Audience Network SDK
Sự đồng ý của người dùng ở Liên minh Châu Âu và GDPR
Theo Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu của Google, bạn phải đảm bảo rằng người dùng ở Khu vực kinh tế Châu Âu (EEA) nhận được một số thông tin công bố nhất định và đồng ý về việc sử dụng mã nhận dạng thiết bị và dữ liệu cá nhân. Chính sách này thể hiện các yêu cầu của Chỉ thị về quyền riêng tư và truyền thông điện tử của Liên minh Châu Âu và Quy định chung về việc bảo vệ dữ liệu (GDPR). Khi yêu cầu sự đồng ý, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp có thể thu thập, nhận hoặc sử dụng dữ liệu cá nhân và cung cấp thông tin về việc sử dụng của từng mạng. Hiện tại, Google không thể tự động chuyển lựa chọn đồng ý của người dùng cho các mạng như vậy.
Meta chưa đăng ký trong Danh sách nhà cung cấp toàn cầu (GVL) của IAB Châu Âu. Thay vào đó, bạn phải sử dụng chỉ dẫn kỹ thuật về Sự đồng ý bổ sung. Để biết thêm thông tin chi tiết, hãy xem Các thành phần của Sự đồng ý bổ sung. Quy cách về sự đồng ý bổ sung hoạt động cùng với Khuôn khổ về tính minh bạch và sự đồng ý (TCF) phiên bản 2 của IAB Châu Âu. Quy cách này cho phép bạn, cùng với Nền tảng quản lý sự đồng ý (CMP) và các đối tác của họ, thu thập và truyền tín hiệu đồng ý bổ sung cho những công ty có tên trong danh sách Nhà cung cấp công nghệ quảng cáo (ATP) của Google nhưng chưa có tên trong Danh sách nhà cung cấp toàn cầu (GVL) của IAB Châu Âu.
Làm theo hướng dẫn trong tài liệu của Meta về GDPR và quảng cáo của Meta.
Luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ
Luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ yêu cầu bạn phải cung cấp cho người dùng quyền từ chối việc "bán" "thông tin cá nhân" của họ (theo định nghĩa của các thuật ngữ này trong luật), trong đó quyền từ chối được cung cấp thông qua một đường liên kết nổi bật "Không bán thông tin cá nhân của tôi" trên trang chủ của bên "bán". Hướng dẫn tuân thủ luật về quyền riêng tư của các tiểu bang tại Hoa Kỳ cho phép bạn bật chế độ xử lý dữ liệu bị hạn chế cho hoạt động phân phát quảng cáo của Google, nhưng Google không thể áp dụng chế độ cài đặt này cho từng mạng quảng cáo trong chuỗi dàn xếp của bạn. Do đó, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp có thể tham gia vào việc bán thông tin cá nhân và làm theo hướng dẫn của từng mạng đó để đảm bảo tuân thủ.
Làm theo hướng dẫn trong tài liệu của Meta về các lựa chọn xử lý dữ liệu cho người dùng ở California.
Bước 5: Thêm mã bắt buộc
Bạn không cần phải có mã bổ sung để tích hợp Meta Audience Network.
Bước 6: Kiểm thử việc triển khai
Bật quảng cáo thử nghiệm
Đảm bảo rằng bạn đăng ký thiết bị thử nghiệm cho Ad Manager và bật chế độ thử nghiệm trong giao diện người dùng Mạng đối tượng của Meta.
Xác minh quảng cáo thử nghiệm
Để xác minh rằng bạn đang nhận được quảng cáo thử nghiệm từ Meta Audience Network, hãy bật tính năng thử nghiệm một nguồn quảng cáo trong công cụ kiểm tra quảng cáo bằng (các) nguồn quảng cáo Meta Audience Network(Đặt giá thầu).
Các bước không bắt buộc
Quảng cáo gốc
Một số thành phần quảng cáo gốc của Mạng đối tượng Meta không liên kết trực tiếp với các thành phần quảng cáo gốc của Google. Những thành phần như vậy được chuyển lại cho nhà xuất bản trong một gói thông qua phương thức getExtras()
trong NativeAd
.
Bộ chuyển đổi hỗ trợ truyền các thành phần sau:
Tham số và giá trị yêu cầu | |
---|---|
FacebookMediationAdapter.KEY_ID
|
Chuỗi. Mã nhận dạng duy nhất của quảng cáo gốc |
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET
|
Chuỗi. Bối cảnh xã hội của quảng cáo |
Dưới đây là ví dụ về mã cho thấy cách trích xuất các thành phần này:
Ví dụ:
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)
// ...
}
Sử dụng quảng cáo gốc của Meta Audience Network mà không có MediaView
Định dạng quảng cáo gốc của Mạng đối tượng Meta yêu cầu hiển thị thành phần MediaView
. Nếu bạn dự định hiển thị quảng cáo gốc mà không có thành phần đó, hãy nhớ sử dụng định dạng quảng cáo biểu ngữ gốc của Mạng lưới đối tượng của Meta.
Để sử dụng quảng cáo biểu ngữ gốc của Meta Audience Network, bạn phải chọn định dạng Native Banner
khi thiết lập Meta Audience Network và bộ chuyển đổi sẽ tự động tải định dạng quảng cáo gốc tương ứng.
Hiển thị quảng cáo
Bộ chuyển đổi Mạng quảng cáo của Facebook trả về quảng cáo gốc dưới dạng các đối tượng NativeAd
. Thao tác này sẽ điền sẵn các trường sau đây cho NativeAd
.
Trường | Được điền sẵn bằng bộ chuyển đổi Meta Audience Network |
---|---|
Dòng tiêu đề | |
Hình ảnh | 1 |
Nội dung | |
Biểu tượng ứng dụng | |
Lời kêu gọi hành động | |
Tên nhà quảng cáo | |
Điểm xếp hạng theo sao | |
Cửa hàng | |
Giá |
1 Bộ chuyển đổi Mạng đối tượng Meta không cung cấp quyền truy cập trực tiếp vào thành phần hình ảnh chính cho quảng cáo gốc. Thay vào đó, bộ chuyển đổi sẽ điền sẵn MediaView
bằng một video hoặc hình ảnh.
Theo dõi lượt hiển thị và lượt nhấp
Bảng sau đây nêu bật thời điểm SDK quảng cáo trên thiết bị di động của Google ghi lại lượt hiển thị và lượt nhấp vào quảng cáo gốc.
Ghi lại lượt hiển thị | Ghi lại lượt nhấp |
---|---|
1 px của thành phần quảng cáo gốc Meta Audience Network trên màn hình + các yêu cầu về việc hiển thị thành phần | Lệnh gọi lại SDK của Meta Audience Network |
Meta Audience Network có các yêu cầu cụ thể về việc hiển thị thành phần để một lượt hiển thị được coi là hợp lệ, tuỳ thuộc vào việc bạn đã chọn định dạng Gốc hay Biểu ngữ gốc khi thiết lập Meta Audience Network.
Định dạng gốc của Meta Audience Network | Thành phần bắt buộc | Lớp kết xuất bắt buộc |
---|---|---|
Mã gốc | Nội dung nghe nhìn |
MediaView
|
Biểu ngữ gốc | Biểu tượng ứng dụng |
ImageView
|
Lưu vào bộ nhớ đệm trên Android 9
Kể từ Android 9 (API cấp 28), tính năng hỗ trợ văn bản thô sẽ bị tắt theo mặc định, điều này sẽ ảnh hưởng đến chức năng lưu vào bộ nhớ đệm của nội dung nghe nhìn trong SDK Mạng quảng cáo của Meta và có thể ảnh hưởng đến trải nghiệm người dùng cũng như doanh thu từ quảng cáo. Hãy làm theo tài liệu của Meta để cập nhật cấu hình bảo mật mạng trong ứng dụng của bạn.
Mã lỗi
Nếu bộ chuyển đổi không nhận được quảng cáo từ Mạng đối tượng, bạn có thể kiểm tra lỗi cơ bản trong phản hồi quảng cáo bằng cách sử dụng ResponseInfo.getAdSourceResponses()
trong các lớp sau:
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
Dưới đây là các mã và thông báo đi kèm do bộ chuyển đổi Mạng quảng cáo của Facebook gửi khi quảng cáo không tải được:
Mã lỗi | Lý do |
---|---|
101 | Tham số máy chủ không hợp lệ (ví dụ: thiếu Mã vị trí). |
102 | Kích thước quảng cáo được yêu cầu không khớp với kích thước biểu ngữ được Meta Audience Network hỗ trợ. |
103 | Nhà xuất bản phải yêu cầu quảng cáo có ngữ cảnh Activity . |
104 | Không khởi chạy được Meta Audience Network SDK. |
105 | Nhà xuất bản không yêu cầu Quảng cáo gốc hợp nhất. |
106 | Quảng cáo gốc đã tải là một đối tượng khác với đối tượng dự kiến. |
107 | Đối tượng Context được dùng không hợp lệ. |
108 | Quảng cáo đã tải thiếu các thành phần quảng cáo gốc bắt buộc. |
109 | Không tạo được quảng cáo gốc từ tải trọng giá thầu. |
110 | Meta Audience Network SDK không trình bày được quảng cáo xen kẽ/quảng cáo có tặng thưởng. |
111 | Ngoại lệ được đưa ra khi tạo một đối tượng AdView Meta Audience Network. |
1000-9999 | Meta Audience Network đã trả về một lỗi dành riêng cho SDK. Hãy xem tài liệu của Mạng đối tượng của Meta để biết thêm thông tin chi tiết. |
Nhật ký thay đổi của bộ chuyển đổi dàn xếp Android Meta Audience Network
Phiên bản 6.20.0.0
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.20.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 24.2.0.
- Meta Audience Network SDK phiên bản 6.20.0.
Phiên bản 6.19.0.1
- Cập nhật cấp độ API Android tối thiểu bắt buộc lên 23.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 24.0.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 24.0.0.
- Meta Audience Network SDK phiên bản 6.19.0.
Phiên bản 6.19.0.0
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.19.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 23.6.0.
- Meta Audience Network SDK phiên bản 6.19.0.
Phiên bản 6.18.0.0
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.18.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 23.3.0.
- Meta Audience Network SDK phiên bản 6.18.0.
Phiên bản 6.17.0.0
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 23.0.0.
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.17.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 23.0.0.
- Meta Audience Network SDK phiên bản 6.17.0.
Phiên bản 6.16.0.0
- Đã cập nhật bộ điều hợp để gọi MediationInterstitialAdCallback#onAdFailedToShow() khi Meta SDK báo cáo rằng không hiển thị được quảng cáo xen kẽ.
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.16.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 22.3.0.
- Meta Audience Network SDK phiên bản 6.16.0.
Phiên bản 6.15.0.0
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.15.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 22.2.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 22.2.0.
- Meta Audience Network SDK phiên bản 6.15.0.
Phiên bản 6.14.0.0
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.14.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 22.0.0.
- Meta Audience Network SDK phiên bản 6.14.0.
Phiên bản 6.13.7.1
- Đã cập nhật trình điều hợp để sử dụng lớp
VersionInfo
mới. - Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 22.0.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 22.0.0.
- Meta Audience Network SDK phiên bản 6.13.7.
Phiên bản 6.13.7.0
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.13.7.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 21.5.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 21.5.0.
- Meta Audience Network SDK phiên bản 6.13.7.
Phiên bản 6.12.0.0
- Đã xác minh khả năng tương thích với Meta Audience Network SDK phiên bản 6.12.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 21.2.0.
- Đổi tên bộ chuyển đổi thành "Meta Audience Network".
- Đã xoá chế độ tích hợp dạng thác nước.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 21.2.0.
- Meta Audience Network SDK phiên bản 6.12.0.
Phiên bản 6.11.0.1
- Cập nhật
compileSdkVersion
vàtargetSdkVersion
lên API 31. - Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 21.0.0.
- Cập nhật cấp độ API Android tối thiểu bắt buộc lên 19.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 21.0.0.
- Facebook SDK phiên bản 6.11.0.
Phiên bản 6.11.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.11.0.
- Đã thêm thông báo cảnh báo về việc ngừng sử dụng tính năng dàn xếp kiểu thác nước. Hãy xem blog của Meta để biết thêm thông tin.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.6.0.
- Facebook SDK phiên bản 6.11.0.
Phiên bản 6.10.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.10.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.6.0.
- Facebook SDK phiên bản 6.10.0.
Phiên bản 6.8.0.1
- Thêm tính năng hỗ trợ chuyển tiếp lệnh gọi lại lượt nhấp và lượt hiển thị trong quảng cáo đặt giá thầu.
- Thêm tính năng hỗ trợ chuyển lệnh gọi lại
onAdFailedToShow()
khi quảng cáo đặt giá thầu xen kẽ không hiển thị được. - Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 20.6.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.6.0.
- Facebook SDK phiên bản 6.8.0.
Phiên bản 6.8.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.8.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 20.4.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.4.0.
- Facebook SDK phiên bản 6.8.0.
Phiên bản 6.7.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.7.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.3.0.
- Facebook SDK phiên bản 6.7.0.
Phiên bản 6.6.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.6.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 20.3.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.3.0.
- Facebook SDK phiên bản 6.6.0.
Phiên bản 6.5.1.1
- Đã khắc phục một lỗi xuất hiện trong phiên bản 6.5.1.0, trong đó quảng cáo thử nghiệm được trả về thay vì quảng cáo thực.
- Đã cập nhật bộ chuyển đổi để sử dụng API
AdError
mới.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.2.0.
- Facebook SDK phiên bản 6.5.1.
Phiên bản 6.5.1.0 (Không dùng nữa)
- Chúng tôi đã phát hiện và xác nhận có vấn đề với phiên bản 6.5.1.0. Bạn nên nâng cấp lên phiên bản 6.5.1.1.
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.5.1.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 20.2.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.2.0.
- Facebook SDK phiên bản 6.5.1.
Phiên bản 6.5.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.5.0.
- Khắc phục vấn đề quảng cáo gốc không có ảnh bìa của Facebook.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 20.1.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.1.0.
- Facebook SDK phiên bản 6.5.0.
Phiên bản 6.4.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.4.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 20.0.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.0.0.
- Facebook SDK phiên bản 6.4.0.
Phiên bản 6.3.0.1
- Đã khắc phục vấn đề xảy ra khi một
ClassCastException
được gửi đi khi hiển thị quảng cáo gốc trên các ứng dụng không sử dụngImageView
để hiển thị thành phần hình ảnh.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.7.0.
- Facebook SDK phiên bản 6.3.0.
Phiên bản 6.3.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.3.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.7.0.
- Facebook SDK phiên bản 6.3.0.
Phiên bản 6.2.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.2.1.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 19.7.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.7.0.
- Facebook SDK phiên bản 6.2.1.
Phiên bản 6.2.0.1
- Xoá tính năng hỗ trợ cho định dạng
NativeAppInstallAd
không còn dùng nữa. Các ứng dụng nên yêu cầu quảng cáo gốc hợp nhất. - Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 19.6.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.6.0.
- Facebook SDK phiên bản 6.2.0.
Phiên bản 6.2.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.2.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 19.5.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.5.0.
- Facebook SDK phiên bản 6.2.0.
Phiên bản 6.1.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.1.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 19.4.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.4.0.
- Facebook SDK phiên bản 6.1.0.
Phiên bản 6.0.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 6.0.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 19.3.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.3.0.
- Facebook SDK phiên bản 6.0.0.
Phiên bản 5.11.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.11.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.2.0.
- Facebook SDK phiên bản 5.11.0.
Phiên bản 5.10.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.10.1.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.2.0.
- Facebook SDK phiên bản 5.10.1.
Phiên bản 5.10.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.10.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.2.0.
- Facebook SDK phiên bản 5.10.0.
Phiên bản 5.9.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.9.1.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.2.0.
- Facebook SDK phiên bản 5.9.1.
Phiên bản 5.9.0.2
- Đã thêm lựa chọn hỗ trợ cho quảng cáo xen kẽ có tặng thưởng.
- Cập nhật bộ chuyển đổi để hỗ trợ các yêu cầu về biểu ngữ thích ứng nội tuyến.
- Khắc phục một vấn đề khiến quảng cáo biểu ngữ đặt giá thầu luôn hiển thị ở chế độ toàn chiều rộng.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 19.2.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.2.0.
- Facebook SDK phiên bản 5.9.0.
Phiên bản 5.9.0.1
- Giờ đây, bộ chuyển đổi sẽ chuyển tiếp lỗi nếu FAN SDK gặp lỗi trong khi hiển thị quảng cáo xen kẽ/quảng cáo có tặng thưởng.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.1.0.
- Facebook SDK phiên bản 5.9.0.
Phiên bản 5.9.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.9.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.1.0.
- Facebook SDK phiên bản 5.9.0.
Phiên bản 5.8.0.2
- Đã khắc phục lỗi tham chiếu biến không chính xác gây ra sự cố trong một số trường hợp khi tải quảng cáo gốc.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.1.0.
- Facebook SDK phiên bản 5.8.0.
Phiên bản 5.8.0.1
- Thêm các mã lỗi và lý do mô tả khác cho lỗi tải/hiển thị bộ chuyển đổi.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 19.1.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.1.0.
- Facebook SDK phiên bản 5.8.0.
Phiên bản 5.8.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.8.0.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 19.0.1.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 19.0.1.
- Facebook SDK phiên bản 5.8.0.
Phiên bản 5.7.1.1
- Thêm tính năng hỗ trợ cho các lỗi của bộ chuyển đổi Mạng đối tượng của Facebook.
- Thêm mã lỗi và lý do mô tả cho các lỗi tải/hiển thị bộ chuyển đổi.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 18.3.0.
- Facebook SDK phiên bản 5.7.1.
Phiên bản 5.7.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.7.1.
- Đã thêm tính năng hỗ trợ cho quảng cáo biểu ngữ gốc của Facebook khi sử dụng tính năng đặt giá thầu.
- Quảng cáo gốc hiện sử dụng "Drawable" cho thành phần biểu tượng.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 18.3.0.
- Facebook SDK phiên bản 5.7.1.
Phiên bản 5.7.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.7.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 18.3.0.
- Facebook SDK phiên bản 5.7.0.
Phiên bản 5.6.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.6.1.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 18.3.0.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 18.3.0.
- Facebook SDK phiên bản 5.6.1.
Phiên bản 5.6.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.6.0.
- Đã cập nhật Trình điều hợp Facebook để sử dụng
AdChoicesView
.
Được tạo và thử nghiệm với:
- SDK Quảng cáo của Google trên thiết bị di động phiên bản 18.2.0.
- Facebook SDK phiên bản 5.6.0.
Phiên bản 5.5.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.5.0.
Phiên bản 5.4.1.1
- Khắc phục một vấn đề gây ra sự cố khi Quảng cáo gốc bị xoá.
Phiên bản 5.4.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.4.1.
- Đã thêm chế độ hỗ trợ cho Quảng cáo biểu ngữ gốc của Facebook để dàn xếp kiểu thác nước.
- Sử dụng
setNativeBanner()
từ lớpFacebookExtras
để yêu cầu Quảng cáo biểu ngữ gốc.
- Sử dụng
- Khắc phục một vấn đề khiến các yêu cầu Quảng cáo biểu ngữ thông minh không thành công.
- Khắc phục vấn đề Quảng cáo dạng video có tặng thưởng không chuyển tiếp sự kiện
onAdClosed()
trong một số trường hợp ứng dụng chạy ở chế độ nền trong khi video đang phát. - Đã di chuyển đầu nối sang
AndroidX
. - Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 18.1.1.
Phiên bản 5.4.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.4.0.
Phiên bản 5.3.1.2
- Đã khắc phục lỗi không khởi động được hoạt động đặt giá thầu trên Facebook do "Không tìm thấy mã vị trí".
Phiên bản 5.3.1.1
- Đã cập nhật tính năng theo dõi lượt hiển thị của quảng cáo RTB gốc.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 17.2.1.
Phiên bản 5.3.1.0
- Đã thêm khả năng đặt giá thầu vào bộ điều hợp cho quảng cáo biểu ngữ, quảng cáo xen kẽ, quảng cáo có tặng thưởng và quảng cáo gốc.
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.3.1.
Phiên bản 5.3.0.0
- Đã cập nhật tên dịch vụ dàn xếp cho Quảng cáo trên thiết bị di động của Google.
- Thêm phiên bản bộ chuyển đổi vào lệnh gọi khởi động.
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.3.0.
Phiên bản 5.2.0.2
- Đã thêm chế độ hỗ trợ cho các kích thước quảng cáo biểu ngữ linh hoạt.
Phiên bản 5.2.0.1
- Đã cập nhật bộ chuyển đổi để hỗ trợ API Quảng cáo có tặng thưởng mới ở giai đoạn thử nghiệm beta công khai.
- Cập nhật phiên bản tối thiểu bắt buộc của SDK Quảng cáo của Google trên thiết bị di động lên 17.2.0.
Phiên bản 5.2.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.2.0.
Phiên bản 5.1.1.1
- Cập nhật bộ chuyển đổi để điền Tên nhà quảng cáo cho Quảng cáo gốc hợp nhất.
Phiên bản 5.1.1.0
- Thay thế AdChoices View bằng AdOptions View.
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.1.1
Phiên bản 5.1.0.1
- Khắc phục vấn đề ANR do "getGMSVersionCode()" gây ra.
Phiên bản 5.1.0.0
- Khởi chạy Facebook SDK cho từng định dạng quảng cáo.
Phiên bản 5.0.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.0.1.
Phiên bản 5.0.0.1
- Cập nhật bộ chuyển đổi để tạo đối tượng quảng cáo có tặng thưởng tại thời điểm yêu cầu quảng cáo.
Phiên bản 5.0.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 5.0.0.
Phiên bản 4.99.3.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.99.3.
Phiên bản 4.99.1.1
- Đã khắc phục lỗi biểu tượng Lựa chọn quảng cáo không xuất hiện cho Quảng cáo gốc hợp nhất.
- Khắc phục lỗi khiến bộ chuyển đổi sẽ gửi một ngoại lệ khi cố gắng tải hình ảnh xuống.
Phiên bản 4.99.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.99.1.
Phiên bản 4.28.2.1
- Cập nhật bộ chuyển đổi để gọi sự kiện quảng cáo
onRewardedVideoComplete()
.
Phiên bản 4.28.2.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.28.2.
Phiên bản 4.28.1.1
- Khắc phục vấn đề không ghi nhận lượt nhấp cho Quảng cáo gốc hợp nhất.
Phiên bản 4.28.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.28.1.
Phiên bản 4.28.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.28.0.
Phiên bản 4.27.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.27.1.
Phiên bản 4.27.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.27.0.
Phiên bản 4.26.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.26.1.
- Cập nhật dự án Adapter cho Android Studio 3.0
Phiên bản 4.26.0.0
- Đã thêm lựa chọn hỗ trợ cho quảng cáo dạng video có tặng thưởng.
- Đã thêm chế độ hỗ trợ cho quảng cáo gốc dạng video.
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.26.0.
Phiên bản 4.25.0.0
- Khắc phục vấn đề trả về biểu ngữ có kích thước không chính xác.
- Cập nhật tính năng theo dõi lượt xem của bộ chuyển đổi cho quảng cáo gốc để đăng ký từng chế độ xem thành phần với SDK Facebook thay vì toàn bộ chế độ xem quảng cáo. Điều này có nghĩa là các lượt nhấp vào nền (hoặc "khoảng trắng") trên quảng cáo gốc sẽ không còn dẫn đến lượt nhấp qua nữa.
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.25.0.
Phiên bản 4.24.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.24.0.
Phiên bản 4.23.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.23.0.
Phiên bản 4.22.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.22.1.
Phiên bản 4.22.0.0
- Đã cập nhật bộ chuyển đổi để tương thích với Facebook SDK phiên bản 4.22.0.
Phiên bản 4.21.1.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.21.1.
Phiên bản 4.21.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.21.0.
Phiên bản 4.20.0.0
- Cập nhật cấp độ API Android tối thiểu được hỗ trợ lên 14+.
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.20.0.
Phiên bản 4.19.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.19.0.
Phiên bản 4.18.0.0
- Đã xác minh khả năng tương thích với Facebook SDK phiên bản 4.18.0.
Phiên bản 4.17.0.0
- Đã thêm tính năng hỗ trợ cho quảng cáo gốc.
Phiên bản 4.15.0.0
- Thay đổi hệ thống đặt tên phiên bản thành [Phiên bản SDK FAN].[phiên bản bản vá bộ chuyển đổi].
- Cập nhật SDK FAN tối thiểu bắt buộc lên phiên bản 4.15.0.
- Cập nhật SDK Quảng cáo của Google trên thiết bị di động tối thiểu bắt buộc lên phiên bản 9.2.0.
- Khắc phục lỗi trong đó các lệnh gọi lại lượt nhấp của Facebook cho quảng cáo xen kẽ không được chuyển tiếp đúng cách.
- Giờ đây, bộ điều hợp cũng chuyển tiếp onAdLeftApplication khi người dùng nhấp vào quảng cáo.
Phiên bản 1.2.0
- Đã sửa một lỗi để AdSize.SMART_BANNER hiện là một kích thước hợp lệ.
Phiên bản 1.1.0
- Thêm chế độ hỗ trợ cho định dạng chiều rộng đầy đủ x 250 khi yêu cầu là AdSize.MEDIUM_RECTANGLE
Phiên bản 1.0.1
- Thêm tính năng hỗ trợ cho AdSize.SMART_BANNER
Phiên bản 1.0.0
- Phát hành lần đầu