Reklam yanıtı kimliğini Crashlytics'e kaydetme

Firebase Crashlytics, uygulamanızdaki kararlılık sorunlarını yönetmenizi kolaylaştıran, basit ve anlık bir kilitlenme raporlama aracıdır. Crashlytics, kilitlenmeleri akıllı bir şekilde gruplandırarak ve bunlara yol açan koşulları vurgulayarak sorun giderme sürecinde size zaman kazandırır.

Bu kılavuzda, reklam yanıtı kimliklerini günlüğe kaydedebilmek için Crashlytics'i Android Studio projenize nasıl entegre edeceğiniz açıklanmaktadır. Daha sonra, uygulamanızdaki kilitlenmelerle ilgili sorunları giderirken Reklam Yanıtı Kimliği'ni Hızlı Ara'yabilir ve reklamları bulup engellemek için AdMob'daki Reklam İnceleme Merkezi'ni kullanabilirsiniz.

1. adım: Firebase'i bir Android uygulamasına ekleyin

  1. Firebase ile günlük kaydı yapmayı temiz bir uygulamadan denemek isterseniz GitHub'daki depodan Google Mobile Ads SDK (Legacy) Android örneklerini indirebilir veya klonlayabilirsiniz. Bu kılavuzda özellikle Banner Örneği kullanılmıştır.

    Zaten bir uygulamanız varsa uygulamanızın paket adıyla diğer adımlara geçebilirsiniz. Aynı adımlar, küçük değişikliklerle depodaki diğer örneklere de uygulanabilir.

  2. Firebase Crashlytics'i kullanmak için bir Firebase projesi oluşturmanız ve uygulamanızı bu projeye eklemeniz gerekir. Henüz oluşturmadıysanız bir Firebase projesi oluşturun. Uygulamanızı bu projeye kaydettiğinizden emin olun.

    1. Firebase konsolunun Crashlytics sayfasında Crashlytics'i kur'u tıklayın.

    2. Görüntülenen ekranda Hayır > Yeni bir Firebase uygulaması oluştur'u tıklayın.

  3. build.gradle dosyanıza Google Analytics, Fabric ve Crashlytics bağımlılıklarını ekleyin.

    app/build.gradle

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    
    // Add the Fabric plugin
    apply plugin: 'io.fabric'
    
    dependencies {
        // ...
    
        // Add Google Mobile Ads SDK (Legacy)
        implementation 'com.google.android.gms:play-services-ads:25.5.0'
    
        // Add the Firebase Crashlytics dependency.
        implementation 'com.google.firebase:firebase-crashlytics:21.0.1'
    }

    project/build.gradle

    buildscript {
        repositories {
            // ...
            // Add Google's Maven repository.
            google()
        }
    
        dependencies {
            // ...
    
            classpath 'com.google.gms:google-services:4.5.0'
    
            // Add the Fabric Crashlytics plugin.
            classpath 'com.google.firebase:firebase-crashlytics-gradle:3.0.8'
        }
    }
    
    allprojects {
        // ...
        repositories {
           // Check that Google's Maven repository is included (if not, add it).
           google()
    
           // ...
        }
    }
  4. Crashlytics'in doğru şekilde yapılandırıldığından emin olmak için uygulamanızı derleyip çalıştırın. İşlem başarılı olduğunda Crashlytics kontrol paneline erişebilirsiniz.

(İsteğe bağlı): Kurulumunuzu test etme

Kilitlenme ekle düğmesini kullanarak her düğmeye basıldığında uygulamanın kilitlenmesini sağlayabilirsiniz.

Bir Activity öğesinin onCreate() yöntemine kilitlenme düğmesi eklemeyi gösteren bir örneği aşağıda bulabilirsiniz:

MainActivity (excerpt)

Java

protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_my);

  // Gets the ad view defined in layout/ad_fragment.xml with ad unit ID set in
  // values/strings.xml.
  adView = findViewById(R.id.ad_view);

  // Start loading the ad in the background.
  adView.loadAd(new AdRequest.Builder().build());

  // Add a crash button.
  Button crashButton = new Button(this);
  crashButton.setText("Crash!");
  crashButton.setOnClickListener(new View.OnClickListener() {
    public void onClick(View view) {
      throw new RuntimeException("Test Crash"); // Force a crash
    }
  });

  addContentView(crashButton, new ViewGroup.LayoutParams(
      ViewGroup.LayoutParams.MATCH_PARENT,
      ViewGroup.LayoutParams.WRAP_CONTENT));
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.activity_my)

  // Gets the ad view defined in layout/ad_fragment.xml with ad unit ID set in
  // values/strings.xml.
  adView = findViewById(R.id.ad_view)

  // Start loading the ad in the background.
  adView.loadAd(AdRequest.Builder().build())

  // Add a crash button.
  val crashButton = Button(this)
  crashButton.text = "Crash!"
  crashButton.setOnClickListener {
    throw RuntimeException("Test Crash") // Force a crash
  }

  addContentView(crashButton, ViewGroup.LayoutParams(
      ViewGroup.LayoutParams.MATCH_PARENT,
      ViewGroup.LayoutParams.WRAP_CONTENT))
}

