Nếu có SDK của nhà cung cấp tín hiệu tạo ra tín hiệu đặt giá thầu theo thời gian thực (RTB), bạn có thể phát triển một bộ chuyển đổi tín hiệu an toàn để cho phép Google Mobile Ads SDK thu thập tín hiệu từ SDK của bạn.
Google Mobile Ads SDK chuyển tiếp tín hiệu của bạn đến những người mua tham gia đã chọn trong Authorized Buyers và Đặt giá thầu mở.
Sơ đồ sau đây minh hoạ vòng đời yêu cầu-phản hồi cho việc thu thập tín hiệu an toàn:
Bộ chuyển đổi tín hiệu an toàn chịu trách nhiệm khởi chạy bộ chuyển đổi và thu thập tín hiệu.
Triển khai bộ chuyển đổi tín hiệu an toàn
Triển khai bộ chuyển đổi tín hiệu an toàn cho Google Mobile Ads SDK để thu thập tín hiệu từ SDK của bạn.
Hướng dẫn này trình bày cách triển khai bộ chuyển đổi tín hiệu an toàn bằng cách triển khai giao thức GADRTBAdapter.
Ví dụ sau đây
triển khai giao thức GADRTBAdapter:
Objective-C
@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end
Khởi chạy bộ chuyển đổi
Google Mobile Ads SDK gọi phương thức setUpWithConfiguration:completionHandler: khi Google Mobile Ads SDK tạo thực thể cho bộ chuyển đổi tín hiệu an toàn. Hãy sử dụng phương thức này để
khởi chạy SDK của bạn.
Khi SDK của bạn khởi chạy hoàn toàn và sẵn sàng để Google Mobile Ads SDK thu thập
tín hiệu, hãy gọi
khối hoàn thành GADMediationAdapterSetUpCompletionBlock.
Nếu bộ chuyển đổi tín hiệu an toàn không gọi lại, thì Google Mobile Ads SDK sẽ không thu thập tín hiệu từ bộ chuyển đổi tín hiệu an toàn.
Ví dụ sau đây gọi trình xử lý hoàn thành để thông báo cho Google Mobile Ads SDK rằng SDK của bạn đã khởi chạy thành công:
Objective-C
+ (void)setUpWithConfiguration:(GADMediationServerConfiguration *)configuration
completionHandler:(GADMediationAdapterSetUpCompletionBlock)completionHandler {
// Add your SDK initialization logic here.
// Invoke the completionHandler once initialization completes. Pass a nil
// error to indicate initialization succeeded.
completionHandler(nil);
}
Báo cáo phiên bản bộ chuyển đổi và SDK
Bộ chuyển đổi tín hiệu an toàn phải báo cáo cả phiên bản bộ chuyển đổi và phiên bản SDK. Google Mobile Ads SDK sử dụng các phiên bản này để báo cáo và khắc phục sự cố.
Nếu SDK của bạn triển khai bộ chuyển đổi này trong cùng một tệp nhị phân, thì bạn có thể trả về cùng một phiên bản cho cả phiên bản bộ chuyển đổi và phiên bản SDK.
Ví dụ sau đây trả về phiên bản của bộ chuyển đổi tín hiệu an toàn:
Objective-C
+ (GADVersionNumber)adapterVersion {
// If your secure signals SDK implements this adapter in the same binary
// return the same version as your SDK.
// return [self adSDKVersion];
// If you built a separate binary for this secure signals adapter, return
// the adapter's version here.
GADVersionNumber version = {};
version.majorVersion = 4;
version.minorVersion = 5;
version.patchVersion = 6;
return version;
}
Ví dụ sau đây trả về phiên bản SDK mà bộ chuyển đổi tín hiệu an toàn của bạn tương tác:
Objective-C
Thay thế kSDKVersionString bằng chuỗi phiên bản SDK của bạn.
Thu thập tín hiệu
Đối với mỗi yêu cầu quảng cáo, Google Mobile Ads SDK sẽ thu thập tín hiệu đồng thời từ tất cả bộ chuyển đổi trên một luồng nền.
Ví dụ sau đây thu thập và trả về tín hiệu cho Google Mobile Ads SDK
bằng cách gọi trình xử lý hoàn tất GADRTBSignalCompletionHandler:
Objective-C
Thay thế kSampleSignalPlaceholder bằng chuỗi tín hiệu an toàn của bạn.
Quá trình thu thập tín hiệu phải hoàn tất trong vòng một giây. Nếu quá trình thu thập tín hiệu mất hơn một giây, hãy cân nhắc việc lưu tín hiệu vào bộ nhớ đệm trong bộ chuyển đổi tín hiệu an toàn hoặc SDK khi bạn khởi chạy bộ chuyển đổi.
Nếu bộ chuyển đổi tín hiệu an toàn không thu thập được tín hiệu,
hãy gọi trình xử lý hoàn thành bằng tín hiệu nil và đối tượng NSError.
Làm rối tín hiệu
Khi chia sẻ tín hiệu an toàn với bên đặt giá thầu và đối tác tuyển chọn, bạn phải làm rối mã nguồn của các tín hiệu đó.
Trả về giá trị nil cho các phần bổ sung của mạng quảng cáo
Bộ chuyển đổi tín hiệu an toàn không yêu cầu thêm tham số bổ sung cho mạng.
Phương thức +networkExtrasClass trong ví dụ sau đây trả về một giá trị nil:
Objective-C
+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
// Network extras are not applicable because signal providers do not request ads.
return nil;
}