الخطوة 3: التعامل مع قيم معلمات التكوين عن بعد في كود التطبيق الخاص بك
المقدمة: تحسين معدل تكرار إعلانات AdMob باستخدام Firebase |
الخطوة 1: استخدم AdMob لإنشاء متغيرات جديدة للوحدة الإعلانية للاختبار |
الخطوة 2: إعداد اختبار أ/ب في وحدة تحكم Firebase |
الخطوة 3: التعامل مع قيم معلمات التكوين عن بعد في كود التطبيق الخاص بك |
الخطوة 4: ابدأ اختبار أ/ب وراجع نتائج الاختبار في وحدة تحكم Firebase |
الخطوة 5: تحديد ما إذا كنت تريد طرح شكل الإعلان الجديد أم لا |
في نهاية الخطوة الأخيرة، قمت بإنشاء معلمة التكوين عن بعد ( INTERSTITIAL_AD_KEY
). في هذه الخطوة، ستضيف المنطق إلى رمز تطبيقك لما يجب أن يعرضه تطبيقك بناءً على قيمة تلك المعلمة.
أضف حزم SDK المطلوبة
قبل استخدام Remote Config في رمز التطبيق الخاص بك، أضف كلاً من Remote Config SDK وFirebase SDK لـ Google Analytics إلى ملفات إنشاء مشروعك.
سويفت
قم بإضافة وتثبيت القرون التالية في ملف podfile الخاص بك:
pod 'Google-Mobile-Ads-SDK'
pod 'Firebase/Analytics'
pod 'Firebase/RemoteConfig'
ج موضوعية
قم بإضافة وتثبيت القرون التالية في ملف 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()
لتحديد متغير تكرار الإعلان الذي يجب أن يظهر لمثيل التطبيق هذا.
سويفت
private func loadAdUnit() {
let adUnitId = remoteConfig["INTERSTITIAL_AD_KEY"].stringValue;
let request = GADRequest()
GADInterstitialAd.load(withAdUnitID: adUnitId,
request: request,
completionHandler: { [self] ad, error in
if let error = error {
print("Failed to load: \(error.localizedDescription)")
return
}
interstitial = ad
// Register for callbacks.
}
)
}
// Register for callbacks.
ج موضوعية
- (void)loadAdUnit {
NSString *adUnitId =
self.remoteConfig[@"INTERSTITIAL_AD_KEY"].stringValue;
GADRequest *request = [GADRequest request];
[GADInterstitialAd loadAdWithAdUnitId:adUnitId
request:request
completionHandler:^(GADInterstitialAd *ad,
NSError *error) {
if (error) {
NSLog(@"Failed to load interstitial ad with error: %@",
[error localizedDescription]);
return;
}
self.interstitial = ad;
}];
}
Java
private void loadAdUnit() {
String adUnitId =
mFirebaseRemoteConfig.getString("INTERSTITIAL_AD_KEY");
// Load Interstitial Ad (assume adUnitId not null)
AdRequest adRequest = new AdRequest.Builder().build();
InterstitialAd.load(this, adUnitId, adRequest, new
InterstitialAdLoadCallback() {
@Override
public void onAdLoaded(@NonNull InterstitialAd intertitialAd) {
mInterstitialAd = interstitialAd;
}
@Override
public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
mInterstitialAd = null;
}
});
}
Kotlin+KTX
private fun loadAdUnit() {
String adUnitId = remoteConfig.getString("INTERSTITIAL_AD_KEY")
var adRequest = AdRequestBuilder.Builder().build()
AdRequestBuilder.load(this, adUnitId, adRequest, object :
InterstitialAdLoadCallback() {
override fun onAdFailedToLoad(adError: LoadAdError) {
mInterstitialAd = null
}
override fun onAdLoaded(interstitialAd: InterstitialAd) {
mInterstitialAd = interstitialAd
}
})
}
وحدة
void LoadAdUnit() {
// Note that you may want to encode and parse two sets of ad unit IDs for
// Android / iOS in the Unity implementation.
String adUnitId = remoteConfig.GetValue("INTERSTITIAL_AD_KEY").StringValue;
this.interstitial = new InterstitialAd(adUnitId);
}
أضف عمليات فحص أخرى لقيمة المعلمة
هناك مناطق أخرى في كود التطبيق الخاص بك حيث ستحتاج إلى التحقق من قيمة معلمة التكوين عن بعد لتحديد تجربة الإعلان التي سيتم تحميلها. على سبيل المثال، يمكنك أن تقرر ما إذا كنت تريد إعادة تحميل إعلان بعد أن ينتهي المستخدم من عرض الإعلان الحالي.
يجب إجراء استدعاءات الجلب والتنشيط أولاً للحصول على أي تغييرات في قيمة المعلمة - على سبيل المثال، إذا قررت إنهاء تجربة جديدة أو إنشائها.
من هناك، يمكنك دائمًا التحقق من قيمة المعلمة باستخدام الاستدعاءات التالية:
سويفت
remoteConfig["INTERSTITIAL_AD_KEY"].stringValue
ج موضوعية
self.remoteConfig[@"INTERSTITIAL_AD_KEY"].stringValue;
Java
mFirebaseRemoteConfig.getString(INTERSTITIAL_AD_KEY)
Kotlin+KTX
remoteConfig.getString(INTERSTITIAL_AD_KEY)
وحدة
remoteConfig.GetValue("INTERSTITIAL_AD_KEY").StringValue
ستعرض هذه الاستدعاءات دائمًا نفس القيمة لمثيل التطبيق اعتمادًا على ما إذا تم وضعها في مجموعة التحكم أو إحدى مجموعات متغيرات الإعلان الجديدة، ما لم يتم إجراء أي تغييرات في وحدة تحكم Firebase التي تم جلبها وتنشيطها في الاستدعاءات السابقة.
الخطوة 2 : إعداد اختبار A/B في وحدة تحكم Firebaseالخطوة 4 : بدء اختبار A/B ومراجعة نتائج الاختبار