البرنامج التعليمي: اختبار اعتماد أشكال إعلانات AdMob الجديدة

الخطوة 3: التعامل مع قيم معلمات التكوين عن بعد في كود التطبيق الخاص بك


المقدمة: اختبار اعتماد شكل إعلان AdMob الجديد باستخدام Firebase
الخطوة 1: استخدم AdMob لإنشاء متغير جديد للوحدة الإعلانية للاختبار
الخطوة 2: إعداد اختبار أ/ب في وحدة تحكم Firebase

الخطوة 3: التعامل مع قيم معلمات التكوين عن بعد في كود التطبيق الخاص بك

الخطوة 4: ابدأ اختبار أ/ب وراجع نتائج الاختبار في وحدة تحكم Firebase
الخطوة 5: تحديد ما إذا كنت تريد طرح شكل الإعلان الجديد أم لا


في نهاية الخطوة الأخيرة، قمت بإنشاء معلمة التكوين عن بعد ( SHOW_NEW_AD_KEY ). في هذه الخطوة، ستضيف المنطق إلى رمز تطبيقك لما يجب أن يعرضه تطبيقك استنادًا إلى قيمة تلك المعلمة - true (عرض الإعلان الجديد) مقابل false ( لا تعرض الإعلان الجديد).

أضف حزم SDK المطلوبة

قبل استخدام Remote Config في رمز التطبيق الخاص بك، أضف كلاً من Remote Config SDK وFirebase SDK لـ Google Analytics إلى ملفات بناء مشروعك.

منصات أبل

قم بإضافة وتثبيت القرون التالية في ملف podfile الخاص بك:

pod 'Google-Mobile-Ads-SDK'
pod 'Firebase/Analytics'
pod 'Firebase/RemoteConfig'

ذكري المظهر

أضف تبعيات المكتبة التالية إلى ملف build.gradle الخاص بك:

implementation 'com.google.android.gms:play-services-ads:23.0.0'
implementation 'com.google.firebase:firebase-analytics:21.6.1'
implementation 'com.google.firebase:firebase-config:21.6.3'

وحدة

قم بتنزيل Firebase Unity SDK وتثبيته، ثم قم بإضافة حزم Unity التالية إلى مشروعك:

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

تكوين مثيل التكوين عن بعد

لاستخدام قيم معلمات التكوين عن بعد، قم بتكوين مثيل التكوين عن بعد بحيث يتم إعداده لجلب قيم جديدة لمثيل تطبيق العميل.

في هذا المثال، تم تكوين Remote Config للتحقق من قيم المعلمات الجديدة مرة واحدة كل ساعة.

سويفت

remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings

ج موضوعية

self.remoteConfig = [FIRRemoteConfig remoteConfig];
FIRRemoteConfigSettings *remoteConfigSettings = [[FIRRemoteConfigSettings alloc] init];
remoteConfigSettings.minimumFetchInterval = 3600;
self.remoteConfig.configSettings = remoteConfigSettings;

Java

mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
        .setMinimumFetchIntervalInSeconds(3600)
        .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);

Kotlin+KTX

remoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
    minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)

وحدة

var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
var configSettings = new ConfigSettings {
  MinimumFetchInternalInMilliseconds =
        (ulong)(new TimeSpan(1, 0, 0).TotalMilliseconds)
};
remoteConfig.SetConfigSettingsAsync(configSettings)
        .ContinueWithOnMainThread(task => {
          Debug.Log("Config settings confirmed");
}

جلب وتفعيل التكوين عن بعد

قم بإحضار وتنشيط معلمات التكوين عن بعد حتى يتمكن من البدء في استخدام قيم المعلمات الجديدة.

ستحتاج إلى إجراء هذا الاتصال في أقرب وقت ممكن في مرحلة تحميل تطبيقك لأن هذا الاتصال غير متزامن وستحتاج إلى جلب قيمة التكوين عن بُعد مسبقًا حتى يعرف تطبيقك ما إذا كان سيعرض الإعلان أم لا.

سويفت

remoteConfig.fetch() { (status, error) -> Void in
  if status == .success {
    print("Config fetched!")
    self.remoteConfig.activate() { (changed, error) in
      // ...
    }
  } else {
    print("Config not fetched")
    print("Error: \(error?.localizedDescription ?? "No error available.")")
  }
  self.loadAdUnit()
}

ج موضوعية

[self.remoteConfig fetchWithCompletionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) {
    if (status == FIRRemoteConfigFetchStatusSuccess) {
        NSLog(@"Config fetched!");
      [self.remoteConfig activateWithCompletion:^(BOOL changed, NSError * _Nullable error) {
        // ...
      }];
    } else {
        NSLog(@"Config not fetched");
        NSLog(@"Error %@", error.localizedDescription);
    }
    [self loadAdUnit];
}];

Java

