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

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

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

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

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

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

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

يتناول هذا الدليل كيفية تنفيذ أداة ربط الإشارات الآمنة من خلال توسيع الفئة المجردة RtbAdapter.

يوضّح المثال التالي كيفية توسيع الفئة المجردة RtbAdapter:

جافا

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

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

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

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

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

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

جافا

@Override
public void initialize(
    Context context,
    InitializationCompleteCallback initializationCompleteCallback,
    List<MediationConfiguration> configurations) {

  // Add your SDK initialization logic here.

  // Invoke the InitializationCompleteCallback once initialization completes.
  initializationCompleteCallback.onInitializationSucceeded();
}
SampleAdapterSnippets.java

ملاحظة: يجب إكمال عملية الإعداد في غضون 30 ثانية. لا تستدعي Google Mobile Ads SDK هذه الطريقة إلا مرة واحدة لكل جلسة.

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

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

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

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

جافا

@Override
public VersionInfo getVersionInfo() {
  // If your SDK implements this adapter in the same binary, return
  // the same version as your SDK.
  // return getSDKVersionInfo();

  // If you built a separate binary for this adapter, return
  // the adapter's version here.
  int major = 4;
  int minor = 5;
  int micro = 6;
  return new VersionInfo(major, minor, micro);
}
SampleAdapterSnippets.java

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

جافا

@Override
public VersionInfo getSDKVersionInfo() {

  // Return your SDK's version string here.
  String versionString = SDK_VERSION_STRING;
  String[] splits = versionString.split("\\.");
  if (splits.length >= 3) {
    try {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    } catch (NumberFormatException e) {
      // Fall through to log warning and return 0.0.0.
    }
  }

  Log.w(
      TAG,
      String.format(
          "Unexpected SDK version format: %s. Returning 0.0.0 for SDK version.", versionString));
  return new VersionInfo(0, 0, 0);
}
SampleAdapterSnippets.java

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

جمع الإشارات

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

يجمع المثال التالي الإشارات ويعرضها على Google Mobile Ads SDK من خلال استدعاء الطريقة SignalCallbacks.onSuccess():

جافا

@Override
public void collectSignals(RtbSignalData rtbSignalData, SignalCallbacks signalCallbacks) {

  // Add your signal collection logic here.
  String signals = SAMPLE_SIGNAL_PLACEHOLDER;

  // Return the signals as a string to the Google Mobile Ads SDK.
  signalCallbacks.onSuccess(signals);
}
SampleAdapterSnippets.java

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

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

إذا تعذّر على أداة ربط الإشارات الآمنة جمع الإشارات، مرِّر خطأ إلى الطريقة signalCallbacks.onFailure().

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

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