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

Hướng dẫn này cho bạn biết 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ừ Mintegral bằng cách sử dụng Dàn xếp AdMob, bao gồm cả tính năng tích hợp đặt giá thầu và thác nước. Tài liệu này trình bày cách thêm Mintegral 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 cũng như bộ chuyển đổi Mintegral vào ứng dụngiOS .

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

² Quy trình tích hợp kiểu thác nước và tính năng đặt giá thầu cho định dạng quảng cáo gốc đang ở giai đoạn thử nghiệm beta công khai.

Yêu cầu

• Mục tiêu triển khai iOS phiên bản 11.0 trở lên

• SDK quảng cáo trên thiết bị di động của Google mới nhất

• Hoàn tất quy 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 Mintegral

Đăng ký hoặc Đăng nhập vào tài khoản Mintegral.

Tìm khoá ứng dụng

Chuyển đến thẻ APP Setting (Cài đặt ứng dụng) và ghi lại APP Key (Khoá ứng dụng).

Thêm ứng dụng mới

Trên thẻ APP Setting (Cài đặt ứng dụng), hãy nhấp vào nút Add APP (Thêm ứng dụng).

Chọn Nền tảng rồi điền vào các phần còn lại của biểu mẫu. Sau đó, hãy nhấp vào Lưu.

Ghi lại ID ỨNG DỤNG của ứng dụng của bạn.

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

Sau khi tạo ứng dụng, hãy chuyển đến thẻ Vị trí và đơn vị rồi nhấp vào nút Thêm vị trí như minh hoạ bên dưới để tạo vị trí đặt quảng cáo.

Nhập Tên vị trí và Định dạng quảng cáo.

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

Nhấp vào trình đơn thả xuống 1 ĐƠN VỊ QUẢNG CÁO rồi ghi lại MÃ ĐƠN VỊ QUẢNG CÁO.

Tìm khoá API báo cáo Mintegral

Bước 2: Thiết lập nhu cầu Mintegral 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 Mintegral 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 Mintegral 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 Mintegral làm nguồn quảng cáo

Thêm Mintegral vào danh sách đối tác quảng cáo tuân thủ GDPR và quy định của tiểu bang ở Hoa Kỳ

Hãy làm theo các bước trong phần cài đặt GDPR và cài đặt theo quy định của các tiểu bang tại Hoa Kỳ để thêm Mobvista/Mintegral vào danh sách đối tác quảng cáo theo GDPR và theo quy định của các tiểu 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 Mintegral

Sử dụng CocoaPods (nên dùng)

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

  pod 'GoogleMobileAdsMediationMintegral'
  

• Chạy trên dòng lệnh:

  pod install --repo-update

Tích hợp thủ công

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

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

Sự đồng ý của người dùng ở Liên minh Châu Âu và GDPR

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 rằng bạn đã công bố một số thông tin nhất định và nhận được 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ề việc bảo vệ dữ liệu (GDPR). Khi yêu cầu 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 từng 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 đến các mạng như vậy.

SDK Mintegral bao gồm phương thức setConsentStatus để truyền thông tin về sự đồng ý đến SDK Mintegral.

Mã mẫu sau đây cho biết cách truyền thông tin về sự đồng ý đến SDK Mintegral. Bạn phải đặt các tuỳ chọn này trước khi khởi chạy SDK quảng cáo của Google trên thiết bị di động để đảm bảo các tuỳ chọn đó được chuyển tiếp đúng cách đến SDK Mintegral.

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setConsentStatus:YES];

Hãy xem tài liệu về quyền riêng tư của Mintegral để biết thêm thông tin.

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

SDK Mintegral bao gồm phương thức setDoNotTrackStatus để truyền thông tin về sự đồng ý đến SDK Mintegral.

Mã mẫu sau đây cho biết cách truyền thông tin về sự đồng ý đến SDK Mintegral. Nếu bạn cần gọi phương thức này, hãy gọi phương thức đó làtrước khikhởi chạy SDK quảng cáo của Google trên thiết bị di độngđể đảm bảo các yêu cầu đó được chuyển tiếp đúng cách đến SDK Mintegral.

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

