Trang này được dịch bởi Cloud Translation API.

Tích hợp Pangle với tính năng dàn xếp

Hướng dẫn này chỉ cho bạn cách sử dụng SDK Quảng cáo của Google trên thiết bị di động để tải và hiển thị quảng cáo từ Pangle sử dụng Dàn xếp AdMob, bao gồm cả chế độ tích hợp kiểu thác nước và tính năng đặt giá thầu. Tài liệu này trình bày cách thêm Pangle vào cấu hình dàn xếp của một đơn vị quảng cáo và cách tích hợp SDK Pangle và bộ chuyển đổi vào ứng dụng Android .

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

Bộ chuyển đổi dàn xếp cho Pangle có các khả năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Định dạng
Quảng cáo khi mở ứng 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

¹ Tích hợp chiến lược đặt giá thầu cho định dạng này đang ở giai đoạn thử nghiệm beta kín.

Yêu cầu

Android API cấp 21 trở lên

SDK Quảng cáo của Google trên thiết bị di động mới nhất
Hoàn tất quá trình dàn xếp Hướng dẫn bắt đầu sử dụng

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

Đăng ký hoặc Đăng nhập vào tài khoản Pangle của bạn.

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.

Chọn Hệ điều hành mà bạn muốn tạo ứng dụng rồi điền vào phần còn lại của biểu mẫu. Sau đó, nhấp vào Gửi.

Ghi lại Mã ứng dụng của ứng dụng.

Tạo vị trí đặt quảng cáo

Sau khi tạo ứng dụng, hãy nhấp vào nút Add (Thêm) để tạo vị trí đặt quảng cáo.

Đặt giá thầu

Chọn Định dạng quảng cáo và Tên vị trí đặt quảng cáo, rồi chọn Đặt giá thầu trong ứng dụng làm Loại giá. Điền vào các phần còn lại của biểu mẫu và nhấp vào Submit (Gửi).

Sau khi tạo vị trí đặt quảng cáo, hãy ghi lại Mã vị trí đặt quảng cáo.

Thác nước

Chọn Định dạng quảng cáo và Tên vị trí đặt quảng cáo, rồi chọn CPM toàn cầu làm Loại giá. Điền vào các phần còn lại của biểu mẫu và nhấp vào Gửi.

Sau khi tạo vị trí đặt quảng cáo, hãy ghi lại Mã vị trí đặt quảng cáo.

Tìm khoá API Báo cáo Pangle

Đặt giá thầu

Bạn không bắt buộc phải thực hiện bước này để tích hợp tính năng đặt giá thầu.

Thác nước

Ghi lại User ID ở góc dưới cùng bên trái của trang.

Nhấp vào Tích hợp > SDK và API > API Báo cáo Pangle 2.0. Ghi lại Mã vai trò và Khoá bảo mật.

Bật chế độ thử nghiệm

Hãy làm theo hướng dẫn trong hướng dẫn Cách thêm quảng cáo thử nghiệm của Pangle về cách bật quảng cáo thử nghiệm Pangle.

Bước 2: Thiết lập nhu cầu Pangle trong AdMob giao diện người dùng

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

Bạn cần thêm Pangle vào cấu hình dàn xếp cho đơn vị quảng cáo của mình.

Trước tiên, hãy đăng nhập vào tài khoản AdMob của bạn. Tiếp theo, hãy chuyển đến thẻ Dàn xếp. Nếu bạn đang có một nhóm dàn xếp 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 rồi chuyển đến mục Thêm Pangle dưới dạng 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 định dạng quảng cáo và nền tảng quảng cáo của bạn, rồi 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 của nhóm dàn xếp thành Đã bật, rồi nhấp vào Thêm đơn vị quảng cáo.

Liên kết nhóm dàn xếp này với một hoặc nhiều đơn vị quảng cáo AdMob hiện có. 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 sẵn các đơn vị quảng cáo mà bạn đã chọn:

Thêm Pangle làm nguồn quảng cáo

Đặt giá thầu

Trong thẻ Đặt giá thầu trong phần Nguồn quảng cáo, hãy chọn Thêm nguồn quảng cáo. Sau đó, hãy chọn Pangle.

Nhấp vào Cách ký thoả thuận hợp tác và thiết lập mối quan hệ đối tác đặt giá thầu vớiPangle.

