Rejestrowanie identyfikatora reakcji na reklamę za pomocą Firebase Crashlytics

Wybierz platformę: Android iOS Unity

Firebase Crashlytics to lekkie narzędzie do raportowania awarii w czasie rzeczywistym, które ułatwia zarządzanie problemami ze stabilnością aplikacji. Crashlytics oszczędza czas potrzebny na rozwiązywanie problemów, ponieważ inteligentnie grupuje awarie i wyświetla okoliczności, które do nich doprowadziły.

Z tego przewodnika dowiesz się, jak zintegrować Crashlytics z projektem Xcode, aby rejestrować identyfikatory odpowiedzi na reklamy. Później, gdy będziesz rozwiązywać problemy z awariami w aplikacji, możesz wyszukać identyfikator odpowiedzi reklamy i użyć Centrum oceny reklam w AdMob, aby znaleźć i zablokować reklamy.

Krok 1. Dodaj Firebase do aplikacji na iOS

1. Jeśli chcesz wypróbować logowanie w Firebase w czystej aplikacji, możesz pobrać lub sklonować repozytorium z przykładami pakietu Google Mobile Ads SDK na iOS w GitHubie. W tym przewodniku używamy konkretnie przykładowego banera.

   Jeśli masz już aplikację, możesz przejść do innych kroków, używając identyfikatora pakietu aplikacji. Te same kroki można też zastosować do innych przykładów w repozytorium, wprowadzając niewielkie zmiany.

2. Aby korzystać z Firebase Crashlytics, musisz utworzyć projekt Firebase i dodać do niego aplikację. Jeśli nie masz jeszcze projektu Firebase, utwórz go. Pamiętaj, aby zarejestrować w nim aplikację.

   1. Na stronie Crashlytics w konsoli Firebase kliknij Skonfiguruj Crashlytics.

   2. Na wyświetlonym ekranie kliknij Nie > Skonfiguruj nową aplikację Firebase.

      

3. W pliku Podfile dodaj komponenty Pods dla Google Analytics i 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. W terminalu lub wierszu poleceń zainstaluj i zaktualizuj pody:

   pod install --repo-update
   

5. Otwórz plik BannerExample.xcworkspace, aby Xcode załadował projekt.

Krok 2. Skonfiguruj Firebase w aplikacji

Swift

W pliku AppDelegate.swift dodaj te wiersze:

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

W pliku AppDelegate.m dodaj te wiersze:

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

W Xcode otwórz Ustawienia kompilacji i kliknij kartę Fazy kompilacji. Dodaj skrypt uruchamiania Fabric:

Wyczyść folder kompilacji, a potem skompiluj i uruchom aplikację. Teraz możesz zalogować się w konsoli internetowej Firebase i uzyskać dostęp do panelu Crashlytics.

(Opcjonalnie) Testowanie konfiguracji

Dodając przycisk awarii, możesz wymusić awarię aplikacji przy każdym naciśnięciu przycisku. Ta konfiguracja testowa spowoduje, że kod z kroku 3 wyśle niestandardowe dzienniki na panele Firebase Crashlytics.

Swift

W pliku ViewController.swift dodaj te wiersze do funkcji 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)
    }

Następnie dodaj ten znak @IBAction na końcu deklaracji klasy:

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

Objective-C

W klasie ViewController.m dodaj te wiersze do metody 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];
}

Następnie dodaj ten znak IBAction na końcu deklaracji klasy:

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

Na pasku narzędzi Xcode naciśnij przycisk Stop, a potem uruchom ponownie aplikację w symulatorze. Po wczytaniu aplikacji możesz kliknąć przycisk Crash. Wróć do Xcode i kliknij przycisk Odtwórz, aby przesłać dziennik awarii do Crashlytics.

Najważniejsza uwaga: dane o awariach i sesjach mogą być widoczne w konsoli Firebase od razu, ale propagacja kluczy niestandardowych może potrwać godzinę lub dłużej.

Krok 3. Zapisz identyfikator odpowiedzi na reklamę

Jeśli wczytujesz wiele reklam i wyświetlasz je w różnych momentach, warto rejestrować każdy identyfikator odpowiedzi reklamy za pomocą osobnego klucza. Na przykład w tym przewodniku używamy przykładu, który zawiera tylko 1 baner reklamowy. Dlatego w tym fragmencie kodu rejestrujemy identyfikator odpowiedzi reklamy jako klucz banner_ad_response_id.

W Firebase Crashlytics możesz też tworzyć wiele niestandardowych par klucz / wartość dla różnych typów reklam i zdarzeń związanych z reklamami. Zapoznaj się z powiadomieniami dotyczącymi cyklu życia żądania reklamy.

• Banners
• Reklamy pełnoekranowe
• Ujednolicone reklamy natywne
• Reklama z nagrodą
• Reklama wideo z nagrodą

Więcej informacji o rejestrowaniu niestandardowym znajdziesz w artykule Dostosowywanie raportów o awariach w Firebase Crashlytics.

Swift

Dodaj ten kod do pliku ViewController.swift. W zasadzie używa funkcji Crashlytics.setCustomValue() w funkcji wywołania zwrotnego 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

Dodaj ten kod do pliku ViewController.m. W zasadzie używa funkcji [FIRCrashlytics crashlytics] setCustomValue w funkcji 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

Gratulacje! W sekcji kluczowych informacji o sesjach awarii w panelu Crashlytics zobaczysz teraz najnowsze adResponseId. Pamiętaj, że niektóre klucze mogą być widoczne na panelu dopiero po godzinie.