Hãy xem tài liệu về quyền riêng tư của Mintegral để biết thêm thông tin.

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

Tích hợp SKAdNetwork

Làm theo tài liệu của Mintegral để 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ử quá trình 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.

Để tải quảng cáo thử nghiệm Mintegral cho định dạng quảng cáo biểu ngữ, quảng cáo xen kẽ, quảng cáo có tặng thưởng và quảng cáo gốc, Mintegral bạn nên sử dụng Khoá ứng dụng, Mã ứng dụng, Mã vị trí và Mã đơn vị quảng cáo được cung cấp trên Trang Mã kiểm thử Mintegral.

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ừ Mintegral, 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 Mintegral (Bidding) and Mintegral (Waterfall) (các) nguồn quảng cáo.

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

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

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

Quảng cáo gốc

Hiển thị quảng cáo

Bộ chuyển đổi Mintegral trả về quảng cáo gốc dưới dạng các đối tượng, GADNativeAd và. Phương thức này điền sẵn các trường, trườngcho NativeAd GADNativeAd.

¹ Trình chuyển đổi Mintegral 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 đó, trình chuyển đổi sẽ điền sẵn một video hoặc hình ảnh vàoGADMediaView.

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ Mintegral, 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:

GADMediationAdapterMintegral

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

Nhật ký thay đổi của Bộ chuyển đổi dàn xếp iOS của Mintegral

Phiên bản 7.7.3.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.7.3.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.10.0.
• Mintegral SDK phiên bản 7.7.3.

Phiên bản 7.7.2.1

• Trình chuyển đổi không còn kiểm tra xem quảng cáo xen kẽ và quảng cáo có tặng thưởng đã sẵn sàng hay chưa trước khi hiển thị.
• Cập nhật CFBundleShortVersionString để có ba thành phần thay vì bốn.

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

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.10.0.
• Mintegral SDK phiên bản 7.7.2.

Phiên bản 7.7.2.0

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

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.9.0.
• Mintegral SDK phiên bản 7.7.2.

Phiên bản 7.7.1.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.7.1.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.8.0.
• Mintegral SDK phiên bản 7.7.1.

Phiên bản 7.7.0.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.7.0.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.8.0.
• Mintegral SDK phiên bản 7.7.0.

Phiên bản 7.6.9.0

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

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.7.0.
• Mintegral SDK phiên bản 7.6.9.

Phiên bản 7.6.8.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.6.8.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.7.0.
• Mintegral SDK phiên bản 7.6.8.

Phiên bản 7.6.7.0

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

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.6.0.
• Mintegral SDK phiên bản 7.6.7.

Phiên bản 7.6.6.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.6.6.

Được tạo 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 11.5.0.
• Mintegral SDK phiên bản 7.6.6.

Phiên bản 7.6.4.0

• Khả năng tương thích xác minh với Mintegral SDK phiên bản 7.6.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 11.4.0.
• Mintegral SDK phiên bản 7.6.4.

Phiên bản 7.6.3.0

• Khả năng tương thích xác minh với Mintegral SDK phiên bản 7.6.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 11.3.0.
• Mintegral SDK phiên bản 7.6.3.

Phiên bản 7.6.2.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.6.2.

Được tạo 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 11.3.0.
• Mintegral SDK phiên bản 7.6.2.

Phiên bản 7.6.1.0

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

Được tạo 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 11.3.0.
• Mintegral SDK phiên bản 7.6.1.

Phiên bản 7.6.0.0

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

Được tạo 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 11.2.0.
• Mintegral SDK phiên bản 7.6.0.

Phiên bản 7.5.9.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.5.9.

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

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.2.0.
• Mintegral SDK phiên bản 7.5.9.

Phiên bản 7.5.8.0

• Khả năng tương thích xác minh với Mintegral SDK phiên bản 7.5.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 11.1.0.
• Mintegral SDK phiên bản 7.5.8.

Phiên bản 7.5.7.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.5.7.
• Hiện yêu cầu phiên bản iOS tối thiểu là 12.0.
• Hiện tại, bạn cần sử dụng SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.0 trở lên.
• Đưa Info.plist vào các khung trong MintegralAdapter.xcframework.

