Tích hợp Meta Audience Network với tính năng đặt giá thầu

Chọn nền tảng: Android (bản thử nghiệm) Android iOS Unity Flutter

Hướng dẫn này trình bày cách sử dụng GMA Next-Gen SDK để tải và hiển thị quảng cáo từ Meta Audience Network bằng tính năng dàn xếp, bao gồm cả các hoạt động tích hợp đặt giá thầu. Tài liệu 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 của 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ó các chức năng sau:

¹ Meta Audience Network chỉ hỗ trợ đặt giá thầu từ năm 2021.
² Meta Audience Network không hỗ trợ biểu ngữ thích ứng cố định và biểu ngữ thích ứng cùng dòng.

Yêu cầu

• Mới nhất trên kênh GMA Next-Gen SDK.

• Xem hết Hướng dẫn bắt đầu sử dụng tính năng dàn xếp.

• Android API 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 Mạng quảng cáo 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 Ad Manager làm Nền tảng hoà giải, 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

Tệp Authorized Sellers for Apps 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 lưới đối tượng 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 của Mạng đối tượng Meta.

Bước 2: Thiết lập nhu cầu của Mạng quảng cáo 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 phần 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 các bang tại Hoa Kỳ

Hãy 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 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 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 của Meta Audience Network

Tích hợp Android Studio (nên dùng)

Trong tệp gradle ở 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:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    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 Meta Audience Network SDK cho Android. Trích xuất AudienceNetwork.aar trong thư mục AudienceNetwork/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

Để tuân thủ Chính sách của Google về sự đồng ý của người dùng ở Liên minh Châu Âu, bạn phải công bố một số thông tin nhất định cho người dùng ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh và Thuỵ Sĩ, đồng thời phải được họ đồng ý cho sử dụng cookie hoặc bộ nhớ cục bộ khác khi pháp luật yêu cầu, cũng như đối với việc thu thập, chia sẻ và sử dụng dữ liệu cá nhân để cá nhân hoá quảng cáo. 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). Bạn chịu trách nhiệm xác minh rằng sự đồng ý được truyền đến từng nguồn quảng cáo trong chuỗi dàn xếp của bạn. 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 quy cách 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 trên 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 bang tại 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 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ủ quy định.

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 quảng cáo 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 riêng 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:

Dưới đây là một ví dụ về mã cho thấy cách trích xuất các thành phần này:

Ví dụ:

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String 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 quảng cáo Meta.

Để sử dụng quảng cáo biểu ngữ gốc của Mạng quảng cáo của Meta, bạn phải chọn định dạng Native Banner khi thiết lập Mạng quảng cáo của Meta 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.

¹ 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 GMA Next-Gen SDK ghi lại số lượt hiển thị và lượt nhấp vào quảng cáo gốc.

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.

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 từ lượt 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 Audience Network gửi khi quảng cáo không tải được: