Bộ thử nghiệm dàn xếp

Bộ thử nghiệm dàn xếp Quảng cáo trên thiết bị di động của Google cho phép bạn kiểm tra xem bạn đã định cấu hình ứng dụng và các đơn vị quảng cáo của mình đúng cách để có thể hiển thị quảng cáo từ các mạng bên thứ ba thông qua nền tảng dàn xếp hay chưa.  Hướng dẫn này trình bày cách sử dụng Bộ thử nghiệm dàn xếp Quảng cáo trên thiết bị di động của Google trong ứng dụng iOS bằng cách tích hợp công cụ này vào ứng dụng của bạn.

Điều kiện tiên quyết

  • Sử dụng Xcode 11 trở lên.
  • Nhắm mục tiêu phiên bản iOS 8.0 trở lên.
  • Đảm bảo bạn đã nhập chính xác mã ứng dụng trong Info.plist của mình.

Cài đặt

Bạn có thể sử dụng CocoaPods để cài đặt Bộ thử nghiệm dàn xếp. Để thực hiện việc này, hãy thêm dòng sau vào Podfile:

pod 'GoogleMobileAdsMediationTestSuite'

Thao tác này sẽ định cấu hình bộ thử nghiệm cũng như các phần phụ thuộc Thành phần quan trọng bắt buộc. Hãy chạy pod install để hoàn tất việc cài đặt.

Chạy Bộ thử nghiệm dàn xếp

Trước tiên, hãy nhập khung để hiển thị công cụ:

Swift

import GoogleMobileAdsMediationTestSuite

Objective-C

@import GoogleMobileAdsMediationTestSuite;

Tiếp theo, sau khi chế độ xem của bạn xuất hiện, hãy hiển thị bộ thử nghiệm như sau:

Swift


GoogleMobileAdsMediationTestSuite.presentForAdManager(on:self, delegate:nil)

Objective-C


[GoogleMobileAdsMediationTestSuite presentForAdManagerOnViewController:self delegate:nil];

Phương thức ủy quyền tùy chọn này thông báo cho bạn khi Bộ thử nghiệm dàn xếp bị loại bỏ. Để triển khai lệnh gọi lại ủy quyền, bạn hãy tuân thủ giao thức GMTSMediationTestSuiteDelegate và triển khai phương thức mediationTestSuiteWasDismissed.

Công cụ này sẽ mở ra kèm theo lời tuyên bố từ chối trách nhiệm sau:

Đánh dấu vào hộp và nhấn vào Đồng ý để tiếp tục.

Sau đó, bạn sẽ nhìn thấy một danh sách đơn vị quảng cáo cho tài khoản của mình. Danh sách này được chia thành 2 thẻ: Đơn vị quảng cáo hoạt động sai cáchĐơn vị quảng cáo đang hoạt động.

Đăng ký thiết bị thử nghiệm

Nếu thiết bị của bạn chưa được đăng ký trong giao diện người dùng AdMob làm thiết bị thử nghiệm, thì bạn sẽ thấy lời nhắc hỏi xem bạn có muốn đăng ký thiết bị của mình làm thiết bị thử nghiệm hay không:

Việc đăng ký thiết bị làm thiết bị thử nghiệm sẽ thay đổi hành vi sau đây trong Bộ thử nghiệm dàn xếp:

  • Cho phép bạn xem tên đơn vị quảng cáo thay vì mã đơn vị quảng cáo trong giao diện người dùng của Bộ thử nghiệm.
  • Cho phép bạn tìm kiếm theo tên đơn vị quảng cáo (ngoài mã đơn vị quảng cáo) trên màn hình thông tin chi tiết về đơn vị quảng cáo.
  • Cho phép thiết bị của bạn nhận quảng cáo thử nghiệm từ AdMob.

