Tích hợp myTarget 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ừ myTarget bằng cách sử dụng tính năng dàn xếp, bao gồm các chế độ tích hợp kiểu thác nước. Hướng dẫn này đề cập đến cách thêm myTarget vào cấu hình dàn xếp của một đơn vị quảng cáo, cũng như cách tích hợp SDK myTarget SDK và bộ chuyển đổi vào một ứng dụng Unity.

Công cụ tích hợp và định dạng quảng cáo được hỗ trợ

Tích hợp
Đặt giá thầu
Thác nước
Dạng thức
Biểu ngữ
Quảng cáo xen kẽ
Được thưởng
Quảng cáo xen kẽ có tặng thưởng

Yêu cầu

  • Unity 4 trở lên
  • SDK Quảng cáo của Google trên thiết bị di động mới nhất
  • Cách triển khai trên Android
    • Android API cấp 21 trở lên
  • Cách triển khai trên iOS
    • Mục tiêu triển khai iOS phiên bản 12.0 trở lên
  • Một dự án Unity đang hoạt động được định cấu hình bằng SDK quảng cáo trên thiết bị di động của Google. Hãy xem phần Bắt đầu để biết thông tin chi tiế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 myTarget

First, sign up or log in to your myTarget account. Navigate to the Apps page by clicking on APPS on the header. Add your app by clicking ADD APP.

If your app supports both the Android and iOS platforms, you need to set up each one of them separately.

Android

Next, provide the Google Play URL for your app.

iOS

Next, provide the iTunes URL** for your app.

When adding an app, myTarget requires you to create an ad unit before you can complete the process.

Select BANNER from the available ad formats, and then click the ADD AD UNIT button.

Interstitial

Select INTERSTITIAL from the available ad formats, and then click the ADD AD UNIT button.

Rewarded

Select REWARDED VIDEO from the available ad formats, and then click the ADD AD UNIT button.

Native

Select NATIVE from the available ad formats, and then click on ADD AD UNIT.

In your ad unit's details page, make a note of your slot ID which can be found under the ad unit settings as slot_id. This slot ID will be used to set up your AdMob ad unit in the next section.

In addition to the slot_id, you'll also need your myTarget Permanent Access Token to set up your AdMob ad unit ID. Navigate to the Profile tab and select Access Tokens. Click Create Token or Show Token to view your myTarget Permanent Access Token.

Turn on test mode

Follow the instructions in myTarget's documentation to add and configure a test device in myTarget UI.

Bước 2: Thiết lập nhu cầu myTarget 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

Android

Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho Android.

iOS

Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho iOS.

Thêm Mail.ru 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 cài đặt GDPR và cài đặt quy định của chính phủ Hoa Kỳ để thêm Mail.ru vào GDPR và danh sách đối tác quảng cáo theo quy định của tiểu bang Hoa Kỳ trong AdMob giao diện người dùng.

Bước 3: Nhập myTarget SDK và bộ chuyển đổi

Hãy tải phiên bản mới nhất của trình bổ trợ dàn xếp Quảng cáo trên thiết bị di động của Google cho myTarget từ đường liên kết tải xuống trong Nhật ký thay đổi và trích xuất GoogleMobileAdsMyTargetMediation.unitypackage từ tệp zip.

Trong trình chỉnh sửa dự án Unity, hãy chọn Assets > Import Package > Custom Package (Tài sản > Nhập gói > Gói tuỳ chỉnh) rồi tìm tệp GoogleMobileAdsMyTargetMediation.unitypackage mà bạn đã tải xuống. Hãy đảm bảo rằng bạn đã chọn tất cả các tệp, rồi nhấp vào Nhập.

Sau đó, chọn Tài sản > Trình phân giải dịch vụ của Google Play > Trình phân giải Android > Buộc phân giải. Thư viện Trình phân giải các dịch vụ của Google Play dành cho Unity sẽ thực hiện việc phân giải phần phụ thuộc từ đầu và sao chép các phần phụ thuộc đã khai báo vào thư mục Assets/Plugins/Android của ứng dụng Unity.

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

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 cung cấp một số thông tin công bố nhất định cho người dùng ở Khu vực kinh tế Châu Âu (EEA) 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 phản ánh 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 có được 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, đồng thời 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.

