Anzeigenantwort-ID in Crashlytics protokollieren

Firebase Crashlytics ist ein schlankes Tool, das Absturzberichte in Echtzeit erstellt, und Ihnen so hilft, Stabilitätsprobleme in Ihrer App zu verwalten. Crashlytics spart Ihnen Zeit bei der Fehlerbehebung, da Abstürze intelligent gruppiert und die Umstände, die zu ihnen geführt haben, hervorgehoben werden.

In diesem Leitfaden wird beschrieben, wie Sie Crashlytics in Ihr Android Studio-Projekt einbinden, um IDs von Anzeigenantworten zu protokollieren. Wenn Sie später Abstürze in Ihrer App beheben, können Sie die Anzeigenantwort-ID nachschlagen und die Anzeigen im Überprüfungszentrum für Anzeigen in AdMob finden und blockieren.

Schritt 1: Firebase zu einer Android-App hinzufügen

  1. Wenn Sie das Logging mit Firebase in einer neuen App ausprobieren möchten, können Sie das Repository mit Google Mobile Ads SDK (Legacy)-Beispielen für Android auf GitHub herunterladen oder klonen. In diesem Leitfaden wird das Banner-Beispiel verwendet.

    Wenn Sie bereits eine App haben, sollten Sie mit dem Paketnamen Ihrer App zu anderen Schritten übergehen können. Die gleichen Schritte können mit geringfügigen Anpassungen auch auf andere Beispiele im Repository angewendet werden.

  2. Wenn Sie Firebase Crashlytics verwenden möchten, müssen Sie ein Firebase-Projekt erstellen und Ihre App hinzufügen. Falls noch nicht geschehen, erstellen Sie ein Firebase-Projekt. Registrieren Sie Ihre App dafür.

    1. Klicken Sie auf der Crashlytics-Seite der Firebase Console auf Crashlytics einrichten.

    2. Klicken Sie auf dem angezeigten Bildschirm auf Nein > Neue Firebase-App einrichten.

  3. Fügen Sie in der Datei „build.gradle“ die Abhängigkeiten für Google Analytics, Fabric und Crashlytics hinzu.

    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. Erstellen Sie Ihre App und führen Sie sie aus, um zu prüfen, ob Crashlytics richtig konfiguriert ist. Nach erfolgreicher Anmeldung können Sie auf das Crashlytics-Dashboard zugreifen.

Optional: Einrichtung testen

Wenn Sie die Schaltfläche „Absturz hinzufügen“ hinzufügen, können Sie bei jedem Drücken der Schaltfläche einen Absturz der App erzwingen.

Hier ist ein Beispiel, wie Sie in der onCreate()-Methode einer Activity eine Absturzschaltfläche hinzufügen:

MainActivity (Auszug)

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

Erstellen Sie Ihre App in Android Studio und führen Sie sie auf einem Emulator oder einem verbundenen Gerät aus. Nachdem die App geladen wurde, können Sie auf den Button Crash klicken. Starten Sie die App auf dem Gerät oder in Android Studio neu, damit das Absturzprotokoll in Crashlytics hochgeladen wird.

Schritt 2: Anzeigenantwort-ID protokollieren

Wenn Sie mehrere Anzeigen laden und zu unterschiedlichen Zeiten einblenden, sollten Sie jede Anzeigenantwort-ID mit einem separaten Schlüssel protokollieren. In diesem Leitfaden wird beispielsweise ein Beispiel mit nur einer Banneranzeige verwendet. Daher wird die Anzeigenantwort-ID im folgenden Snippet als banner_ad_response_id-Schlüssel protokolliert. Sie können in Firebase Crashlytics mehrere benutzerdefinierte Schlüssel/Wert-Paare für verschiedene Anzeigentypen und Anzeigenereignisse erstellen (Informationen zum Lebenszyklus von Anzeigen finden Sie unter AdListener). Weitere Informationen zum benutzerdefinierten Logging finden Sie unter Firebase Crashlytics-Absturzberichte anpassen.

Fügen Sie Ihrer MyActivity.java den folgenden Code hinzu. Im Wesentlichen wird die Funktion FirebaseCrashlytics.setCustomKey() in der Callback-Funktion onAdLoaded() verwendet, um sicherzustellen, dass die Anzeige geladen wurde, bevor versucht wird, getResponseInfo() aufzurufen.

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

Glückwunsch! In Ihrem Crashlytics-Dashboard sehen Sie jetzt die neuesten banner_ad_response_id im Schlüsselbereich der Absturzsitzungen. Beachten Sie, dass es bei einigen Schlüsseln bis zu einer Stunde dauern kann, bis sie im Dashboard angezeigt werden.