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

Hướng dẫn này dành cho những 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ừ Pangle thông qua tính năng đặt giá thầu. Bài viết này trình bày cách thêm quảng cáo 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 iOS ứng dụng.

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 AdMob cho Pangle có các tính năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Định 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
Gốc

Yêu cầu

  • Mục tiêu triển khai iOS từ 10.0 trở lên
  • SDK quảng cáo trên thiết bị di động mới nhất của Google

Bước 1: Thiết lập 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 tới thẻ Applications (Ứng dụng) rồi nhấp vào nút Add App (Thêm ứng dụng).

Chọn iOS làm Hệ điều hành và điền vào phần còn lại của biểu mẫu. Sau đó, hãy 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 Thêm như hiển thị dưới đây để tạo vị trí đặt quảng cáo của bạn.

Chọn Định dạng quảng cáo, Tên vị trí đặt quảng cáo mà bạn muốn và chọn Đặt giá thầu trong ứng dụng làm Loại đặt giá thầu. Điền thông tin vào các biểu mẫu còn lại rồi 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.

Bước 2: Định cấu hình chế độ cài đặt dàn xếp cho đơn vị quảng cáo AdMob 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.

Chuyển đến thẻ Dàn xếp. Nếu bạn hiện 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 và bỏ qua để chuyển sang bước Thêm Pangle 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.

Chi tiết hòa giải

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

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

Nhóm dàn xếp 2

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.

Chọn đơn vị quảng cáo

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.

Nhóm đơn vị quảng cáo

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

Trong thẻ Đặt giá thầu ở 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 Dấu kiểm.

Tiếp theo, nhập Mã ứng dụng cũng như Mã vị trí đặt quảng cáo có được trong phần trước rồi nhấp vào Xong.

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

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

Trong phần cài đặt của đơ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 đánh dấu vào hộp Áp dụng cho tất cả cá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 Pangle sẽ nhận phần thưởng thuộc loại "" (chuỗi trống) có giá trị 1 theo mặc định. SDK Pangle 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 các đơ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 SDK và bộ chuyển đổi Pangle

  • Thêm dòng sau vào Podfile của dự án:

    pod 'GoogleMobileAdsMediationPangle'
    
  • Trên dòng lệnh, hãy chạy:

    pod install --repo-update

Tích hợp thủ công

  • Tải phiên bản mới nhất của SDK Pangle cho iOS rồi liên kết tất cả các tệp .framework và gói trong dự án.
  • Tải phiên bản mới nhất của bộ chuyển đổi Pangle xuống từ đường liên kết tải xuống trong Changelog và đường liên kết PangleAdapter.xcframework trong dự án của bạn.

Bước 4: Cần có mã bổ sung

Tích hợp SKAdNetwork

Pangle yêu cầu bạn thêm các giá trị nhận dạng SKAdNetwork sau đây vào tệp Info.plist của dự án:

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>238da6jt44.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>22mmun2rn5.skadnetwork</string>
    </dict>
</array>

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

Xem hướng dẫn Cách thêm Quảng cáo thử nghiệm để biết hướng dẫn chi tiết về cách bật quảng cáo thử nghiệm Pangle. Sau đó, bạn có thể sử dụng Công cụ kiểm tra quảng cáo để xác minh xem cách triển khai của mình có chính xác hay không.

Vậy là xong! Bạn hiện đã tích hợp tính năng dàn xếp hoạt động với Pangle.

Mã lỗi

Nếu bộ chuyển đổi không thể nhận 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 GADResponseInfo.adNetworkInfoArray trong các lớp sau:

GADMediationAdapterPangle

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

Mã lỗi Lâu đài Lý do
101 com.google.ads.dàn xếp.pangle Thông 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.dàn xếp.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 Pangle hỗ trợ.
103 com.google.ads.dàn xếp.pangle Phản hồi giá thầu bị thiếu hoặc không hợp lệ.
-1-60000 com.pangle.ads SDK Pangle đã trả về lỗi. Xem tài liệu của Pangle để biết thêm chi tiết.
101 com.google.ads.dàn xếp.pangle Thông 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.dàn xếp.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 Pangle hỗ trợ.
-1-60000 Do Pangle SDK gửi SDK Pangle đã trả về lỗi. Xem tài liệu của Pangle để biết thêm chi tiết.

Nhật ký thay đổi bộ chuyển đổi dàn xếp iOS

Phiên bản 4.7.0.5.0 (Đang tiến hành)

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.7.0.5.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.11.0.
  • Pangle SDK phiên bản 4.7.0.5

Phiên bản 4.7.0.4.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.7.0.4.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.10.0.
  • Pangle SDK phiên bản 4.7.0.4.

Phiên bản 4.6.2.2.0

  • Đổi tên các phương thức setGDPR()setCCPA() từ lớp GADMediationAdapterPangle thành setGDPRConsent()setDoNotSell.
  • Khả năng tương thích đã được xác minh với SDK Pangle phiên bản 4.6.2.2.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.10.0.
  • Pangle SDK phiên bản 4.6.2.2.

Phiên bản 4.6.1.8.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.6.1.8.
  • Thêm tùy chọn hỗ trợ đặt giá thầu cho định dạng quảng cáo gốc.
  • Cập nhật bộ chuyển đổi để sử dụng API didRewardUser.
  • Giờ đây, bạn cần có SDK quảng cáo trên thiết bị di động của Google phiên bản 9.8.0 trở lên.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.9.0.
  • Pangle SDK phiên bản 4.6.1.8.

Phiên bản 4.5.2.8.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.5.2.8.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.7.0.
  • Pangle SDK phiên bản 4.5.2.8.

Phiên bản 4.5.2.7.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.5.2.7.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.7.0.
  • Pangle SDK phiên bản 4.5.2.7.

Phiên bản 4.5.2.5.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.5.2.5.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.6.0.
  • Pangle SDK phiên bản 4.5.2.5.

Phiên bản 4.5.2.4.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.5.2.4.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.6.0.
  • Pangle SDK phiên bản 4.5.2.4.

Phiên bản 4.5.2.3.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.5.2.3.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.6.0.
  • Pangle SDK phiên bản 4.5.2.3.

Phiên bản 4.5.1.3.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.5.1.3.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.5.0.
  • Pangle SDK phiên bản 4.5.1.3.

Phiên bản 4.3.1.9.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.3.1.9.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.3.0.
  • Pangle SDK phiên bản 4.3.1.9.

Phiên bản 4.3.0.5.0

  • Khả năng tương thích đã xác minh với SDK Pangle phiên bản 4.3.0.5.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.2.0.
  • Pangle SDK phiên bản 4.3.0.5

Phiên bản 4.3.0.4.0

  • Bản phát hành đầu tiên!
  • Đã thêm tùy chọn hỗ trợ đặt giá thầu cho biểu ngữ (bao gồm cả MREC), định dạng quảng cáo xen kẽ và quảng cáo có tặng thưởng.

Được xây dựng và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 9.1.0.
  • Pangle SDK phiên bản 4.3.0.4.