Được tạo 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 11.0.1.
• Mintegral SDK phiên bản 7.5.7.

Phiên bản 7.5.6.0

• Khả năng tương thích xác minh với Mintegral SDK phiên bản 7.5.6.
• Đặt GADMediationAdapterMintegral.h làm tiêu đề công khai.

Được tạo 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 11.0.0.
• Mintegral SDK phiên bản 7.5.6.

Phiên bản 7.5.3.0

• Khả năng tương thích xác minh với Mintegral SDK phiên bản 7.5.3.
• Bổ sung tính năng hỗ trợ đặt giá thầu cho định dạng quảng cáo khi mở ứng dụng.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 10.14.0.
• Mintegral SDK phiên bản 7.5.3.

Phiên bản 7.4.8.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.4.8.

Được tạo 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 10.13.0.
• Mintegral SDK phiên bản 7.4.8.

Phiên bản 7.4.7.0

• Cập nhật tệp podspec để phụ thuộc vào MintegralAdSDK/All thay vì MintegralAdSDK.
• Khả năng tương thích xác minh với Mintegral SDK phiên bản 7.4.7.
• Thêm tính năng hỗ trợ thác nước cho định dạng quảng cáo mở ứng dụng.

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

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 10.12.0.
• Mintegral SDK phiên bản 7.4.7.

Phiên bản 7.4.4.0

• Thêm tính năng hỗ trợ hình mờ cho quảng cáo đặt giá thầu.
• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.4.4.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 10.10.0.
• Mintegral SDK phiên bản 7.4.4.

Phiên bản 7.4.3.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.4.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 10.9.0.
• Mintegral SDK phiên bản 7.4.3.

Phiên bản 7.4.1.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.4.1.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 10.7.0.
• Mintegral SDK phiên bản 7.4.1.

Phiên bản 7.3.9.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.3.9.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 10.7.0.
• Mintegral SDK phiên bản 7.3.9.

Phiên bản 7.3.8.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.3.8.

Được tạo 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 10.6.0.
• Mintegral SDK phiên bản 7.3.8.

Phiên bản 7.3.7.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.3.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 10.5.0.
• Mintegral SDK phiên bản 7.3.7.

Phiên bản 7.3.6.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.3.6.
• Xoá tính năng hỗ trợ kiến trúc armv7.
• Hiện yêu cầu phiên bản iOS tối thiểu là 11.0.
• Giờ đây, bạn phải sử dụng SDK quảng cáo trên thiết bị di động của Google phiên bản 10.4.0 trở lên.

Được tạo 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 10.5.0.
• Mintegral SDK phiên bản 7.3.6.

Phiên bản 7.3.4.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.3.4.

Được tạo 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 10.2.0.
• Mintegral SDK phiên bản 7.3.4.

Phiên bản 7.3.3.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.3.3.

Được tạo 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 10.2.0.
• Mintegral SDK phiên bản 7.3.3.

Phiên bản 7.3.0.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.3.0.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 10.1.0.
• Mintegral SDK phiên bản 7.3.0.

Phiên bản 7.2.9.1

• Thêm tính năng hỗ trợ kiểu thác nước cho các định dạng quảng cáo biểu ngữ (bao gồm cả MREC), quảng cáo xen kẽ, quảng cáo có tặng thưởng và quảng cáo gốc.
• Yêu cầu sử dụng SDK quảng cáo trên thiết bị di động của Google phiên bản 10.0.0 trở lên.

Được tạo và thử nghiệm với:

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 10.0.0.
• Mintegral SDK phiên bản 7.2.9.

Phiên bản 7.2.9.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.2.9.

Được tạo và thử nghiệm với:

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

Phiên bản 7.2.8.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.2.8.

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

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 9.14.0.
• Mintegral SDK phiên bản 7.2.8.

Phiên bản 7.2.6.0

• Bản phát hành đầu tiên!
• Thêm tính năng hỗ trợ đặt giá thầu cho các định dạng quảng cáo biểu ngữ (bao gồm cả MREC), quảng cáo xen kẽ, quảng cáo có tặng thưởng và quảng cáo gốc.
• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.2.6.
• Yêu cầu sử dụng 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 tạo và thử nghiệm với:

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