Enregistrer l'ID de réponse d'annonce avec Firebase Crashlytics

Sélectionnez une plate-forme : Android iOS Unity

Firebase Crashlytics est un outil léger de création de rapports d'erreur en temps réel qui vous permet de gérer facilement les problèmes de stabilité dans votre application. Crashlytics vous fait gagner du temps en regroupant intelligemment les plantages et en mettant en évidence les circonstances qui les ont provoqués.

Ce guide explique comment intégrer Crashlytics à votre projet Xcode pour que vous puissiez consigner les ID de réponse des annonces. Plus tard, lorsque vous résolvez les plantages dans votre application, vous pouvez rechercher l'ID de réponse d'annonce et utiliser le centre de vérification des annonces dans AdMob pour trouver et bloquer les annonces.

Étape 1 : Ajouter Firebase à une application iOS

  1. Si vous souhaitez essayer la journalisation avec Firebase à partir d'une application propre, vous pouvez télécharger ou cloner les exemples du SDK Google Mobile Ads pour iOS repository sur GitHub. Ce guide utilise spécifiquement l'exemple de bannière.

    Si vous possédez déjà une application, vous devriez pouvoir passer aux autres étapes avec l'ID de bundle de votre application. Les mêmes étapes peuvent également être appliquées à d'autres exemples du dépôt, avec quelques adaptations mineures.

  2. Pour utiliser Firebase Crashlytics, vous devez créer un projet Firebase et y ajouter votre application. Si ce n'est pas déjà fait, créez un projet Firebase. Veillez à enregistrer votre application.

    1. Sur la page Crashlytics de la console Firebase, cliquez sur Configurer Crashlytics.

    2. Sur l'écran qui s'affiche, cliquez sur Non > Configurer une nouvelle application Firebase.

  3. Dans le fichier Podfile, ajoutez les pods pour Google Analytics et 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

  4. Dans le terminal ou une invite de commande, installez et mettez à jour vos pods :

    pod install --repo-update

  5. Ouvrez le fichier BannerExample.xcworkspace pour que Xcode charge le projet.

Étape 2 : Configurez Firebase pour votre application

Swift

Dans votre AppDelegate.swift, ajoutez les lignes suivantes :

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

Dans votre AppDelegate.m, ajoutez les lignes suivantes :

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

Dans Xcode, ouvrez Build Settings (Paramètres de compilation), puis cliquez sur l'onglet Build Phases (Phases de compilation). Ajoutez le script d'exécution Fabric :

Nettoyez votre dossier de compilation, puis compilez et exécutez votre application. Vous pouvez maintenant vous connecter à la console Web Firebase et accéder au tableau de bord Crashlytics.

(Facultatif) Tester votre configuration

En ajoutant un bouton de plantage, vous pouvez forcer un plantage de l'application à chaque pression sur le bouton. Cette configuration de test déclenchera le code de l'étape 3 pour envoyer des journaux personnalisés aux tableaux de bord Firebase Crashlytics.

Swift

Dans votre ViewController.swift, ajoutez les lignes suivantes à la fonction 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)
    }

Ajoutez ensuite ce @IBAction en bas de la déclaration de votre classe :

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

Objective-C

Dans votre ViewController.m, ajoutez les lignes suivantes à la méthode 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];
}

Ajoutez ensuite ce IBAction en bas de la déclaration de votre classe :

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

Dans la barre d'outils Xcode, appuyez sur le bouton Stop (Arrêter), puis relancez l'application via un simulateur. Une fois l'application chargée, vous pouvez cliquer sur le bouton Crash (Plantage). Revenez à Xcode et cliquez sur le bouton Play pour que le journal des plantages soit importé dans Crashlytics.

Étape 3 : Enregistrez l'ID de réponse d'annonce

Si vous chargez plusieurs annonces et les affichez à différents moments, il est conseillé de consigner l'ID de réponse de chaque annonce avec une clé distincte. Par exemple, ce guide utilise un exemple qui ne comporte qu'une seule bannière publicitaire. Par conséquent, nous enregistrons l'ID de réponse de l'annonce en tant que clé banner_ad_response_id dans l'extrait suivant.

Vous pouvez également créer plusieurs paires clé / valeur personnalisées dans Firebase Crashlytics pour différents types d'annonces et événements publicitaires. Consultez les notifications sur le cycle de vie des demandes d'annonces pour

Pour en savoir plus sur la journalisation personnalisée, consultez Personnaliser vos rapports d'erreur Firebase Crashlytics.

Swift

Ajoutez le code suivant à votre ViewController.swift. Elle utilise essentiellement la fonction Crashlytics.setCustomValue() dans la fonction de rappel adViewDidReceiveAd.

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

Ajoutez le code suivant à votre ViewController.m. En fait, il utilise la fonction [FIRCrashlytics crashlytics] setCustomValue dans la fonction adViewDidReceiveAd.

@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

Félicitations ! Le adResponseId le plus récent s'affiche désormais dans la section des clés des sessions de plantage de votre tableau de bord Crashlytics. Notez que certaines clés peuvent mettre jusqu'à une heure à s'afficher dans votre tableau de bord.