Android Studio'da uygulamanızı derleyip bir emülatörde veya bağlı cihazda çalıştırın. Uygulama yüklendikten sonra Crash (Kilitlenme) düğmesini tıklayabilirsiniz. Kilitlenme günlüğünün Crashlytics'e yüklenmesi için uygulamayı cihazdan veya Android Studio'dan yeniden başlatın.

2. adım: Reklam yanıtı kimliğini günlüğe kaydedin

Birden fazla reklam yükleyip bunları farklı zamanlarda gösteriyorsanız her reklam yanıtı kimliğini ayrı bir anahtarla kaydetmeniz iyi bir fikirdir. Örneğin, bu kılavuzda yalnızca bir banner reklam içeren bir örnek kullanılmıştır. Bu nedenle, reklam yanıtı kimliğini aşağıdaki snippet'te banner_ad_response_id anahtarı olarak günlüğe kaydederiz. Firebase Crashlytics'te farklı reklam türleri ve reklam etkinlikleri için birden fazla özel anahtar/değer çifti oluşturabilirsiniz (reklamın yaşam döngüsü için AdListener bölümüne bakın). Özel günlük kaydı hakkında daha fazla bilgi için Firebase Crashlytics kilitlenme raporlarınızı özelleştirme başlıklı makaleyi inceleyin.

MyActivity.java dosyanıza aşağıdaki kodu ekleyin. Temel olarak, getResponseInfo() işlevini çağırmaya çalışmadan önce reklamın yüklendiğinden emin olmak için onAdLoaded() geri çağırma işlevinde FirebaseCrashlytics.setCustomKey() işlevini kullanır.

Java

protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_my);

  // Gets the ad view defined in layout/ad_fragment.xml with ad unit ID set in
  // values/strings.xml.
  adView = findViewById(R.id.ad_view);

  adView.setAdListener(new AdListener() {
    @Override
    public void onAdLoaded() {
      String adResponseId = adView.getResponseInfo().getResponseId();
      FirebaseCrashlytics.getInstance().setCustomKey(
          "banner_ad_response_id", adResponseId);
    }
  });

  // Start loading the ad in the background.
  adView.loadAd(new AdRequest.Builder().build());

  // Add a crash button.
  Button crashButton = new Button(this);
  crashButton.setText("Crash!");
  crashButton.setOnClickListener(new View.OnClickListener() {
    public void onClick(View view) {
      throw new RuntimeException("Test Crash"); // Force a crash
    }
  });

  addContentView(crashButton, new ViewGroup.LayoutParams(
      ViewGroup.LayoutParams.MATCH_PARENT,
      ViewGroup.LayoutParams.WRAP_CONTENT));
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.activity_my)

  // Gets the ad view defined in layout/ad_fragment.xml with ad unit ID set in
  // values/strings.xml.
  adView = findViewById(R.id.ad_view)

  adView.adListener = object : AdListener() {
    override fun onAdLoaded() {
      mAdView.responseInfo?.responseId?.let { adResponseId ->
          FirebaseCrashlytics.getInstance().setCustomKey(
              "banner_ad_response_id", adResponseId)
      }
    }
  }

  // Start loading the ad in the background.
  adView.loadAd(AdRequest.Builder().build())

  // Add a crash button.
  val crashButton = Button(this)
  crashButton.text = "Crash!"
  crashButton.setOnClickListener {
    throw RuntimeException("Test Crash") // Force a crash
  }

  addContentView(crashButton, ViewGroup.LayoutParams(
      ViewGroup.LayoutParams.MATCH_PARENT,
      ViewGroup.LayoutParams.WRAP_CONTENT))
}

Tebrikler! Artık Crashlytics kontrol panelinizdeki kilitlenme oturumlarının anahtar bölümünde en son banner_ad_response_id göreceksiniz. Bazı anahtarların kontrol panelinizde görünür hale gelmesinin bir saati bulabileceğini unutmayın.