Cette page a été traduite par l'API Cloud Translation.

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

Firebase Crashlytics est un outil de création de rapports d'erreur léger et 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 précédés.

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

Étape 1 : Ajouter Firebase à une application iOS

Si vous souhaitez essayer de vous connecter avec Firebase à partir d'une application propre, vous pouvez télécharger ou cloner les exemples de SDK Google Mobile Ads pour iOS dans le dépôt GitHub. Ce guide utilise spécifiquement l'exemple de bannière.
Si vous disposez déjà d'une application, vous devriez pouvoir passer aux autres étapes avec l'ID de bundle de votre application. La même procédure peut également être appliquée à d'autres exemples du dépôt avec des adaptations mineures.
Pour utiliser Firebase Crashlytics, vous devez créer un projet Firebase et y ajouter votre application. Si vous ne l'avez pas déjà fait, créez un projet Firebase. Veillez à enregistrer votre application auprès de celui-ci.
1. Sur la page Crashlytics de la console Firebase, cliquez sur Configurer Crashlytics.
2. Sur l'écran qui s'affiche, cliquez sur No > Set up a new Firebase app (Non > Configurer une nouvelle application Firebase).

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

Dans un terminal ou une invite de commande, installez et mettez à jour vos pods :
```
pod install --repo-update
```
Ouvrez le fichier BannerExample.xcworkspace pour que Xcode charge le projet.

Étape 2 : Configurez Firebase pour votre application

Swift

Dans 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 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 Crashlytic.

Swift

Dans ViewController.swift, ajoutez les lignes suivantes à la fonction viewDidLoad() :

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

Ajoutez ensuite ce @IBAction en bas de la déclaration de 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 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 dans Xcode et cliquez sur le bouton Play (Lecture) 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 à des moments différents, il est conseillé de consigner chaque ID de réponse d'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 de code suivant.

Vous pouvez également créer plusieurs paires clé-valeur personnalisées dans Firebase Crashlytics pour différents types et événements d'annonces. Reportez-vous aux 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. En substance, il utilise la fonction Crashlytics.setCustomValue() dans la fonction de rappel adViewDidReceiveAd.

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

Objective-C

Ajoutez le code suivant à votre ViewController.m. En substance, 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 ! Vous verrez désormais le adResponseId le plus récent dans la section clé des sessions de plantage de votre tableau de bord Crashlytics. Notez que l'affichage de certaines clés dans votre tableau de bord peut prendre jusqu'à une heure.