Tích hợp PubMatic với tính năng Dàn xếp AdMob

Hướng dẫn này cho bạn biết cách sử dụng Google Mobile Ads SDK for React Native để tải và hiển thị quảng cáo từ PubMatic bằng tính năng Dàn xếp AdMob, 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 PubMatic 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 PubMatic vào một ứng dụng React Native.

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 AdMob cho PubMatic có các chức năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Định dạng
Mở ứng dụng
Biểu ngữ
Quảng cáo xen kẽ  1
Được thưởng  1
Quảng cáo xen kẽ có tặng thưởng
Mã gốc  1

1 Định dạng này đang trong giai đoạn thử nghiệm. Hãy liên hệ với người quản lý tài khoản của bạn để yêu cầu cấp quyền truy cập.

Điều kiện tiên quyết

Trước khi tiếp tục, hãy xác minh những thông tin sau:

Bước 1: Thiết lập cấu hình trong giao diện người dùng OpenWrap SDK của PubMatic

Đăng ký hoặc Đăng nhập vào tài khoản PubMatic của bạn rồi chọn thẻ OpenWrap SDK.

Thêm ứng dụng mới

Chuyển đến thẻ Ứng dụng rồi nhấp vào nút Thêm ứng dụng.

Trang tổng quan ứng dụng

Chọn Nền tảng, cũng như URL của Cửa hàng ứng dụng và Tên ứng dụng cho ứng dụng của bạn.

Android

Trong phần Integration Path (Đường dẫn tích hợp), hãy chọn React Native rồi chọn AdMob – SDK Bidding (AdMob – Đặt giá thầu qua SDK) làm Sub-integration Path (Đường dẫn tích hợp phụ). Sau đó, nhấp vào nút Thêm ứng dụng.

Biểu mẫu ứng dụng mới

iOS

Trong phần Integration Path (Đường dẫn tích hợp), hãy chọn React Native rồi chọn AdMob – SDK Bidding (AdMob – Đặt giá thầu qua SDK) làm Sub-integration Path (Đường dẫn tích hợp phụ). Sau đó, nhấp vào nút Thêm ứng dụng.

Biểu mẫu ứng dụng mới

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 bạn chưa làm, hãy thiết lập tệp app-ads.txt cho ứng dụng của bạn.

Trước khi hoàn tất ứng dụng, bạn sẽ thấy các mục thích hợp để thêm vào app-ads.txt.

app-aps.txt

Để biết thêm thông tin về cách triển khai app-ads.txt cho PubMatic, hãy xem bài viết Cách triển khai tệp app-ads.txt.

Mã hồ sơ

Sau khi tạo ứng dụng, hãy chuyển đến thẻ Apps (Ứng dụng) và ghi lại Profile ID (Mã hồ sơ) của ứng dụng mới tạo.

Mã hồ sơ ứng dụng

Tạo đơn vị quảng cáo

Trong thẻ Đơn vị quảng cáo, hãy chọn ứng dụng bạn đã tạo ở phần trước rồi nhấp vào nút Tạo đơn vị quảng cáo.

Tạo đơn vị quảng cáo

Điền thông tin chi tiết về đơn vị quảng cáo của bạn vào biểu mẫu rồi nhấp vào Lưu.

Biểu mẫu tạo đơn vị quảng cáo

Ghi lại Mã đơn vị quảng cáo OpenWrap mới tạo.

Mã đơn vị quảng cáo trong ứng dụng

Lấy mã nhà xuất bản của bạn

Chuyển đến Trang tổng quan Analytics. Di chuột lên biểu tượng hồ sơ và ghi lại mã nhận dạng của bạn.

Mã nhà xuất bản

Bước 2: Thiết lập nhu cầu về SDK OpenWrap của PubMatic trong giao diện người dùng AdMob

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

Android

Để biết hướng dẫn, hãy xem bước 2 trong tài liệu về Android.

iOS

Để biết hướng dẫn, hãy xem bước 2 trong tài liệu về iOS.

Thêm PubMatic 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 PubMatic 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 AdMob.

Bước 3: Nhập SDK và bộ chuyển đổi của PubMatic OpenWrap SDK

Trong thư mục gốc của dự án, hãy cài đặt Google Mobile Ads SDK for React Native bộ chuyển đổi dàn xếp cho SDK OpenWrap của PubMatic. Hãy hoàn tất các bước sau:

  1. Sao chép tệp tar của bộ chuyển đổi Google Mobile Ads SDK for React Native từ thư mục gma-sdk-react-native/adapters/pubmatic/ vào thư mục local_packages/ của dự án. Nếu bạn không có thư mục adapters, hãy xem phần Điều kiện tiên quyết.

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

    Thay thế EXTRACT_DIR bằng đường dẫn đến thư mục mà bạn đã giải nén tệp lưu trữ.

  2. Cài đặt gói bộ chuyển đổi bằng trình quản lý gói mà bạn muốn:

    npm

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

    chỉ len

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

  3. Nếu bạn đang xây dựng cho Android, hãy thêm kho lưu trữ sau vào tệp build.gradle trong thư mục android của dự án:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
}