Trình bổ trợ dàn xếp Quảng cáo trên thiết bị di động của Google cho myTarget phiên bản 2.1.0 bao gồm các phương thức SetUserConsent() và SetUserAgeRestricted(). Mã mẫu sau đây cho biết cách chuyển thông tin về sự đồng ý của người dùng đến SDK myTarget SDK. Nếu chọn gọi phương thức này, bạn nên thực hiện trước khi yêu cầu quảng cáo thông qua SDK Quảng cáo của Google trên thiết bị di động.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

Nếu xác định người dùng thuộc danh mục bị giới hạn độ tuổi, bạn cũng có thể gọi phương thức SetUserAgeRestricted().

MyTarget.SetUserAgeRestricted(true);

Hãy xem hướng dẫn về Quyền riêng tư và GDPR của myTarget để 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 tính năng xử lý dữ liệu bị hạn chế để 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ủ.

Trình bổ trợ dàn xếp Quảng cáo trên thiết bị di động của Google cho myTarget phiên bản 3.13.3 bao gồm phương thức SetCCPAUserConsent(bool). Mã mẫu sau đây cho biết cách chuyển thông tin về sự đồng ý của người dùng đến SDK myTarget SDK. Nếu chọn gọi phương thức này, bạn nên thực hiện trước khi yêu cầu quảng cáo thông qua SDK Quảng cáo của Google trên thiết bị di động.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

Hãy liên hệ với bộ phận hỗ trợ của myTarget để biết thêm thông tin.

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

Android

Không cần mã bổ sung để tích hợp myTarget.

iOS

Tích hợp SKAdNetwork

Hãy làm theo tài liệu của myTarget để 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 và bật chế độ thử nghiệm trong myTarget 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ừ myTarget, 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 myTarget (Waterfall) (các) nguồn quảng cáo.

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ myTarget, thì nhà xuất bản có thể kiểm tra lỗi cơ bản từ nội dung phản hồi quảng cáo bằng cách sử dụng ResponseInfo trong các lớp sau:

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

Android

Mã lỗi Lý do
100 myTarget SDK trả về một lỗi.
101 Tham số máy chủ myTarget được định cấu hình trong AdMob giao diện người dùng bị thiếu/không hợp lệ.
102 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ợ myTarget.
103 Yêu cầu quảng cáo không phải là yêu cầu quảng cáo gốc hợp nhất.
104 Quảng cáo gốc đã tải từ myTarget khác với quảng cáo gốc được yêu cầu.
105 Quảng cáo gốc được tải từ myTarget thiếu một số thành phần bắt buộc (ví dụ: hình ảnh hoặc biểu tượng).

iOS

Mã lỗi Lý do
100 myTarget SDK chưa có sẵn quảng cáo.
101 Tham số máy chủ myTarget được định cấu hình trong AdMob giao diện người dùng bị thiếu/không hợp lệ.
102 Bộ chuyển đổi myTarget không hỗ trợ định dạng quảng cáo đang được yêu cầu.
103 Đã cố hiển thị quảng cáo myTarget không được tải.
104 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ợ myTarget.
105 Thiếu thành phần quảng cáo gốc bắt buộc.

Nhật ký thay đổi của trình bổ trợ dàn xếp Unity Unity

Phiên bản 3.17.0

Phiên bản 3.16.2

Phiên bản 3.16.1

Phiên bản 3.16.0

Phiên bản 3.15.0

Phiên bản 3.14.0

Phiên bản 3.13.2

Phiên bản 3.13.1

Phiên bản 3.13.0

Phiên bản 3.12.0

Phiên bản 3.11.4

Phiên bản 3.11.3

Phiên bản 3.11.2

Phiên bản 3.11.1

Phiên bản 3.11.0

Phiên bản 3.10.2