Nhấp vào Xác nhận và đồng ý, rồi nhấp vào Tiếp tục.

Nếu đã có mối liên kết cho Pangle, bạn có thể chọn mối liên kết đó. Nếu không, hãy nhấp vào Thêm mối liên kết.

Tiếp theo, hãy nhập App ID and Ad Placement ID nhận được trong phần trước. Sau đó, hãy nhấp vào Xong.

Lưu ý quan trọng: App ID phải được liên kết với ứng dụng được nhắm đến như trong giao diện người dùngPangle .

Thác nước

Trong thẻ Thác nước trong mục Nguồn quảng cáo, hãy chọn Thêm nguồn quảng cáo. Sau đó, hãy chọn Pangle.

Chọn Pangle. Sau đó, hãy nhập giá trị eCPM cho Pangle rồi nhấp vào Tiếp tục.

Nếu đã có mối liên kết cho Pangle, bạn có thể chọn mối liên kết đó. Nếu không, hãy nhấp vào Thêm mối liên kết.

Tiếp theo, hãy nhập App ID and Ad Placement ID nhận được trong phần trước. Sau đó, hãy nhấp vào Xong.

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

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

Trong tệp settings.gradle.kts ở cấp dự án, hãy thêm đoạn mã sau kho lưu trữ:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

Sau đó, trong tệp build.gradle.kts ở cấp ứng dụng, hãy thêm đoạn mã sau các phần phụ thuộc và cấu hình triển khai. Sử dụng phiên bản mới nhất của Pangle SDK và bộ chuyển đổi:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:pangle:6.1.0.7.0")
}

Tích hợp thủ công

Tải xuống phiên bản mới nhất của Pangle SDK cho Android và giải nén open_ad_sdk.aar trong thư mục lưu trữ đã tải xuống rồi thêm vào dự án của bạn.
Chuyển đến Cấu phần phần mềm của bộ chuyển đổi Pangle trên Kho lưu trữ Maven của Google. Chọn phiên bản mới nhất, tải Pangle xuống tệp .aar của bộ chuyển đổi rồi thêm tệp này vào dự án của bạn.

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

Làm rối mã nguồn ProGuard

Nếu bạn sử dụng ProGuard để làm rối mã nguồn Android, hãy làm theo hướng dẫn trong Tài liệu của Pangle để đảm bảo mã Pangle SDK không bị làm rối mã nguồn.

Bước 5: Kiểm tra kết quả triển khai

Bật quảng cáo thử nghiệm

Hãy nhớ đăng ký thiết bị thử nghiệm cho AdMob và bật chế độ thử nghiệm trong Pangle giao diện người dùng.

Xác minh quảng cáo thử nghiệm

Để xác minh rằng bạn đang nhận quảng cáo thử nghiệm từ Pangle, 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ách sử dụng Pangle (Bidding) and Pangle (Waterfall) (các) nguồn quảng cáo.

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

Quảng cáo gốc

Hiển thị quảng cáo

Bộ chuyển đổi Pangle trả về quảng cáo gốc dưới dạng NativeAd . Chiến dịch này sẽ điền giá trị sau trường cho một NativeAd

Trường	Thành phần luôn có trong bộ chuyển đổi Pangle
Dòng tiêu đề
Bài đăng có hình ảnh	1
Nội dung
Biểu tượng
Lời kêu gọi hành động
Điểm xếp hạng theo sao
Cửa hàng
Giá
Nhà quảng cáo

¹ Bộ chuyển đổi Pangle 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 điền sẵn MediaView có video hoặc hình ảnh.

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ Pangle, 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.getAdapterResponses() thuộc các lớp sau:

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

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

Mã lỗi	Lâu đài	Lý do
101	com.google.ads.mediation.pangle	Tham số máy chủ không hợp lệ (ví dụ: Thiếu mã ứng dụng hoặc mã vị trí).
102	com.google.ads.mediation.pangle	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 hỗ trợ Pangle.
103	com.google.ads.mediation.pangle	Giá thầu phản hồi bị thiếu hoặc không hợp lệ.
-1-60000	com.pangle.ads	Pangle SDK trả về một lỗi. Hãy xem tài liệu của Pangle để biết thêm thông tin chi tiết.