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

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

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, 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 thác nước hiện đang trong thử nghiệm beta kín.

² 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.

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 Ad Manager giao diện người dùng

Đăng nhập vào tài khoản Ad Manager của bạn.

Thêm Pangle trong Công ty

Đặ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

Chuyển đến mục Quản trị > Công ty, sau đó nhấp vào nút Công ty mới trong thẻ Tất cả công ty. Chọn Mạng quảng cáo.

Chọn Pangle làm Mạng quảng cáo, nhập một Tên riêng biệt và bật tính năng Dàn xếp.

Bạn không cần nhập Tên người dùng hoặc Mật khẩu. Nhấp vào Lưu khi hoàn tất.

Bật tính năng chia sẻ tín hiệu an toàn

Đặt giá thầu

Di chuyển đến mục Quản trị > Cài đặt chung. Chuyển đến thẻ Cài đặt tài khoản Ad Exchange, xem lại và bật tuỳ chọn Chia sẻ tín hiệu an toàn. Nhấp vào Save (Lưu).

Thác nước

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

Định cấu hình Pangle đặt giá thầu

Đặt giá thầu

Chuyển đến phần Phân phối > Bên đặt giá thầu rồi nhấp vào Bên đặt giá thầu mới trong thẻ Đặt giá thầu qua SDK.

Chọn Pangle làm bên đặt giá thầu.

Bật tuỳ chọn Thêm thư viện tín hiệu của bên đặt giá thầu này vào danh sách các tín hiệu được phép và Cho phép chia sẻ tín hiệu với bên đặt giá thầu này. Sau đó, hãy nhấp vào Tiếp tục.

Nhấp vào Tiếp tục.

Nhấp vào Xong.

Thác nước

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

Định cấu hình liên kết đơn vị quảng cáo

Đặt giá thầu

Chuyển đến phần Phân phối > Bên đặt giá thầu rồi chọn công tyPangle trong thẻ Đặt giá thầu qua SDK.

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 dành cho thiết bị di động làm Loại khoảng không quảng cáo và Ứng dụng dành cho thiết bị di động của bạn. Sau đó, hãy nhậpApp ID and Ad Placement ID đã nhận được ở phần trước. Cuối cùng, hãy nhấp vào Lưu.

Thác nước

Chuyển đến phần Phân phối > Nhóm lợi nhuận rồi nhấp vào nút Nhóm lợi nhuận mới. Chọn Ứng dụng dành cho thiết bị di động.

Di chuyển xuống rồi nhấp vào mục Thêm đối tác lợi nhuận.

Chọn công ty bạn đã tạo cho Pangle trong phần trước. Chọn Dàn xếp SDK trên thiết bị di động làm Loại tích hợp, Android làm Nền tảng và Đang hoạt động làm Trạng thái.

Nhập App ID and Ad Placement ID đã nhận được trong phần trước và giá trị CPM mặc định. Nhấp vào Save (Lưu).

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 Ad Manager 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.