Việc nhấp vào mục Đăng ký thiết bị sẽ đưa bạn đến trang Đăng ký thiết bị thử nghiệm trong Giao diện người dùng AdMob, với nền tảng thiết bị và mã thiết bị được điền sẵn từ Bộ thử nghiệm dàn xếp. Thêm tên cho thiết bị thử nghiệm và nhấp vào Lưu, sau đó thiết bị của bạn sẽ được đăng ký. Hãy xem bài viết Thiết lập thiết bị thử nghiệm để biết thêm hướng dẫn.

Thiết bị được đăng ký thường sẽ hoạt động trong Bộ thử nghiệm dàn xếp trong vòng 15 phút, nhưng cũng có thể mất đến 24 giờ. Để xem các thay đổi, hãy đóng và mở lại Bộ thử nghiệm dàn xếp.

Bạn cần phải đăng nhập vào tài khoản AdMob của mình để truy cập vào trang Đăng ký thiết bị thử nghiệm. Nếu bạn không có quyền truy cập tài khoản nhưng vẫn muốn thêm thiết bị bằng phương pháp này, hãy nhấp vào đường liên kết này và sau đó chia sẻ URL với chủ sở hữu tài khoản từ trình duyệt mở ra. Sau đó, họ có thể nhấp vào đường liên kết và đăng ký thiết bị của bạn trong tài khoản này thay cho bạn.

Nếu bạn không muốn đăng ký thiết bị thử nghiệm tại thời điểm này, hãy nhấn vào Bỏ qua.

Đơn vị quảng cáo hoạt động sai cách

Danh sách Đơn vị quảng cáo hoạt động sai cách được phân tách thành Các thành phần còn thiếuCác lỗi cấu hình:

Sau khi thử nghiệm thành công tất cả các mạng của một đơn vị quảng cáo, đơn vị quảng cáo đó sẽ chuyển từ thẻ Không hoạt động sang thẻ Đang hoạt động. Nếu bạn không thấy danh sách các đơn vị quảng cáo, thì có thể là do lệnh gọi mạng không thành công hoặc không tìm thấy đơn vị quảng cáo.

Nếu bạn muốn tìm kiếm danh sách các đơn vị quảng cáo, hãy nhấn vào biểu tượng tìm kiếm ở trên cùng và nhập chuỗi mã đơn vị quảng cáo. Bạn cũng có thể tìm kiếm theo tên mạng hoặc theo định dạng quảng cáo.

Đối với mỗi đơn vị quảng cáo, màn hình này sẽ đưa ra cảnh báo nếu:

  • SDK nguồn quảng cáo chưa được cài đặt
  • Bộ chuyển đổi nguồn quảng cáo chưa được cài đặt

Nếu có thể thử nghiệm, màn hình cũng hiển thị trạng thái kết quả thử nghiệm tổng thể cho tất cả nguồn quảng cáo.

Chọn một đơn vị quảng cáo để chuyển sang màn hình Thông tin về đơn vị quảng cáo.

Thông tin về đơn vị quảng cáo

Màn hình này hiển thị thông tin chi tiết về ad unit, (bao gồm mã nhận dạng ad unit và định dạng quảng cáo) và quy trình dàn xếp dạng thác nước được định cấu hình cho ad unit đó:

Lưu ý các khía cạnh sau đây trên màn hình này:

Nội dung tóm tắt nguồn quảng cáo

Đối với mỗi nguồn quảng cáo, chúng tôi có các chỉ báo cho biết bạn đã cài đặt SDK và bộ chuyển đổi hay chưa và kết quả của lần thử nghiệm gần đây nhất cho cấu hình này trong phiên hoạt động này.

Đối với các sự kiện tùy chỉnh, nhãn Sự kiện tùy chỉnh: custom event sẽ được sử dụng. Chỉ báo trạng thái của bộ chuyển đổi cho một sự kiện tùy chỉnh sẽ là số dương nếu hệ thống tìm thấy lớp mà bạn chỉ định cho sự kiện tùy chỉnh đó. Bạn có thể tải và xem quảng cáo cho các sự kiện tùy chỉnh theo cách tương tự như các mạng khác.

