Tích hợp Mạng đối tượng Facebook với tính năng đặt giá thầu

Hướng dẫn này dành cho các nhà xuất bản muốn 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 đối tượng Facebook thông qua tính năng đặt giá thầu. Bài viết này hướng dẫn cách tích hợp SDK và bộ chuyển đổi Mạng đối tượng Facebook vào ứng dụng Unity.

Các định dạng quảng cáo và tích hợp được hỗ trợ

Bộ chuyển đổi dàn xếp AdMob cho Mạng đối tượng Facebook có các khả năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Định dạng
Biểu ngữ
Trung gian
Được thưởng
Quảng cáo xen kẽ có tặng thưởng

Yêu cầu

  • Unity 5.6 trở lên
  • SDK quảng cáo trên điện thoại di động mới nhất của Google
  • Plugin dàn xếp Quảng cáo trên thiết bị di động của Google dành cho Facebook 2.11.0 trở lên
  • Để triển khai trên Android
    • API Android cấp 16 trở lên
  • Để triển khai trên iOS
    • Mục tiêu triển khai iOS từ 10.0 trở lên
    • SDK Mạng đối tượng Facebook mới nhất thường yêu cầu phiên bản mới nhất của Xcode.
  • Một dự án Unity đang hoạt động được định cấu hình bằng SDK quảng cáo trên thiết bị di động của Google. Hãy xem phần Bắt đầu để biết chi tiết.

Bước 1: Thiết lập Mạng đối tượng Facebook

Đăng ký và Đăng nhập vào trang Bắt đầu Trình quản lý doanh nghiệp.

Nhấp vào Tạo tài khoản Người quản lý doanh nghiệp mới và đ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.

Tạo thuộc tính Facebook

Sau khi bạn đã điền thông tin cần thiết, bạn sẽ được nhắc tạo một thuộc tính cho ứng dụng của mình. Nhập tên mong muốn của thuộc tính cho ứng dụng và nhấp vào Chuyển đến Trình quản lý kiếm tiền.

Tiếp theo, hãy chọn nền tảng bạn muốn kiếm tiền.

Cho biết ứng dụng của bạn có đang hoạt động hay không và nhấp vào Gửi.

Android

iOS

Bạn sẽ được nhắc tạo vị trí đặt quảng cáo cho ứng dụng của mình. Chọn một định dạng, điền vào biểu mẫu rồi nhấp vào Tiếp theo.

Chọn Banner cho tất cả các kích thước biểu ngữ, bao gồm cả kích thước 300x250. Facebook không hỗ trợ định dạng hiển thị Medium Rectangle trong tính năng đặt giá thầu, nhưng hỗ trợ một biểu ngữ có chiều rộng linh hoạt với chiều cao 50, 90 hoặc 250 khi sử dụng định dạng hiển thị Banner.

Nếu bạn dự định tích hợp định dạng quảng cáo xen kẽ có tặng thưởng, định dạng Facebook tương ứng là Rewarded Video.

Bước tiếp theo trình bày thông tin tổng quan về vị trí bạn đã tạo. Hãy lưu ý Mã vị trí trong mục Thêm mã vị trí.

Bước 2: Định cấu hình chế độ cài đặt dàn xếp cho đơn vị quảng cáo AdMob

Bạn cần thêm Facebook vào cấu hình dàn xếp cho đơn vị quảng cáo. Trước tiên, hãy đăng nhập vào tài khoản AdMob của bạn.

Android

Chuyển đến thẻ Dàn xếp. Nếu bạn có một nhóm dàn xếp hiện có mà bạn muốn sửa đổi, hãy nhấp vào tên của nhóm dàn xếp đó để chỉnh sửa và bỏ qua để đến Thêm Mạng đối tượng Facebook làm nguồn quảng cáo.

Để tạo một nhóm dàn xếp mới, hãy chọn Tạo nhóm dàn xếp.

Nhập nền tảng và định dạng quảng cáo, sau đó nhấp vào Tiếp tục.

