Registra el ID de la respuesta del anuncio en Crashlytics

Firebase Crashlytics es una herramienta ligera para informar fallas en tiempo real que te permite administrar fácilmente los problemas de estabilidad de tu app. Crashlytics te ahorra tiempo de solución de problemas, ya que agrupa las fallas de forma inteligente y destaca las circunstancias que las provocan.

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 anuncios. Más adelante, cuando soluciones problemas de fallas en tu app, podrás buscar el ID de respuesta de anuncios 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 Google Mobile Ads SDK ejemplos para Android repositorio en GitHub. En esta guía, se usa específicamente el ejemplo de banner.

   Si ya tienes una app, deberías poder continuar con los demás pasos con el nombre de paquete de la 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 agregarle tu app. 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 nueva app de Firebase.

      

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

   project/build.gradle

   buildscript {
       repositories {
           // ...
           // Add Google's Maven repository.
           google()
       }
   
       dependencies {
           // ...
   
           classpath 'com.google.gms:google-services:4.4.4'
   
           // Add the Fabric Crashlytics plugin.
           classpath 'com.google.firebase:firebase-crashlytics-gradle:3.0.6'
       }
   }
   
   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 lo hagas 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 cada vez que se presione el botón.

Este es un ejemplo en el que se muestra cómo agregar un botón de falla en el método onCreate() de una 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 un dispositivo conectado. Después de que se cargue la app, puedes hacer clic en el botón Falla. Vuelve a iniciar la app desde el dispositivo o Android Studio para que el registro de fallas se suba a Crashlyics.

Paso 2: Registra el ID de respuesta de anuncios

Si cargas varios anuncios y los muestras en diferentes momentos, es una buena idea registrar cada ID de respuesta de anuncios con una clave independiente. Por ejemplo, en esta guía, se usa un ejemplo que tiene solo un anuncio de banner. Por lo tanto, registramos el ID de respuesta de anuncios 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 ver 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 FirebaseCrashlytics.setCustomKey() función en la onAdLoaded() función de devolución de llamada 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 hacerse visibles en tu panel.