Phiên bản 3.10.1

Phiên bản 3.10.0

Phiên bản 3.9.0

Phiên bản 3.8.2

Phiên bản 3.8.1

Phiên bản 3.8.0

Phiên bản 3.7.0

Phiên bản 3.6.1

Phiên bản 3.6.0

Phiên bản 3.5.2

Phiên bản 3.5.1

Phiên bản 3.5.0

Phiên bản 3.4.0

Phiên bản 3.3.0

Phiên bản 3.2.0

Phiên bản 3.1.0

Phiên bản 3.0.0

  • Cập nhật trình bổ trợ để hỗ trợ API quảng cáo có tặng thưởng mở (thử nghiệm) mới.
  • Hỗ trợ bộ điều hợp Android myTarget phiên bản 5.3.9.0.
  • Hỗ trợ bộ điều hợp myTarget iOS phiên bản 5.0.4.0.

Phiên bản 2.3.2

  • Hỗ trợ bộ điều hợp Android myTarget phiên bản 5.2.5.0.
  • Hỗ trợ bộ điều hợp myTarget iOS phiên bản 4.8.9.0.

Phiên bản 2.3.1

  • Hỗ trợ bộ điều hợp Android myTarget phiên bản 5.2.5.0.
  • Hỗ trợ bộ điều hợp myTarget iOS phiên bản 4.8.5.0.

Phiên bản 2.3.0

  • Hỗ trợ bộ điều hợp Android myTarget phiên bản 5.2.2.0.
  • Hỗ trợ bộ điều hợp myTarget iOS phiên bản 4.8.0.0.

Phiên bản 2.2.0

  • Hỗ trợ bộ điều hợp Android myTarget phiên bản 5.1.4.0.
  • Hỗ trợ bộ điều hợp myTarget iOS phiên bản 4.8.0.0.

Phiên bản 2.1.2

  • Hỗ trợ bộ điều hợp Android myTarget phiên bản 5.1.3.0.
  • Hỗ trợ bộ điều hợp myTarget iOS phiên bản 4.7.11.0.

Phiên bản 2.1.1

  • Hỗ trợ bộ điều hợp Android myTarget phiên bản 5.1.1.0.
  • Hỗ trợ bộ điều hợp myTarget iOS phiên bản 4.7.10.0.

Phiên bản 2.1.0

  • Hỗ trợ myTarget SDK Android phiên bản 5.1.0.
  • Hỗ trợ SDK myTarget iOS phiên bản 4.7.9.
  • Thêm các phương thức sau:
    • MyTarget.SetUserConsent() để chuyển tiếp trạng thái đồng ý của người dùng đến MyTarget SDK.
    • Phương thức MyTarget.SetUserAgeRestricted đặt cờ để cho biết liệu người dùng có thuộc danh mục bị giới hạn độ tuổi hay không (tức là dưới 16 tuổi).
    • Phương thức MyTarget.IsUserConsent() để lấy trạng thái đồng ý hiện tại của người dùng.
    • MyTarget.IsUserAgeRestricted() để lấy cờ cho biết người dùng được xác định là thuộc danh mục bị giới hạn độ tuổi (tức là dưới 16 tuổi).

Phiên bản 2.0.1

  • Hỗ trợ SDK myTarget Android phiên bản 5.0.2.
  • Hỗ trợ myTarget iOS SDK phiên bản 4.7.8.

Phiên bản 2.0.0

  • Hỗ trợ myTarget SDK Android phiên bản 5.0.0.
  • Hỗ trợ SDK myTarget iOS phiên bản 4.7.7.

Phiên bản 1.1.0

  • Hỗ trợ SDK myTarget Android phiên bản 4.7.2.
  • Hỗ trợ myTarget iOS SDK phiên bản 4.7.6.

Phiên bản 1.0.0

  • Bản phát hành đầu tiên!
  • Hỗ trợ myTarget SDK Android phiên bản 4.6.27.
  • Hỗ trợ myTarget iOS SDK phiên bản 4.6.24.