Đặt tên cho nhóm dàn xếp của bạn và chọn các vị trí để nhắm mục tiêu. Tiếp theo, hãy đặt trạng thái nhóm dàn xếp thành Đã bật. Sau đó, nhấp vào Thêm đơn vị quảng cáo. Thao tác này sẽ mở lớp phủ lựa chọn đơn vị quảng cáo.

Liên kết nhóm dàn xếp này với đơn vị quảng cáo AdMob hiện tại của bạn. Sau đó, hãy nhấp vào Xong. Bây giờ, bạn sẽ thấy thẻ đơn vị quảng cáo được điền bằng đơn vị quảng cáo bạn đã chọn.

Thêm Mạng đối tượng Facebook làm nguồn quảng cáo

Trong thẻ Nguồn quảng cáo, hãy chọn Thêm mạng quảng cáo. Chọn Mạng đối tượng Facebook (Đặt giá thầu). Nhập Mã vị trí nhận được trong phần trước rồi nhấp vào Xong.

Cuối cùng, nhấp vào Lưu.

iOS

Chuyển đến thẻ Dàn xếp. Nếu bạn có một nhóm dàn xếp hiện có mà bạn muốn sửa đổi, hãy nhấp vào tên của nhóm dàn xếp đó để chỉnh sửa và bỏ qua để đến Thêm Mạng đối tượng Facebook làm nguồn quảng cáo.

Để tạo một nhóm dàn xếp mới, hãy chọn Tạo nhóm dàn xếp.

Nhập nền tảng và định dạng quảng cáo, sau đó nhấp vào Tiếp tục.

Đặt tên cho nhóm dàn xếp của bạn và chọn các vị trí để nhắm mục tiêu. Tiếp theo, hãy đặt trạng thái nhóm dàn xếp thành Đã bật. Sau đó, nhấp vào Thêm đơn vị quảng cáo. Thao tác này sẽ mở lớp phủ lựa chọn đơn vị quảng cáo.

Liên kết nhóm dàn xếp này với đơn vị quảng cáo AdMob hiện tại của bạn. Sau đó, hãy nhấp vào Xong.

Bây giờ, bạn sẽ thấy thẻ đơn vị quảng cáo được điền bằng đơn vị quảng cáo bạn đã chọn.

Thêm Mạng đối tượng Facebook làm nguồn quảng cáo

Trong thẻ Nguồn quảng cáo, hãy chọn Thêm mạng quảng cáo. Chọn Mạng đối tượng Facebook (Đặt giá thầu). Nhập Mã vị trí nhận được trong phần trước rồi nhấp vào Xong.

Cuối cùng, nhấp vào Lưu.

Sử dụng quảng cáo có tặng thưởng

Trong tùy chọn cài đặt cho đơn vị quảng cáo có tặng thưởng, hãy cung cấp giá trị cho số tiền thưởng và loại phần thưởng. Sau đó, để đảm bảo bạn cung cấp cùng một phần thưởng cho người dùng bất kể mạng quảng cáo nào được phân phát, hãy chọn hộp Áp dụng cho tất cả mạng trong nhóm Dàn xếp.

Nếu bạn không áp dụng chế độ cài đặt này, bộ chuyển đổi Facebook sẽ mặc định áp dụng phần thưởng thuộc loại "" (chuỗi trống) có giá trị 1. SDK Facebook không cung cấp giá trị phần thưởng cụ thể cho quảng cáo có tặng thưởng.

Để biết thêm thông tin về cách đặt giá trị phần thưởng cho đơn vị quảng cáo AdMob, hãy xem bài viết Tạo đơn vị quảng cáo.

Bước 3: Nhập bộ chuyển đổi và SDK mạng đối tượng Facebook

Tải xuống phiên bản mới nhất của plugin dàn xếp Quảng cáo trên thiết bị di động của Google cho Facebook từ liên kết tải xuống trong Nhật ký thay đổi và trích xuất GoogleMobileAdsFacebookMediation.unitypackage từ tệp zip.

Trong trình chỉnh sửa dự án Unity, hãy chọn Tài sản và gt; Nhập gói > Gói tùy chỉnh và tìm tệp GoogleMobileAdsFacebookMediation.unitypackage bạn đã tải xuống. Hãy chắc chắn là bạn đã chọn tất cả các tệp và nhấp vào Nhập.

