Anzeigenantwort-ID mit Firebase Crashlytics erfassen

Firebase Crashlytics ist ein leistungsstarkes Echtzeit-Tool zur Erfassung von Abstürzen, mit dem Sie Stabilitätsprobleme in Ihrer App ganz einfach beheben können. 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 dieser Anleitung wird beschrieben, wie Sie Crashlytics in Ihr Xcode-Projekt einbinden, damit Sie Anzeigenantwort-IDs erfassen können. 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 einer iOS-Anwendung hinzufügen

  1. Wenn Sie die Protokollierung mit Firebase in einer neuen App ausprobieren möchten, können Sie die Beispiele für das Google Mobile Ads SDK für iOS aus dem Repository auf GitHub herunterladen oder klonen. In diesem Leitfaden wird das Bannerbeispiel verwendet.

    Wenn Sie bereits eine App haben, sollten Sie mit der Bundle-ID Ihrer App mit den nächsten Schritten fortfahren können. Dieselben 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. Erstellen Sie ein Firebase-Projekt, falls noch nicht geschehen. Registrieren Sie Ihre App.

    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 im Podfile die Pods für Google Analytics und Firebase Crashlytics hinzu.

    source 'https://github.com/CocoaPods/Specs.git'
    
    platform :ios, '8.0'
    
    target 'BannerExample' do
      use_frameworks!
      pod 'Google-Mobile-Ads-SDK'
      pod 'Firebase/Crashlytics'
      pod 'Firebase/Analytics'
    end
  4. Installieren und aktualisieren Sie Ihre Pods im Terminal oder in einer Eingabeaufforderung:

    pod install --repo-update
    
  5. Öffne die Datei BannerExample.xcworkspace, damit Xcode das Projekt laden kann.

Schritt 2:Firebase für Ihre App konfigurieren

Fügen Sie in AppDelegate.swift die folgenden Zeilen hinzu:

import UIKit

// Import the Firebase library
import FirebaseCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions:
          [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // Configure an instance of Firebase
    FirebaseApp.configure()
    return true
  }
}

Fügen Sie in AppDelegate.m die folgenden Zeilen hinzu:

@import AppDelegate.h;

// Import the Firebase library
@import FirebaseCore;

@interface AppDelegate ()

@end

@implementation AppDelegate(BOOL)application:(UIApplication *)application
        didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.

    // Initialize Firebase
    [FIRApp configure];
    return YES;
}

Öffnen Sie in Xcode die Build-Einstellungen und klicken Sie auf den Tab Build-Phasen. Fügen Sie das Fabric-Ausführungsskript hinzu:

Bereinigen Sie Ihren Build-Ordner, erstellen Sie Ihre App und führen Sie sie aus. Jetzt können Sie sich in der Firebase Webkonsole anmelden und auf das Crashlytics-Dashboard zugreifen.

Optional: Einrichtung testen

Wenn Sie eine Schaltfläche zum Herbeiführen eines Absturzes hinzufügen, können Sie einen Absturz erzwingen, der bei jeder Betätigung der Schaltfläche einen App-Absturz verursacht. Durch diese Testeinrichtung wird der Code in Schritt 3 ausgelöst, um benutzerdefinierte Protokolle an Firebase Crashlytic-Dashboards zu senden.

Fügen Sie in ViewController.swift der Funktion viewDidLoad() die folgenden Zeilen hinzu:

    override func viewDidLoad() {
        super.viewDidLoad()
        print("Google Mobile Ads SDK version: \(GADRequest.sdkVersion())")
        bannerView.delegate = self
        bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716"
        bannerView.rootViewController = self
        bannerView.load(GADRequest())
        let button = UIButton(type: .roundedRect)
        button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
        button.setTitle("Crash", for: [])
        button.addTarget(self, action: #selector(self.crashButtonTapped(_:)),
            for: .touchUpInside)
        view.addSubview(button)
    }

Fügen Sie dann unten in der Klassendeklaration diesen @IBAction hinzu:

    @IBAction func crashButtonTapped(_ sender: AnyObject) {
        fatalError("Test Crash Happened")
    }

Fügen Sie in ViewController.m der Methode viewDidLoad die folgenden Zeilen hinzu:

 (void)viewDidLoad {
    [super viewDidLoad];

    /// ...

    UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
    button.frame = CGRectMake(20, 50, 100, 30);
    [button setTitle:@"Crash" forState:UIControlStateNormal];
    [button addTarget:self action:@selector(crashButtonTapped:)
        forControlEvents:UIControlEventTouchUpInside];
    [self.view addSubview:button];
}

