تطوير أداة ربط إشارات آمنة

إذا كانت لديك حزمة SDK لمقدّم إشارات تنشئ إشارات لعرض الأسعار في الوقت الفعلي (RTB)، يمكنك تطوير محوّل إشارات آمنة للسماح لـ Google Mobile Ads SDK بجمع الإشارات من حزمة SDK.

تعيد Google Mobile Ads SDK توجيه إشاراتك إلى مشترين محدّدين مشاركين في الشراة المعتمَدون وعرض الأسعار المفتوح.

يوضّح الرسم البياني التالي دورة حياة طلب الردّ لعملية جمع الإشارات الآمنة:

يكون محوّل الإشارات الآمنة مسؤولاً عن إعداد المحوّل وجمع الإشارات.

تنفيذ أداة ربط إشارات آمنة

نفِّذ محوّلاً للإشارات الآمنة في Google Mobile Ads SDK لجمع الإشارات من حزمة تطوير البرامج (SDK).

يشرح هذا الدليل كيفية تنفيذ أداة ربط إشارات آمنة من خلال تنفيذ بروتوكول GADRTBAdapter.

ينفّذ المثال التالي بروتوكول GADRTBAdapter:

Objective-C

@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end
SampleAdapterSnippets.m

إعداد المحوّل

تستدعي Google Mobile Ads SDK الطريقة setUpWithConfiguration:completionHandler: عندما تنشئ Google Mobile Ads SDK مثيلاً لمحوّل الإشارة الآمنة. استخدِم هذه الطريقة لتهيئة حزمة SDK.

عندما يتم إعداد حزمة SDK بالكامل وتصبح جاهزة لجمع الإشارات من Google Mobile Ads SDK، عليك استدعاء وحدة إكمال GADMediationAdapterSetUpCompletionBlock.

إذا لم يتم استدعاء محوّل الإشارات الآمنة، لن تجمع Google Mobile Ads SDK الإشارات من محوّل الإشارات الآمنة.

يستدعي المثال التالي معالج الإكمال لإعلام Google Mobile Ads SDK بأنّه تم إعداد حزمة SDK بنجاح:

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);
}
SampleAdapterSnippets.m

الإبلاغ عن إصدار المحوّل وحزمة تطوير البرامج (SDK)

يجب أن يبلّغ محوّل الإشارات الآمنة عن كلّ من إصدار المحوّل وإصدار حزمة SDK. تستخدم Google Mobile Ads SDK هذه الإصدارات لإعداد التقارير وتحديد المشاكل وحلّها.

إذا كانت حزمة تطوير البرامج (SDK) تنفّذ هذا المحوّل في الرمز الثنائي نفسه، يمكنك عرض الإصدار نفسه لكل من المحوّل وإصدارات حزمة تطوير البرامج (SDK).

يعرض المثال التالي إصدار محوّل الإشارة الآمنة:

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;
}
SampleAdapterSnippets.m

يعرض المثال التالي إصدار حزمة تطوير البرامج (SDK) الذي يتفاعل معه محوّل الإشارات الآمنة:

Objective-C

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

استبدِل kSDKVersionString بسلسلة إصدار حزمة SDK.

جمع الإشارات

في كل طلب إعلان، تجمع Google Mobile Ads SDK الإشارات في الوقت نفسه من جميع المحوّلات البرمجية على سلسلة الخلفية.

يجمع المثال التالي الإشارات ويعرضها على Google Mobile Ads SDK من خلال استدعاء معالج الإكمال GADRTBSignalCompletionHandler:

Objective-C

- (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);
}
SampleAdapterSnippets.m

استبدِل kSampleSignalPlaceholder بسلسلة الإشارات الآمنة.

يجب أن يكتمل جمع الإشارات في غضون ثانية واحدة. إذا استغرق جمع الإشارات أكثر من ثانية واحدة، ننصحك بتخزين الإشارات مؤقتًا في محوّل الإشارات الآمنة أو في حزمة تطوير البرامج (SDK) عند إعداد المحوّل.

إذا تعذّر على محوّل الإشارات الآمنة جمع الإشارات، عليك استدعاء معالج الإكمال مع إشارات nil وكائن NSError.

تشويش الإشارات

عند مشاركة الإشارات الآمنة مع مقدّمي عروض الأسعار وشركاء الخدمات المختارة، يجب إخفاء الإشارات.

إرجاع قيمة nil لإضافات شبكة الإعلانات

لا تتطلّب برامج ربط الإشارات الآمنة مَعلمات إضافية لشبكة إضافات.

تعرض طريقة +networkExtrasClass التالية قيمة nil:

Objective-C

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