Cómo registrar el ID de respuesta del anuncio con Firebase Crashlytics

Firebase Crashlytics es una herramienta liviana para informar fallas en tiempo real que te permite administrar fácilmente los problemas de estabilidad en tu app. Crashlytics agrupa las fallas de forma inteligente y destaca las circunstancias en las que se produjeron, lo que te permite ahorrar tiempo en la solución de problemas.

En esta guía, se describe cómo integrar Crashlytics en tu proyecto de Android Studio para que puedas registrar los IDs de respuesta de los anuncios. Más adelante, cuando soluciones problemas de fallas en tu app, puedes buscar el ID de respuesta del anuncio y usar el Centro de revisión de anuncios en AdMob para encontrar y bloquear los anuncios.

Paso 1: Agrega Firebase a una aplicación para Android

1. Si quieres probar el registro con Firebase desde una app limpia, puedes descargar o clonar los ejemplos del SDK de anuncios de Google para dispositivos móviles para el repositorio de Android en GitHub. En esta guía, se usa específicamente el ejemplo de banner.

   Si ya tienes una app, deberías poder continuar con otros pasos con el nombre de paquete de tu app. Los mismos pasos también se pueden aplicar a otros ejemplos del repositorio con pequeñas adaptaciones.

2. Para usar Firebase Crashlytics, debes crear un proyecto de Firebase y agregar tu app a él. Si aún no lo hiciste, crea un proyecto de Firebase. Asegúrate de registrar tu app en él.

   1. En la página de Crashlytics de Firebase console, haz clic en Configurar Crashlytics.

   2. En la pantalla que aparece, haz clic en No > Configurar una app de Firebase nueva.

      

3. En tu archivo build.gradle, agrega las dependencias de Google Analytics, Fabric y Crashlytics.

   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 the Google Mobile Ads SDK
       implementation 'com.google.android.gms:play-services-ads:24.4.0'
   
       // Add the Firebase Crashlytics dependency.
       implementation 'com.google.firebase:firebase-crashlytics:19.4.4'
   }

   project/build.gradle

   buildscript {
       repositories {
           // ...
           // Add Google's Maven repository.
           google()
       }
   
       dependencies {
           // ...
   
           classpath 'com.google.gms:google-services:4.4.3'
   
           // Add the Fabric Crashlytics plugin.
           classpath 'com.google.firebase:firebase-crashlytics-gradle:3.0.4'
       }
   }
   
   allprojects {
       // ...
       repositories {
          // Check that Google's Maven repository is included (if not, add it).
          google()
   
          // ...
       }
   }

4. Compila y ejecuta tu app para asegurarte de que Crashlytics esté configurado correctamente. Una vez que se complete correctamente, podrás acceder al panel de Crashlytics.

   

(Opcional): Prueba tu configuración

Si agregas un botón de falla, puedes forzar una falla para que la app falle con cada presión del botón.

Este es un ejemplo que muestra cómo agregar un botón de bloqueo en el método onCreate() de un Activity:

MainActivity (fragmento)

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

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

En Android Studio, compila y ejecuta tu app en un emulador o en un dispositivo conectado. Después de que se cargue la app, puedes hacer clic en el botón Crash. Vuelve a iniciar la app desde el dispositivo o Android Studio para que el registro de fallas se suba a Crashlytics.

Paso 2: Registra el ID de respuesta del anuncio

Si cargas varios anuncios y los muestras en diferentes momentos, es una buena idea registrar cada ID de respuesta del anuncio con una clave independiente. Por ejemplo, esta guía usa un ejemplo que tiene solo un anuncio de banner. Por lo tanto, registramos el ID de respuesta del anuncio como la clave banner_ad_response_id en el siguiente fragmento. De hecho, puedes crear varios pares clave-valor personalizados en Firebase Crashlytics para diferentes tipos de anuncios y eventos de anuncios (consulta AdListener para el ciclo de vida del anuncio). Visita Personaliza los informes de fallas de Firebase Crashlytics para obtener más información sobre el registro personalizado.

Agrega el siguiente código a tu MyActivity.java. Básicamente, usa la función FirebaseCrashlytics.setCustomKey() en la función de devolución de llamada onAdLoaded() para garantizar que el anuncio se haya cargado antes de intentar llamar a getResponseInfo().

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

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

¡Felicitaciones! Ahora verás el banner_ad_response_id más reciente en la sección de claves de las sesiones de fallas en tu panel de Crashlytics. Ten en cuenta que algunas claves pueden tardar hasta una hora en aparecer en tu panel.