Fügen Sie dann unten in der Klassendeklaration diesen IBAction hinzu:

 (IBAction)crashButtonTapped:(id)sender {
    assert(NO);
}

Drücken Sie in der Xcode-Symbolleiste auf die Schaltfläche Stopp und starten Sie die App dann über einen Simulator neu. Nachdem die App geladen wurde, können Sie auf die Schaltfläche Absturz klicken. Kehren Sie zu Xcode zurück und klicken Sie auf die Schaltfläche Wiedergeben, damit das Crash-Log in Crashlytics hochgeladen wird.

Schritt 3:Anzeigenantwort-ID erfassen

Wenn Sie mehrere Anzeigen laden und zu unterschiedlichen Zeiten ausliefern, sollten Sie für jede Anzeigenantwort-ID einen separaten Schlüssel erfassen. In diesem Leitfaden wird beispielsweise ein Beispiel mit nur einer Banneranzeige verwendet. Daher loggen wir die Anzeigenantwort-ID im folgenden Snippet als Schlüssel banner_ad_response_id.

Sie können in Firebase Crashlytics auch mehrere benutzerdefinierte Schlüssel / Wert-Paare für verschiedene Anzeigentypen und Anzeigenereignisse erstellen. Weitere Informationen finden Sie in den Benachrichtigungen zum Lebenszyklus von Anzeigenanfragen für:

Weitere Informationen zur benutzerdefinierten Protokollierung finden Sie unter Firebase Crashlytics-Absturzberichte anpassen.

Fügen Sie Ihrem ViewController.swift-Code den folgenden Code hinzu. Im Wesentlichen wird die Funktion Crashlytics.setCustomValue() in der adViewDidReceiveAd-Callback-Funktion verwendet.

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADBannerViewDelegate {

    /// The banner view.
    @IBOutlet weak var bannerView: GADBannerView!

    override func viewDidLoad() {
       super.viewDidLoad()
       ...
       bannerView.delegate = self
       ...
    }

    /// Tells the delegate an ad request loaded an ad.
    func adViewDidReceiveAd(_ bannerView: GADBannerView) {
        if let responseInfo = bannerView.responseInfo,
                responseId = responseInfo.responseId {
            print("adViewDidReceiveAd from network:
                \(responseInfo.adNetworkClassName), response Id='\(responseId)'")
            Crashlytics.sharedInstance().setCustomValue(responseId,
                forKey: "banner_ad_response_id")
        }
    }
}

Fügen Sie Ihrem ViewController.m-Code den folgenden Code hinzu. Im Wesentlichen wird die Funktion [FIRCrashlytics crashlytics] setCustomValue in der Funktion adViewDidReceiveAd verwendet.

@import GoogleMobileAds;
@interface ViewController ()

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController(void)viewDidLoad {
  [super viewDidLoad];

  // In this case, we instantiate the banner with desired ad size.
  self.bannerView = [[GADBannerView alloc]
      initWithAdSize:GADAdSizeBanner];

  [self addBannerViewToView:self.bannerView];
} (void)addBannerViewToView:(UIView *)bannerView {
  bannerView.translatesAutoresizingMaskIntoConstraints = NO;
  [self.view addSubview:bannerView];
  [self.view addConstraints:@[
    [NSLayoutConstraint constraintWithItem:bannerView
                               attribute:NSLayoutAttributeBottom
                               relatedBy:NSLayoutRelationEqual
                                  toItem:self.bottomLayoutGuide
                               attribute:NSLayoutAttributeTop
                              multiplier:1
                                constant:0],
    [NSLayoutConstraint constraintWithItem:bannerView
                                 attribute:NSLayoutAttributeCenterX
                                 relatedBy:NSLayoutRelationEqual
                                    toItem:self.view
                                kattribute:NSLayoutAttributeCenterX
                                multiplier:1
                                  constant:0]
                             ]];
}

- (void)adViewDidReceiveAd:(GADBannerView *)bannerView {
  NSString *adResponseId = bannerView.responseInfo.responseId;
  if (adResponseId) {
    NSLog(@"adViewDidReceiveAd from network: %@ with response Id: %@",
        bannerView.responseInfo.adNetworkClassName, adResponseId);
    [[FIRCrashlytics crashlytics] setCustomValue:adResponseId
                                          forKey:@"banner_ad_response_id"];
  }
}

@end

Glückwunsch! Die neueste adResponseId wird jetzt im Bereich „Schlüssel“ der Absturzsitzungen auf Ihrem Crashlytics-Dashboard angezeigt. Bei einigen Schlüsseln kann es bis zu einer Stunde dauern, bis sie im Dashboard angezeigt werden.