מדריך: אופטימיזציה של תדירות המודעות ב-AdMob

שלב 3: טיפול בערכי הפרמטר Remote Config בקוד של האפליקציה


מבוא: אופטימיזציה של AdMob תדירות הצגת המודעות באמצעות Firebase
שלב 1: משתמשים ב-AdMob כדי ליצור גרסאות חדשות של יחידות מודעות לצורך בדיקה
שלב 2: מגדירים בדיקת A/B במסוף Firebase

שלב 3: טיפול בערכי הפרמטר Remote Config בקוד של האפליקציה

שלב 4: מתחילים את בדיקת ה-A/B ובודקים את תוצאות הבדיקה במסוף Firebase
שלב 5: מחליטים אם להשיק את פורמט המודעה החדש


בסוף השלב הקודם יצרתם פרמטר Remote Config (INTERSTITIAL_AD_KEY). בשלב הזה תוסיפו לקוד של האפליקציה את הלוגיקה של מה שהאפליקציה צריכה להציג על סמך הערך של הפרמטר הזה.

הוספת ערכות ה-SDK הנדרשות

לפני שמשתמשים ב-Remote Config בקוד האפליקציה, צריך להוסיף את Remote Config SDK ואת Firebase SDK ל-Google Analytics לקובצי ה-build של הפרויקט.

Swift

מוסיפים ומתקינים את ה-pods הבאים בקובץ ה-podfile:

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

Objective-C

מוסיפים ומתקינים את ה-pods הבאים בקובץ ה-podfile:

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

Android

מוסיפים את יחסי התלות הבאים של הספרייה לקובץ build.gradle:

implementation 'com.google.android.gms:play-services-ads:25.2.0'
implementation 'com.google.firebase:firebase-analytics:23.2.0'
implementation 'com.google.firebase:firebase-config:23.1.0'

Unity

מורידים ומתקינים את Firebase Unity SDK, ואז מוסיפים את חבילות Unity הבאות לפרויקט:

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

הגדרת מכונת Remote Config

כדי להשתמש בערכי הפרמטרים Remote Config, צריך להגדיר את המופע Remote Config כך שהוא יוגדר לאחזור ערכים חדשים עבור מופע אפליקציית הלקוח.

בדוגמה הזו, Remote Config מוגדר לבדוק אם יש ערכים חדשים של פרמטרים פעם בשעה.

Swift

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

Objective-C

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

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

Unity

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 כדי שהמערכת תדע איזו מודעה להציג באפליקציה.

Swift

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()
}

Objective-C

[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

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()
        }

Unity

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

משתמשים בערך Remote Config שאוחזר מראש בפונקציה loadAdUnit() כדי לקבוע איזה וריאנט של תדירות הצגת המודעות צריך להציג במופע האפליקציה הזה.

Swift

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.

Objective-C

- (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

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
      }
    })
}

Unity

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);
}

הוספת בדיקות אחרות לערך הפרמטר

יש אזורים אחרים בקוד האפליקציה שבהם תצטרכו לבדוק את הערך של הפרמטר Remote Config כדי לקבוע איזו חוויית צפייה במודעות תיטען. לדוגמה, אתם יכולים להחליט אם לטעון מחדש מודעה אחרי שהמשתמש סיים לצפות במודעה הנוכחית.

קודם צריך לבצע את הקריאות לאחזור ולהפעלה כדי לקבל שינויים בערכי הפרמטרים – לדוגמה, אם מחליטים לסיים ניסוי או ליצור ניסוי חדש.

מכאן, תמיד אפשר לבדוק את הערך של הפרמטר באמצעות הקריאות הבאות:

Swift

remoteConfig["INTERSTITIAL_AD_KEY"].stringValue

Objective-C

self.remoteConfig[@"INTERSTITIAL_AD_KEY"].stringValue;

Java

mFirebaseRemoteConfig.getString(INTERSTITIAL_AD_KEY)

Kotlin

remoteConfig.getString(INTERSTITIAL_AD_KEY)

Unity

remoteConfig.GetValue("INTERSTITIAL_AD_KEY").StringValue

הקריאות האלה תמיד יחזירו את אותו ערך עבור מופע של אפליקציה, בהתאם לשאלה אם המופע הוצב בקבוצת הבקרה או באחת מקבוצות וריאציות המודעות החדשות, אלא אם בוצעו שינויים במסוף Firebase שאוחזרו והופעלו בקריאות הקודמות.




שלב 2: הגדרת בדיקת A/B במסוף Firebase שלב 4: הפעלת בדיקת ה-A/B ובדיקת התוצאות