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

إذا كانت لديك حزمة تطوير برامج (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

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

يستدعي 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);
}

الإبلاغ عن إصدار المحوِّل وحزمة 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;
}

يعرض المثال التالي إصدار حزمة تطوير البرامج (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;
}

استبدِل 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);
}

استبدِل 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;
}