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

² Tính năng đặt giá thầu và tích hợp kiểu thác nước 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 là 11.0 trở lên

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

• Xem hết Hướng dẫn bắt đầu sử dụng về tính năng dàn xếp

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 của Mintegral trong giao diện người dùng AdMob

Thêm Mintegral vào Quy định chung về việc bảo vệ dữ liệu (GDPR) và danh sách đối tác quảng cáo theo quy định của các 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 SDK Mintegral dành cho iOS xuống và liên kết tất cả các tệp và gói .framework trong dự án.
• Tải phiên bản mới nhất của trình chuyển đổi Mintegral xuống qua đường liên kết tải xuống trong Nhật ký thay đổi và 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 đó.

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 thấy 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 người dùng phải có quyền chọn không cho phép "bán" "thông tin cá nhân" của họ (theo định nghĩa của các thuật ngữ này trong luật), trong đó chế độ chọn không bán được cung cấp 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 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ủ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 chúng đượ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 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.

Để nhận quảng cáo thử nghiệm của Mintegral cho các đị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, 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 trong trang Mã thử nghiệm của Mintegral.

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ừ Mintegral, hãy bật tính năng 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 (các) nguồn quảng cáo Mintegral (Đặt giá thầu) và Mintegral (Thác nước).

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 đối tượng GADNativeAd . 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 thuộc các lớp sau:

GADMediationAdapterMintegral

Dưới đây là các mã và thông báo đi kèm do trình 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

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

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

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

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

Phiên bản 7.6.3.0

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

Phiên bản 7.6.2.0

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

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

Phiên bản 7.5.8.0

• Xác minh khả năng tương thích với SDK Mintegral phiên bản 7.5.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 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.
• 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 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.
• Thêm tính năng hỗ trợ đặt giá thầu cho định dạng quảng cáo mở ứng dụng.

Đượ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.14.0.
• Mintegral SDK phiên bản 7.5.3.

Phiên bản 7.4.8.0

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

Phiên bản 7.4.3.0

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

Phiên bản 7.3.9.0

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

• Khả năng tương thích xác minh với Mintegral SDK phiên bản 7.3.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 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 tuỳ chọn hỗ trợ thác nước cho các định dạng quảng cáo biểu ngữ (bao gồm 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 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.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 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.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.
• Khả năng tương thích xác minh với Mintegral SDK 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.