mFirebaseRemoteConfig.fetchAndActivate()
        .addOnCompleteListener(this, new OnCompleteListener<Boolean>() {
            @Override
            public void onComplete(@NonNull Task<Boolean> task) {
                if (task.isSuccessful()) {
                    boolean updated = task.getResult();
                    Log.d(TAG, "Config params updated: " + updated);
                } else {
                    Log.d(TAG, "Config params failed to update");
                }
                loadAdUnit();
            }
        });

Kotlin+KTX

remoteConfig.fetchAndActivate()
        .addOnCompleteListener(this) { task ->
            if (task.isSuccessful) {
                val updated = task.result
                Log.d(TAG, "Config params updated: $updated")
            } else {
                Log.d(TAG, "Config params failed to update")
            }
            loadAdUnit()
        }

وحدة

remoteConfig.FetchAndActivateAsync().ContinueWithOnMainThread(task => {
  if (task.IsFaulted) {
    Debug.LogWarning("Config params failed to update");
  } else {
    Debug.Log("Config params updated: " + task.Result);
  }
  LoadAdUnit();
});

أصبح تطبيقك الآن جاهزًا للتعامل مع معلمة Remote Config التي قمت بإنشائها أثناء اختبار A/B الذي تم إعداده مسبقًا في هذا البرنامج التعليمي.

استخدم قيمة معلمة التكوين عن بعد

استخدم قيمة Remote Config التي تم جلبها مسبقًا في وظيفة loadAdUnit() لتحديد ما إذا كان مثيل التطبيق يجب أن يُظهر (قيمة المعلمة true ) أو لا يُظهر (قيمة المعلمة false ) الوحدة الإعلانية البينية الجديدة بمكافأة.

سويفت

private func loadAdUnit() {
  let showNewAdFormat = remoteConfig["users"].boolValue
  if showNewAdFormat {
      // Load Rewarded Interstitial Ad.
      // This should load your new implemented ad unit
      // as per AdMob instructions (the first step of this tutorial).
  } else {
    // Show the existing ad unit.
  }
}

ج موضوعية

- (void)loadAdUnit {
    BOOL showAds = self.remoteConfig[@"SHOW_NEW_AD_KEY"].boolValue;
    if (showAds) {
      // Load Rewarded Interstitial Ad.
      // This should load your new implemented ad unit
      // per AdMob instructions (the first step of this tutorial).
    } else {
      // Show the existing ad unit.
    }
}

Java

private void loadAdUnit() {
    boolean showNewAdFormat =
      mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY);

    if (showNewAdFormat) {
      // Load Rewarded Interstitial Ad.
      // This should load your new implemented ad unit
      // per AdMob instructions (the first step of this tutorial).
    } else {
      // Show the existing ad unit.
    }
}

Kotlin+KTX

private fun loadAdUnit() {
  var showNewAdFormat = remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

  if (showNewAdFormat) {
      // Load Rewarded Interstitial Ad.
      // This should load your new implemented ad unit
      // per AdMob instructions (the first step of this tutorial).
    } else {
      // Show the existing ad unit.
    }
}

وحدة

void LoadAdUnit() {
  bool showNewAdFormat =
      remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue;

  if (showNewAdFormat) {
    // Load Rewarded Interstitial Ad (new implemented ad unit)
    // per AdMob instructions (the first step of this tutorial).
  } else {
    // Show the existing ad unit.
  }
}

أضف عمليات فحص أخرى لقيمة المعلمة

هناك مناطق أخرى في كود التطبيق الخاص بك حيث ستحتاج إلى التحقق من قيمة معلمة التكوين عن بعد لتحديد تجربة الإعلان التي سيتم تحميلها. على سبيل المثال، يمكنك أن تقرر ما إذا كنت تريد إعادة تحميل إعلان بعد أن ينتهي المستخدم من عرض الإعلان الحالي.

يجب إجراء استدعاءات الجلب والتنشيط أولاً للحصول على أي تغييرات في قيمة المعلمة - على سبيل المثال، إذا قررت إنهاء تجربة جديدة أو إنشائها.

من هناك، يمكنك دائمًا التحقق من قيمة المعلمة باستخدام الاستدعاءات التالية:

سويفت

remoteConfig["showNewAdKey"].boolValue

ج موضوعية

self.remoteConfig[@"SHOW_NEW_AD_KEY"].boolValue;

Java

mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Kotlin+KTX

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

وحدة

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

ستعرض هذه الاستدعاءات دائمًا نفس القيمة لمثيل التطبيق اعتمادًا على ما إذا تم وضعها في مجموعة التحكم أو مجموعة متغيرات الإعلان الجديدة، ما لم يتم إجراء أي تغييرات في وحدة تحكم Firebase التي تم جلبها وتنشيطها في الاستدعاءات السابقة.




الخطوة 2 : إعداد اختبار A/B في وحدة تحكم Firebase الخطوة 4 : بدء اختبار A/B ومراجعة نتائج الاختبار