Tìm kiếm

Khi nhấn vào biểu tượng tìm kiếm, màn hình tìm kiếm sẽ hiển thị để bạn có thể tìm kiếm các nguồn quảng cáo theo tên.

Thử nghiệm theo lô

Bạn có thể chọn từng nguồn quảng cáo để thử nghiệm theo lô bằng cách đánh dấu vào hộp ở bên trái tên nguồn quảng cáo đó. Sau đó, một tùy chọn mới sẽ xuất hiện trong thanh điều hướng:

Nhấn vào nút Tải quảng cáo ở trên cùng bên phải để tải quảng cáo cho các nguồn quảng cáo đã chọn theo thứ tự. Chỉ báo tiến trình sẽ hiển thị trong thời gian diễn ra thử nghiệm. Khi bạn nhấn vào biểu tượng quay lại ở góc trên cùng bên trái, lựa chọn sẽ bị xóa.

Tải và hiển thị quảng cáo

Nhấn vào một mục nhập nguồn quảng cáo để xem màn hình thông tin chi tiết về nguồn quảng cáo đó:

Đối với một nguồn quảng cáo nhất định, màn hình sẽ cho biết:

  • SDK đã được cài đặt hay chưa và phiên bản của SDK (nếu có).
  • Bộ chuyển đổi đã được cài đặt hay chưa và phiên bản của bộ chuyển đổi (nếu có).
  • Trạng thái khởi tạo bộ chuyển đổi (nếu có).
  • Các thông số cho cấu hình đã được nhập trong bảng điều khiển AdMob.

Sau khi đã cài đặt tất cả các thành phần bắt buộc, bạn có thể tiến hành thử nghiệm việc tải quảng cáo. Hãy nhấn vào Tải quảng cáo để gửi một yêu cầu quảng cáo đến SDK của nguồn quảng cáo. Sau khi hoàn tất yêu cầu quảng cáo, bạn sẽ nhìn thấy một thông báo cho biết liệu yêu cầu đã thành công hay không thành công.

Nếu yêu cầu không thành công, hãy kiểm tra thông báo từ SDK được thử nghiệm trong nhật ký bảng điều khiển.

Nếu yêu cầu thành công:

  • Đối với quảng cáo biểu ngữ, quảng cáo sẽ hiển thị nội tuyến.
  • Đối với quảng cáo xen kẽ hoặc quảng cáo có tặng thưởng, bạn có thể hiển thị quảng cáo bằng cách nhấn vào Hiển thị quảng cáo.
  • Đối với quảng cáo gốc, các tài sản được trả lại được hiển thị nội tuyến.

    Quảng cáo sẽ mở trong một màn hình mới, ví dụ:

Khi bạn quay lại màn hình Chi tiết, kết quả của lần thử nghiệm quảng cáo gần đây nhất của bạn sẽ hiển thị trong màn hình danh sách ad unit. Các nguồn quảng cáo đã tải thành công sẽ được chuyển đến cuối danh sách hiển thị các nguồn quảng cáo cần thử nghiệm thêm.

Các đối tác Đặt giá thầu mở

Hãy xem Hướng dẫn xác minh thông tin thiết lập tính năng Đặt giá thầu mở để biết thông tin chi tiết về cách thử nghiệm tính năng Đặt giá thầu mở.

Cho phép thử nghiệm trong quá trình sản xuất

Theo mặc định, Bộ thử nghiệm dàn xếp sẽ chỉ khởi chạy trong các adhoc và phát triển có thể gỡ lỗi. Điều này nhằm ngăn người dùng cuối vô tình khởi chạy bộ thử nghiệm.