Sau đó, chọn Tài sản và gt; Trình phân giải dịch vụ của Play và gt; Trình phân giải Android > Buộc phân giải. Thư viện Trình phân giải dịch vụ của Google Play dành cho Unity sẽ giải quyết phần phụ thuộc từ đầu và sao chép các phần phụ thuộc đã khai báo vào thư mục Assets/Plugins/Android của ứng dụng Unity.

Bước 4: Phải có mã bổ sung

Android

Không cần thêm mã nào để tích hợp Facebook.

iOS

Tích hợp khung SKAdNetwork

Facebook yêu cầu bạn thêm các mã nhận dạng SKAdNetwork này vào tệp Info.plist của dự án:

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n38lu8286q.skadnetwork</string>
    </dict>
</array>

Đã bật theo dõi quảng cáo

Nếu bạn đang xây dựng cho iOS 14 trở lên, vui lòng xem hướng dẫn của Facebook về cách đặt Cờ theo dõi quảng cáo của họ.

Bước 5: Thử nghiệm việc triển khai

Xem hướng dẫn Triển khai mạng đối tượng thử nghiệm để biết hướng dẫn chi tiết về cách bật quảng cáo thử nghiệm trên Facebook. Sau đó, bạn có thể sử dụng Bộ thử nghiệm dàn xếp để xác minh xem cách triển khai của mình đã chính xác hay chưa.

Vậy là xong! Giờ đây, bạn có thể tích hợp dàn xếp với Mạng đối tượng của Facebook.

Các bước không bắt buộc

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 cung cấp một số thông tin công bố nhất định và sự đồng ý của người dùng ở Khu vực kinh tế Châu Âu (EEA) về việc sử dụng giá trị 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ề bảo vệ dữ liệu (GDPR). Khi lấy 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 mỗi 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 đó.

Vui lòng xem lại hướng dẫn của Facebook để biết thông tin về GDPR và quảng cáo trên Facebook.

Thêm Facebook vào danh sách đối tác quảng cáo theo Quy định chung về bảo vệ dữ liệu (GDPR)

Hãy làm theo các bước trong phần cài đặt theo GDPR để thêm Facebook vào danh sách đối tác quảng cáo theo Quy định chung về bảo vệ dữ liệu (GDPR) trong giao diện người dùng AdMob.

Đạo luật về quyền riêng tư của người tiêu dùng tại California (CCPA)

Google Hướng dẫn về quy trình chuẩn bị để tuân thủ CCPA cho phép bạn bật tính năng xử lý dữ liệu bị hạn chế để phân phát quảng cáo trên 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 bán thông tin cá nhân và làm theo hướng dẫn của từng mạng trong số đó để đảm bảo tuân thủ CCPA.

Đối với người dùng ở California, hãy xem lại các tùy chọn xử lý dữ liệu của Facebook.

Thêm Facebook vào danh sách đối tác quảng cáo CCPA

Làm theo các bước trong phần cài đặt CCPA để thêm Facebook vào danh sách đối tác quảng cáo CCPA trong giao diện người dùng AdMob.

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ Mạng đối tượng Facebook, nhà xuất bản có thể kiểm tra lỗi cơ bản từ phản hồi quảng cáo bằng cách sử dụng ResponseInfo trong các lớp sau:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Dưới đây là các mã và thông báo đi kèm do Bộ chuyển đổi mạng đối tượng Facebook gửi khi quảng cáo không tải được:

Android

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 Mạng đối tượng Facebook 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 thể khởi chạy SDK Mạng đối tượng Facebook.
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 đã sử dụng không hợp lệ.
108 Quảng cáo đã tải thiếu nội dung 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 SDK đối tượng Facebook không thể hiển thị quảng cáo xen kẽ/quảng cáo có tặng thưởng.
111 Trường hợp ngoại lệ được đưa ra khi tạo đối tượng AdView trên Mạng đối tượng Facebook.
1000-9999 Mạng đối tượng Facebook đã trả về một lỗi dành riêng cho SDK. Hãy xem tài liệu của Facebook để biết thêm chi tiết.

