الخطوة 3: التعامل مع قيم معلمات Remote Config في رمز تطبيقك
مقدمة: اختبر اعتماد شكل إعلان AdMob الجديد باستخدام Firebase |
الخطوة 1: استخدم AdMob لإنشاء متغير جديد للوحدة الإعلانية للاختبار |
الخطوة 2: قم بإعداد اختبار A / B في وحدة تحكم Firebase |
الخطوة 3: التعامل مع قيم معلمات Remote Config في رمز تطبيقك |
الخطوة 4: ابدأ اختبار A / B وراجع نتائج الاختبار في وحدة تحكم Firebase |
الخطوة 5: قرر ما إذا كنت تريد طرح شكل الإعلان الجديد |
في نهاية الخطوة الأخيرة ، قمت بإنشاء معلمة تكوين عن بُعد ( SHOW_NEW_AD_KEY
). في هذه الخطوة ، ستضيف المنطق إلى رمز التطبيق الخاص بك لما يجب أن يعرضه تطبيقك بناءً على قيمة هذه المعلمة - true
(عرض الإعلان الجديد) مقابل false
( لا تعرض الإعلان الجديد).
أضف حزم SDK المطلوبة
قبل استخدام Remote Config في رمز التطبيق الخاص بك ، أضف Remote Config SDK و Firebase SDK لـ Google Analytics إلى ملفات إنشاء مشروعك.
سويفت
قم بإضافة وتثبيت الكبسولات التالية في ملفك:
pod 'Google-Mobile-Ads-SDK'
pod 'Firebase/Analytics'
pod 'Firebase/RemoteConfig'
ج موضوعية
قم بإضافة وتثبيت الكبسولات التالية في ملفك:
pod 'Google-Mobile-Ads-SDK'
pod 'Firebase/Analytics'
pod 'Firebase/RemoteConfig'
Java
أضف تبعيات المكتبة التالية إلى ملف build.gradle
الخاص بك:
implementation 'com.google.android.gms:play-services-ads:22.1.0'
implementation 'com.google.firebase:firebase-analytics:21.3.0'
implementation 'com.google.firebase:firebase-config:21.4.0'
Kotlin+KTX
أضف تبعيات المكتبة التالية إلى ملف build.gradle
الخاص بك:
implementation 'com.google.android.gms:play-services-ads:22.1.0'
implementation 'com.google.firebase:firebase-analytics-ktx:21.3.0'
implementation 'com.google.firebase:firebase-config-ktx:21.4.0'
وحدة
قم بتنزيل وتثبيت Firebase Unity SDK ، ثم أضف حزم Unity التالية إلى مشروعك:
-
FirebaseAnalytics.unitypackage
-
FirebaseRemoteConfig.unitypackage
تكوين مثيل التكوين البعيد
لاستخدام قيم معلمات Remote Config ، قم بتكوين مثيل Remote Config بحيث يتم إعداده لجلب القيم الجديدة لمثيل تطبيق العميل.
في هذا المثال ، تم تكوين 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");
}
إحضار وتنشيط Remote Config
قم بإحضار وتنشيط معلمات Remote Config بحيث يمكن البدء في استخدام قيم المعلمات الجديدة.
ستحتاج إلى إجراء هذه المكالمة في أقرب وقت ممكن في مرحلة تحميل تطبيقك لأن هذه المكالمة غير متزامنة وستحتاج إلى جلب قيمة Remote Config مسبقًا حتى يعرف تطبيقك ما إذا كان سيعرض الإعلان أم لا.
سويفت
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 ومراجعة نتائج الاختبار