Nếu cần chạy Bộ thử nghiệm dàn xếp trên một thiết bị khi bạn đang tạo ứng dụng hãy đăng ký thiết bị của bạn làm thiết bị thử nghiệm thông qua SDK.

Khi đưa Bộ thử nghiệm dàn xếp vào trong ứng dụng đang tạo, bạn cần có một cách khởi chạy bộ thử nghiệm dàn xếp mà chỉ mình bạn biết (ví dụ: một thao tác bí mật hoặc trình đơn gỡ lỗi ẩn). Sau đó, bạn sẽ có thể chạy bộ thử nghiệm trên bất kỳ thiết bị nào nằm trong danh sách cho phép của bản dựng.

Định cấu hình yêu cầu quảng cáo bằng cách sử dụng tiện ích và dịch vụ đi kèm của mạng (không bắt buộc)

Một số mạng dàn xếp nhất định (chẳng hạn như Vungle) có tùy chọn cung cấp một gói đối tượng bổ sung tùy chỉnh cho mạng để cung cấp thêm thông tin cho các yêu cầu tới mạng đó.

Nếu cần cung cấp thông số bổ sung cho mạng để yêu cầu dàn xếp, thì bạn có thể thiết lập yêu cầu quảng cáo để bộ thử nghiệm sử dụng bằng cách dùng phương thức [GoogleAdsMediationTestSuite setAdRequest:] lớp :

Swift

let request = GADRequest()
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras object, call
// 'request.register(\)'
...
GoogleAdsMediationTestSuite.setAdRequest(request);

Objective-C

GADRequest request = [GADRequest request];
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras object, call
// '[request registerAdNetworkExtras:\];'
...
[GoogleAdsMediationTestSuite setAdRequest:request];

Bạn hãy nhớ thực hiện thao tác này trước khi khởi chạy Bộ thử nghiệm dàn xếp.

Việc này cho phép bạn nhanh chóng khởi tạo và định cấu hình một yêu cầu quảng cáo bằng cách sử dụng mọi thông số bổ sung bắt buộc, mà sau đó bộ thử nghiệm có thể sử dụng trong yêu cầu cho mạng được dàn xếp.

Cấu hình CocoaPods nâng cao (không bắt buộc, chỉ gỡ lỗi)

Nếu chỉ muốn bao gồm nhóm trong phiên bản gỡ lỗi của ứng dụng, bạn có thể chỉ định lựa chọn này trong Podfile của mình dưới dạng nhóm chỉ cho cấu hình bản dựng Debug. Bạn cũng cần bảo vệ mọi mã gọi công cụ này bằng câu lệnh #ifdef DEBUG hoặc câu lệnh tương tự.

Để chỉ bao gồm nhóm trong cấu hình Gỡ lỗi, hãy sử dụng dòng sau:

pod 'GoogleMobileAdsMediationTestSuite', :configurations => ['Debug'], :path => '/path/to/GoogleMobileAdsMediationTestSuite/'

Đảm bảo bao gồm tất cả các tệp tham chiếu đến khung và các lớp của khung đó thông qua #ifdef DEBUG:

Swift

import UIKit
#if DEBUG
import GoogleMobileAdsMediationTestSuite
#endif
import GoogleMobileAds

let APP_ID = "ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
    }

  @IBAction func presentMediationController(_ sender: AnyObject) {
      #if DEBUG
        GoogleMobileAdsMediationTestSuite.present(withAppId:APP_ID, on:self, delegate:nil)
      #endif
    }

Objective-C

#import "ViewController.h"
#ifdef DEBUG
@import GoogleMobileAdsMediationTestSuite;
#endif
#import <GoogleMobileAds/GoogleMobileAds.h>

static NSString *APP_ID = @"ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy";

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
}

- (IBAction)presentMediationController:(id)sender {
#ifdef DEBUG
    [GoogleMobileAdsMediationTestSuite presentWithAppId:APP_ID
                                       onViewController:self
                                               delegate:nil];
  }
#endif
}