Bước 4: Triển khai chế độ cài đặt quyền riêng tư trên SDK OpenWrap của PubMatic

Để tuân thủ 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 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ó được sự đồng ý của họ để sử dụng cookie hoặc phương pháp lưu trữ cục bộ khác khi pháp luật yêu cầu, cũng như để thu thập, chia sẻ và sử dụng dữ liệu cá nhân nhằm mục đích 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.

Bộ chuyển đổi React Native của PubMatic OpenWrap SDK phiên bản 0.1.0 trở lên hỗ trợ việc truyền tín hiệu đồng ý theo GDPR từ các nền tảng quản lý sự đồng ý (tích hợp với Khuôn khổ về tính minh bạch và sự đồng ý (TCF) của Cục Quảng cáo tương tác (IAB)) đến PubMatic OpenWrap SDK. Để biết thêm thông tin, hãy xem bài viết Chuyển thông tin về GDPR và sự đồng ý theo GDPR.

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 tại Hoa Kỳ yêu cầu cung cấp cho người dùng quyền từ chối "bán" "thông tin cá nhân" (theo định nghĩa của các thuật ngữ này trong luật) của họ, 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.

PubMatic tự động đọc sự đồng ý theo Đạo luật về quyền riêng tư của người tiêu dùng tại California (CCPA) do các nền tảng quản lý sự đồng ý đặt ra (các nền tảng này hỗ trợ Thông số về sự đồng ý bổ sung của Google), bao gồm cả UMP SDK. Để biết thêm thông tin, hãy xem bài viết Đặt chuỗi CCPA.

Bước 5: Thêm mã bắt buộc

Android

Bạn không cần thêm mã để tích hợp PubMatic.

iOS

Tích hợp SKAdNetwork

Làm theo tài liệu về SDK PubMatic OpenWrap để thêm giá trị nhận dạng SKAdNetwork vào tệp Info.plist của dự án.

Bước 6: Kiểm thử kết quả 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 AdMob.

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ừ PubMatic OpenWrap SDK, hãy bật 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 PubMatic OpenWrap.

Mã lỗi

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

Android

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS

GADMediationAdapterPubMatic

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

Android

Mã lỗi Miền Lý do
101 com.google.ads.mediation.pubmatic Cấu hình máy chủ thiếu mã nhà xuất bản bắt buộc.
102 com.google.ads.mediation.pubmatic Định dạng quảng cáo không được PubMatic hỗ trợ hoặc bị thiếu trong dữ liệu tín hiệu RTB.
103 com.google.ads.mediation.pubmatic Không thể hiển thị quảng cáo vì quảng cáo chưa sẵn sàng.
104 com.google.ads.mediation.pubmatic Mã hồ sơ bị thiếu hoặc không hợp lệ.
105 com.google.ads.mediation.pubmatic Mã đơn vị quảng cáo bị thiếu hoặc trống.
106 com.google.ads.mediation.pubmatic Quảng cáo có tặng thưởng được trả về là rỗng.
107 com.google.ads.mediation.pubmatic Kích thước quảng cáo biểu ngữ không hợp lệ.
1001-5002 Do SDK PubMatic gửi SDK PubMatic đã trả về một lỗi. Hãy xem tài liệu của PubMatic để biết thêm thông tin chi tiết.

iOS

Mã lỗi Miền Lý do
101 com.google.ads.mediation.pubmatic Cấu hình máy chủ thiếu mã nhà xuất bản bắt buộc.
102 com.google.ads.mediation.pubmatic Yêu cầu thu thập tín hiệu đặt giá thầu không thành công vì có nhiều định dạng, không có định dạng hoặc định dạng không được hỗ trợ trong các tham số yêu cầu.
103 com.google.ads.mediation.pubmatic Cấu hình quảng cáo không hợp lệ để tải quảng cáo.
104 com.google.ads.mediation.pubmatic Không thể hiển thị quảng cáo xen kẽ vì quảng cáo chưa sẵn sàng.
105 com.google.ads.mediation.pubmatic Không thể hiển thị quảng cáo có tặng thưởng vì quảng cáo chưa sẵn sàng.
106 com.google.ads.mediation.pubmatic Không tải được một trong các nguồn hình ảnh quảng cáo gốc.
107 com.google.ads.mediation.pubmatic Cấu hình quảng cáo thiếu mã nhà xuất bản.
108 com.google.ads.mediation.pubmatic Cấu hình quảng cáo thiếu mã hồ sơ.
109 com.google.ads.mediation.pubmatic Cấu hình quảng cáo chứa mã hồ sơ không phải là số.
110 com.google.ads.mediation.pubmatic Cấu hình quảng cáo thiếu mã đơn vị quảng cáo.
111 com.google.ads.mediation.pubmatic SDK OpenWrap của PubMatic không tạo được thực thể kích thước quảng cáo.
1001-5002 Do SDK PubMatic gửi SDK PubMatic đã trả về một lỗi. Hãy xem tài liệu của PubMatic để biết thêm thông tin chi tiết.

Phiên bản 0.1.0

  • Bản phát hành đầu tiên.