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

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

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

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

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

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

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

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

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

Java

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 بنجاح:

Java

@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

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

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

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

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

Java

@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) الذي يتفاعل معه محوّل الإشارات الآمنة:

Java

@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():

Java

@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().

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

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