iOS

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 Mạng đối tượng Facebook hỗ trợ.
103 Không khởi chạy được đối tượng quảng cáo trên Mạng đối tượng Facebook.
104 SDK đối tượng Facebook không thể hiển thị quảng cáo xen kẽ/quảng cáo có tặng thưởng.
105 Bộ điều khiển chế độ xem gốc của quảng cáo biểu ngữ là nil.
106 Không thể khởi chạy SDK Mạng đối tượng Facebook.
1000-9999 Mạng đối tượng Facebook đã trả về một lỗi dành riêng cho SDK. Hãy xem tài liệu của Facebook để biết thêm chi tiết.

Nhật ký thay đổi plugin plugin dàn xếp Facebook

Phiên bản 3.7.0

Phiên bản 3.6.1

Phiên bản 3.6.0

Phiên bản 3.5.0

Phiên bản 3.4.0

Phiên bản 3.3.2

Phiên bản 3.3.1

Phiên bản 3.3.0

Phiên bản 3.2.0

Phiên bản 3.1.0

Phiên bản 3.0.0

Phiên bản 2.12.0

Phiên bản 2.11.1

Phiên bản 2.11.0

Phiên bản 2.10.0

Phiên bản 2.9.2

Phiên bản 2.9.1

Phiên bản 2.9.0

Phiên bản 2.8.1

Phiên bản 2.8.0

Phiên bản 2.7.1 (Không dùng nữa, sử dụng phiên bản 2.8.0 trở lên)

Phiên bản 2.7.0 (Không dùng nữa, sử dụng phiên bản 2.8.0 trở lên)

Phiên bản 2.6.1 (Không dùng nữa, sử dụng phiên bản 2.8.0 trở lên)

Phiên bản 2.6.0

Phiên bản 2.5.1

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.5.0.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.5.1.0.

Phiên bản 2.5.0

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.5.0.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.5.0.0.

Phiên bản 2.4.1

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.4.1.1.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.4.0.0.

Phiên bản 2.4.0

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.4.0.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.4.0.0.

Phiên bản 2.3.2

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.3.1.2.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.3.2.0.

Phiên bản 2.3.1

  • Hỗ trợ bộ điều hợp Facebook Android phiên bản 5.3.1.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.3.2.0.

Phiên bản 2.3.0

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.3.0.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.3.0.0.

Phiên bản 2.2.0

  • Đã cập nhật trình bổ trợ này để hỗ trợ API quảng cáo có tặng thưởng mới (thử nghiệm).
  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.2.0.1.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.2.0.1.

Phiên bản 2.1.1

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.1.0.1.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.1.0.0.

Phiên bản 2.1.0

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.1.0.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.1.0.0.

Phiên bản 2.0.0

  • Hỗ trợ bộ chuyển đổi Facebook của Android phiên bản 5.0.1.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 5.0.1.0.

Phiên bản 1.2.1

  • Hỗ trợ bộ điều hợp Facebook Android phiên bản 4.99.3.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 4.99.3.0.

Phiên bản 1.2.0

  • Hỗ trợ bộ điều hợp Facebook Android phiên bản 4.99.1.1.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 4.99.2.0.

Phiên bản 1.1.3

  • Hỗ trợ bộ điều hợp Facebook Android phiên bản 4.28.2.1.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 4.28.1.2.

Phiên bản 1.1.2

  • Khắc phục xung đột tiềm ẩn với plugin dàn xếp Unity Ads của Unity.

Phiên bản 1.1.1

  • Hỗ trợ bộ điều hợp Facebook Android phiên bản 4.28.2.0.
  • Hỗ trợ bộ chuyển đổi Facebook iOS phiên bản 4.28.1.1.

Phiên bản 1.1.0

  • Hỗ trợ SDK Android Android phiên bản 4.28.1.
  • Hỗ trợ SDK iOS của iOS phiên bản 4.28.1.

Phiên bản 1.0.0

  • Bản phát hành đầu tiên!
  • Hỗ trợ SDK Android Android phiên bản 4.27.0.
  • Hỗ trợ SDK iOS của iOS phiên bản 4.27.1.