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

Tích hợp Mintegral với tính năng đặt giá thầu (Thử nghiệm)

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, 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 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ích hợp
Đặt giá thầu	¹
Thác nước	²
Định dạng
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ính năng tích hợp chiến lược đặt giá thầu đang ở giai đoạn thử nghiệm kín (ngoại trừ định dạng quảng cáo gốc ở giai đoạn thử nghiệm công khai).

² Tính năng tích hợp quy trình dàn xếp kiểu thác nước đang ở giai đoạn thử nghiệm khép kín.

Yêu cầu

Mục tiêu triển khai iOS là 11.0 trở lên

SDK Quảng cáo của Google trên thiết bị di động 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ẻ Cài đặt ứng dụng và ghi lại 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 MÃ ỨNG DỤNG của ứng dụng.

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

Sau khi ứng dụng của bạn đã được tạo, 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.

Đặt giá thầu

Chọn Loại giá thầu là Đặt giá thầu dựa vào tiêu đề. Điền thông tin vào phần còn lại của biểu mẫu rồi nhấp vào Lưu.

Thác nước

Chọn Cũ làm Loại chiến lược đặt giá thầu. Điền thông tin còn lại vào biểu mẫu rồi nhấp vào Lưu.

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

Đặt giá thầu

Bước này không bắt buộc đối với các công cụ tích hợp đặt giá thầu.

Thác nước

Bạn sẽ cần Khoá API báo cáo Mintegral để thiết lập mã đơn vị quảng cáo AdMob. Chuyển đến phần Tài khoản > Công cụ API. Ghi lại Skey và Secret.

Bước 2: Thiết lập nhu cầu của Mintegral trong giao diện người dùng Ad Manager

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 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 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à Quy định chung về việc bảo vệ dữ liệu (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 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.

Swift

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

Objective-C

#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 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ó 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.

Swift

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

Objective-C

#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

Hãy làm theo tài liệu của Mintegral để thêm các 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 Ad Manager.

Để 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ần Cài đặt CCPA để thêm Mintegral vào danh sách đối tác quảng cáo theo CCPA trong Ad Manager Giao diện người dùng.

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 sẽ điền sẵn trường cho GADNativeAd.

Trường	Các thành phần luôn được trình chuyển đổi Mintegral đưa vào
Dòng tiêu đề
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

¹ 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à 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:

Mã lỗi	Lâu đài	Lý do
101	com.google.mediation.mintegral	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.mediation.mintegral	SDK Mintegral trả về lỗi không thực hiện.
103	com.google.mediation.mintegral	SDK Mintegral không hiển thị được quảng cáo.
104	com.google.mediation.mintegral	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 Mintegral hỗ trợ.

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 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.9.0.
Mintegral SDK phiên bản 7.7.2.

Phiên bản 7.7.1.0

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

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

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

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 của Google trên thiết bị di động 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

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 của Google trên thiết bị di động 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 của Google trên thiết bị di động 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

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.
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 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.0.1.
Mintegral SDK phiên bản 7.5.7.

Phiên bản 7.5.6.0

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

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

Phiên bản 7.3.8.0

Khả năng tương thích xác minh với Mintegral SDK phiên bản 7.3.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 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ợ cấu 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 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.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 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 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 của Google trên thiết bị di động 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 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.