บทแนะนํา: ทดสอบการใช้รูปแบบโฆษณา AdMob ใหม่

ขั้นตอนที่ 3: จัดการค่าพารามิเตอร์การกำหนดค่าระยะไกลในโค้ดของแอป


บทนำ: ทดสอบการใช้รูปแบบโฆษณา AdMob ใหม่ด้วย Firebase
ขั้นตอนที่ 1: ใช้ AdMob เพื่อสร้างตัวแปรหน่วยโฆษณาใหม่สำหรับการทดสอบ
ขั้นตอนที่ 2: ตั้งค่าการทดสอบ A/B ในคอนโซล Firebase

ขั้นตอนที่ 3: จัดการค่าพารามิเตอร์การกำหนดค่าระยะไกลในโค้ดของแอป

ขั้นตอนที่ 4: เริ่มการทดสอบ A/B และตรวจสอบผลการทดสอบในคอนโซล Firebase
ขั้นตอนที่ 5: ตัดสินใจว่าจะเปิดตัวโฆษณารูปแบบใหม่หรือไม่


ในตอนท้ายของขั้นตอนสุดท้าย คุณสร้างพารามิเตอร์การกำหนดค่าระยะไกล (SHOW_NEW_AD_KEY) ในขั้นตอนนี้ คุณจะต้องเพิ่มตรรกะลงในโค้ดของแอปเพื่อดูว่าแอปควรแสดงอะไรตามค่าของพารามิเตอร์นั้น ซึ่งก็คือ true (แสดงโฆษณาใหม่) เทียบกับ false (อย่าแสดงโฆษณาใหม่)

เพิ่ม SDK ที่จำเป็น

ก่อนที่จะใช้การกำหนดค่าระยะไกลในโค้ดของแอปพลิเคชัน ให้เพิ่มทั้ง SDK การกำหนดค่าระยะไกลและ Firebase SDK สำหรับ Google Analytics ลงในไฟล์บิลด์ของโปรเจ็กต์

แพลตฟอร์ม Apple

เพิ่มและติดตั้งพ็อดต่อไปนี้ใน Podfile

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

Android

เพิ่มทรัพยากร Dependency ของไลบรารีต่อไปนี้ลงในไฟล์ build.gradle

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

Unity

ดาวน์โหลดและติดตั้ง Firebase Unity SDK จากนั้นเพิ่มแพ็กเกจ Unity ต่อไปนี้ลงในโปรเจ็กต์ของคุณ

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

กำหนดค่าอินสแตนซ์การกำหนดค่าระยะไกล

หากต้องการใช้ค่าพารามิเตอร์การกำหนดค่าระยะไกล ให้กำหนดค่าอินสแตนซ์การกำหนดค่าระยะไกลเพื่อให้มีการตั้งค่าให้ดึงค่าใหม่สำหรับอินสแตนซ์แอปไคลเอ็นต์

ในตัวอย่างนี้ การกำหนดค่าระยะไกลมีการกำหนดค่าเพื่อตรวจสอบค่าพารามิเตอร์ใหม่ทุกชั่วโมง

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+KTX

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

ดึงข้อมูลและเปิดใช้งานการกำหนดค่าระยะไกล

ดึงข้อมูลและเปิดใช้งานพารามิเตอร์การกำหนดค่าระยะไกลเพื่อให้เริ่มใช้ค่าพารามิเตอร์ใหม่ได้

คุณต้องทำให้การเรียกนี้โดยเร็วที่สุดในช่วงการโหลดของแอป เนื่องจากการเรียกนี้เป็นแบบไม่พร้อมกันและคุณจะต้องดึงค่าการกำหนดค่าระยะไกล ล่วงหน้าเพื่อให้แอปรู้ว่าจะแสดงโฆษณาหรือไม่

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

Unity

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

ตอนนี้แอปของคุณพร้อมที่จะจัดการพารามิเตอร์การกำหนดค่าระยะไกลที่คุณสร้างขึ้นระหว่างการทดสอบ A/B ที่ตั้งค่าไว้ก่อนหน้านี้ในบทแนะนำนี้แล้ว

ใช้ค่าพารามิเตอร์การกำหนดค่าระยะไกล

ใช้ค่าการกำหนดค่าระยะไกลที่ดึงข้อมูลไว้ล่วงหน้าในฟังก์ชัน loadAdUnit() เพื่อกำหนดว่าอินสแตนซ์ของแอปควรแสดง (ค่าพารามิเตอร์ true) หรือไม่แสดง (ค่าพารามิเตอร์ false) หน่วยโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัลใหม่

Swift

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

Objective-C

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

Unity

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

เพิ่มการตรวจสอบอื่นๆ สำหรับค่าพารามิเตอร์

มีส่วนอื่นๆ ในโค้ดของแอปพลิเคชันที่คุณจะต้องตรวจสอบค่าของพารามิเตอร์การกำหนดค่าระยะไกลนี้เพื่อกำหนดประสบการณ์การใช้งานโฆษณาที่จะโหลด ตัวอย่างเช่น คุณสามารถตัดสินใจว่าจะโหลดโฆษณาซ้ำหรือไม่หลังจากที่ผู้ใช้ดูโฆษณาปัจจุบันจบแล้ว

คุณควรเรียกใช้การดึงข้อมูลและเปิดใช้งานก่อนเพื่อรับการเปลี่ยนแปลงค่าพารามิเตอร์ เช่น ในกรณีที่ตัดสินใจสิ้นสุดหรือสร้างการทดสอบใหม่

คุณสามารถตรวจสอบค่าของพารามิเตอร์ได้เสมอโดยใช้การเรียกต่อไปนี้

Swift

remoteConfig["showNewAdKey"].boolValue

Objective-C

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

Java

mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Kotlin+KTX

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Unity

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

การเรียกเหล่านี้จะส่งคืนค่าเดียวกันสำหรับอินสแตนซ์แอปเสมอ โดยขึ้นอยู่กับว่ามีการวางไว้ในกลุ่มควบคุมหรือกลุ่มตัวแปรโฆษณาใหม่หรือไม่ เว้นแต่จะมีการเปลี่ยนแปลงในคอนโซล Firebase ที่มีการดึงข้อมูลและเปิดใช้งานในการเรียกครั้งก่อน




ขั้นตอนที่ 2: สร้างการทดสอบ A/B ในคอนโซล Firebase ขั้นตอนที่ 4: เริ่มการทดสอบ A/B และตรวจสอบผลการทดสอบ