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 Xcode 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 iOS
Si quieres probar el registro con Firebase desde una app limpia, puedes descargar o clonar Google Mobile Ads SDK ejemplos para iOS 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 ID de paquete de la app. Los mismos pasos también se pueden aplicar a otros ejemplos del repositorio con pequeñas adaptaciones.
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.
En la página de Crashlytics de Firebase console, haz clic en Configurar Crashlytics.
En la pantalla que aparece, haz clic en No > Configurar una nueva app de Firebase.
En el Podfile, agrega los pods para Google Analytics y Firebase Crashlytics.
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
En la terminal o en un símbolo del sistema, instala y actualiza tus pods:
pod install --repo-update
Abre el archivo
BannerExample.xcworkspacepara que Xcode cargue el proyecto.
Paso 2: Configura Firebase para tu app
Swift
En tu AppDelegate.swift, agrega las siguientes líneas:
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 } }
Objective-C
En tu AppDelegate.m, agrega las siguientes líneas:
@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; }
En Xcode, abre Build Settings y haz clic en la pestaña Build Phases. Agrega la secuencia de comandos de ejecución de Fabric:
Limpia tu carpeta de compilación y, luego, compila y ejecuta tu app. Ahora puedes acceder a Firebase console y 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. Esta configuración de prueba activará el código del paso 3 para enviar registros personalizados a los paneles de Firebase Crashlytics.
Swift
En tu ViewController.swift, agrega las siguientes líneas a la función viewDidLoad():
override func viewDidLoad() { super.viewDidLoad() bannerView.delegate = self bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716" bannerView.rootViewController = self bannerView.load(Request()) 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) }
Luego, agrega este @IBAction a la parte inferior de la declaración de clase:
@IBAction func crashButtonTapped(_ sender: AnyObject) { fatalError("Test Crash Happened") }
Objective-C
En tu ViewController.m, agrega las siguientes líneas al método viewDidLoad:
‐ (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]; }
Luego, agrega este IBAction a la parte inferior de la declaración de clase:
‐ (IBAction)crashButtonTapped:(id)sender { assert(NO); }
En la barra de herramientas de Xcode, presiona el botón Stop y, luego, vuelve a iniciar la app a través de un simulador. Una vez que se cargue la app, puedes hacer clic en el botón Crash. Regresa a Xcode y haz clic en el botón Play para que el registro de fallas se suba a Crashlytics.
Paso 3: 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.
También puedes crear varios pares clave-valor personalizados en Firebase Crashlytics para diferentes tipos de anuncios y eventos de anuncios. Consulta las notificaciones del ciclo de vida de la solicitud de anuncios para
Swift
Agrega el siguiente código a tu ViewController.swift. Básicamente, usa la
Crashlytics.setCustomValue()
función en la adViewDidReceiveAd función de devolución de llamada.
import GoogleMobileAds import UIKit class ViewController: UIViewController, BannerViewDelegate { /// The banner view. @IBOutlet weak var bannerView: BannerView! override func viewDidLoad() { super.viewDidLoad() ... bannerView.delegate = self ... } /// Tells the delegate an ad request loaded an ad. func adViewDidReceiveAd(_ bannerView: BannerView) { 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") } } }
Objective-C
Agrega el siguiente código a tu ViewController.m. Básicamente, usa la
[FIRCrashlytics crashlytics]
setCustomValue
función en la adViewDidReceiveAd función.
@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
¡Felicitaciones! Ahora verás el adResponseId 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.
