توسعه دادن آداپتور سیگنال ایمن

اگر کیت توسعه نرم‌افزار ارائه‌دهنده سیگنال دارید که سیگنال‌های مناقصه هم‌زمان (RTB) تولید می‌کند، می‌توانید آداپتور سیگنال ایمنی توسعه دهید تا به Google Mobile Ads SDK اجازه دهید سیگنال‌ها را از کیت توسعه نرم‌افزار شما جمع‌آوری کند.

Google Mobile Ads SDK سیگنال‌های شما را به خریداران مجاز و خریداران مناقصه باز شرکت‌کننده منتخب بازارسال می‌کند.

نمودار زیر چرخه حیات درخواست-پاسخ را برای جمع‌آوری سیگنال ایمن نشان می‌دهد:

آداپتور سیگنال امن مسئول مقداردهی اولیه آداپتور و جمع‌آوری سیگنال است.

پیاده‌سازی آداپتور سیگنال ایمن

یک آداپتور نشان ایمن برای Google Mobile Ads SDK پیاده‌سازی کنید تا نشان‌ها را از کیت توسعه نرم‌افزار شما جمع‌آوری کند.

این راهنما نحوه پیاده‌سازی آداپتور سیگنال امن را با پیاده‌سازی پروتکل GADRTBAdapter پوشش می‌دهد.

مثال زیر پروتکل GADRTBAdapter را پیاده‌سازی می‌کند:

آبجکتیو-سی

@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end

مقداردهی اولیه آداپتور

Google Mobile Ads SDK روش setUpWithConfiguration:completionHandler: را هنگامی که Google Mobile Ads SDK نمونه‌ای از آداپتور سیگنال ایمن شما ایجاد می‌کند، فراخوانی می‌کند. از این روش برای مقداردهی اولیه کیت توسعه نرم‌افزارتان استفاده کنید.

وقتی کیت توسعه نرم‌افزار شما کاملاً مقداردهی اولیه شد و برای جمع‌آوری سیگنال‌ها توسط Google Mobile Ads SDK آماده بود، بلوک تکمیل GADMediationAdapterSetUpCompletionBlock را فراخوانی کنید.

اگر آداپتور سیگنال‌های امن شما تماس برگشتی برقرار نکند، Google Mobile Ads SDK سیگنال‌ها را از آداپتور سیگنال امن شما جمع‌آوری نمی‌کند.

مثال زیر تکمیل را فراخوانی می‌کند گرداننده برای اطلاع دادن به Google Mobile Ads SDK که کیت توسعه نرم‌افزار شما باموفقیت مقداردهی اولیه شده است:

آبجکتیو-سی

+ (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);
}

گزارش نسخه کیت توسعه نرم‌افزار و آداپتور

آداپتور سیگنال ایمن شما باید هم نسخه آداپتور و هم نسخه کیت توسعه نرم‌افزار شما را گزارش کند. Google Mobile Ads SDK از این نسخه‌ها برای گزارش‌دهی و عیب‌یابی استفاده می‌کند.

اگر کیت توسعه نرم‌افزار شما این آداپتور را در همان باینری پیاده‌سازی می‌کند، می‌توانید همان نسخه را برای هر دو نسخه آداپتور و کیت توسعه نرم‌افزار برگردانید.

مثال زیر نسخه آداپتور سیگنال ایمن شما را برمی‌گرداند:

آبجکتیو-سی

+ (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;
}

مثال زیر نسخه کیت توسعه نرم‌افزار شما را که آداپتور سیگنال ایمن شما با آن تعامل دارد برمی‌گرداند:

آبجکتیو-سی

+ (GADVersionNumber)adSDKVersion {
  // Return your SDK's version string here.
  NSString *versionString = kSDKVersionString;
  NSArray<NSString *> *components = [versionString componentsSeparatedByString:@"."];
  GADVersionNumber version = {};
  if (components.count == 3) {
    version.majorVersion = components[0].integerValue;
    version.minorVersion = components[1].integerValue;
    version.patchVersion = components[2].integerValue;
  } else {
    NSLog(@"Unexpected version string: %@. Returning 0.0.0 for adSDKVersion.", versionString);
  }
  return version;
}

kSDKVersionString را با رشته نسخه کیت توسعه نرم‌افزار خودتان جایگزین کنید.

جمع‌آوری نشان‌ها

در هر درخواست آگهی، Google Mobile Ads SDK به‌طور هم‌زمان سیگنال‌ها را از همه آداپتورها در رشته پس‌زمینه جمع‌آوری می‌کند.

مثال زیر سیگنال‌ها را جمع‌آوری می‌کند و با فراخوانی گرداننده تکمیل GADRTBSignalCompletionHandler، آن‌ها را به Google Mobile Ads SDK برمی‌گرداند:

آبجکتیو-سی

- (void)collectSignalsForRequestParameters:(GADRTBRequestParameters *)params
                         completionHandler:(GADRTBSignalCompletionHandler)handler {
  // Add your signal collection logic here.
  NSString *signals = kSampleSignalPlaceholder;

  // Return the signals as a string to the Google Mobile Ads SDK.
  handler(signals, nil);
}

kSampleSignalPlaceholder را با رشته سیگنال امن خودتان جایگزین کنید.

جمع‌آوری سیگنال باید ظرف یک ثانیه تکمیل شود. اگر جمع‌آوری سیگنال بیشتر از یک ثانیه طول می‌کشد، هنگام راه‌اندازی آداپتور، سیگنال‌ها را در آداپتور سیگنال ایمن یا کیت توسعه نرم‌افزار خود ذخیره کنید.

اگر آداپتور سیگنال ایمن شما نتواند سیگنال‌ها را جمع‌آوری کند، گرداننده تکمیل را با سیگنال‌های nil و شیء NSError فراخوانی کنید.

مبهم کردن نشان‌ها

وقتی نشان‌های امن را با پیشنهاددهندگان قیمت و شرکای سازمان‌دهی هم‌رسانی می‌کنید، باید نشان‌ها را مبهم کنید.

مقدار nil را برای موارد اضافی شبکه آگهی برگردانید

آداپتورهای نشان امن به پارامترهای اضافی شبکه نیاز ندارند.

روش +networkExtrasClass زیر مقدار nil را برمی‌گرداند:

آبجکتیو-سی

+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
  // Network extras are not applicable because signal providers do not request ads.
  return nil;
}