Check out what’s new from Firebase at Google I/O 2022. Learn more

Wypróbuj

Możesz używać AdMob do wyświetlania reklam w swoich aplikacjach C++. Z tego przewodnika dowiesz się, jak przeprowadzić integrację z Firebase i korzystać z pakietu SDK do reklam mobilnych Google.

Jeśli po raz pierwszy korzystasz z tego przewodnika, zalecamy pobranie i śledzenie go za pomocą aplikacji testowej AdMob .

Zintegruj z Firebase

  1. Wykonaj czynności opisane w sekcji Konfiguracja na iOS lub Konfiguracja na Androida , aby dodać AdMob i Firebase do swojej aplikacji C++.

  2. Uwzględnij następujące nagłówki w kodzie C++ swojej aplikacji:

    #include "firebase/admob.h"
    #include "firebase/admob/types.h"
    #include "firebase/app.h"
    #include "firebase/future.h"
    
  3. Dodaj następujące elementy do kodu C++ w swojej aplikacji, aby zainicjować bibliotekę AdMob przy użyciu identyfikatora aplikacji AdMob (ten kod należy wykonać przed utworzeniem widoku banera lub reklamy pełnoekranowej):

    #if defined(__ANDROID__)
    // Create the Firebase app.
    firebase::App* app =
        firebase::App::Create(firebase::AppOptions(),
                              your_jni_env,
                              your_android_activity);
    
    // Your Android AdMob app ID.
    const char* kAdMobAppID = "ca-app-pub-XXXXXXXXXXXXXXXX~NNNNNNNNNN";
    #else
    // Create the Firebase app.
    firebase::App* app =
        firebase::App::Create(firebase::AppOptions());
    
    // Your iOS AdMob app ID.
    const char* kAdMobAppID = "ca-app-pub-XXXXXXXXXXXXXXXX~NNNNNNNNNN";
    #endif  // __ANDROID__
    
    // Initialize the AdMob library with your AdMob app ID.
    firebase::admob::Initialize(*app, kAdMobAppID);
    

Wejdź w interakcję z pakietem SDK do reklam mobilnych Google

Skonfiguruj identyfikatory jednostek reklamowych

Podczas pisania kodu C++, który jest obsługiwany zarówno w systemie iOS, jak i Android, może być konieczne użycie dyrektyw preprocesora w celu zdefiniowania kodu, który powinien być kompilowany tylko w określonym systemie operacyjnym. W przypadku wyświetlania banerów i reklam pełnoekranowych w systemach iOS i Android zaleca się utworzenie nowego identyfikatora jednostki reklamowej dla każdego systemu operacyjnego i każdego unikalnego miejsca docelowego reklamy. Poniższe identyfikatory jednostek reklamowych zostały utworzone dla systemów iOS i Android i są skonfigurowane tak, aby zawsze wyświetlać reklamy testowe:

#if defined(__ANDROID__)
// Android ad unit IDs
const char* kBannerAdUnit = "ca-app-pub-3940256099942544/6300978111";
const char* kInterstitialAdUnit = "ca-app-pub-3940256099942544/1033173712";
#else
// iOS ad unit IDs
const char* kBannerAdUnit = "ca-app-pub-3940256099942544/2934735716";
const char* kInterstitialAdUnit = "ca-app-pub-3940256099942544/4411468910";
#endif

Skonfiguruj widok banera

Dodaj następujący nagłówek do kodu C++ swojej aplikacji:

#include "firebase/admob/banner_view.h"

Zadeklaruj i stwórz wystąpienie obiektu BannerView :

firebase::admob::BannerView* banner_view;
banner_view = new firebase::admob::BannerView();

Utwórz AdSize i zainicjuj widok banera:

firebase::admob::AdSize ad_size;
ad_size.ad_size_type = firebase::admob::kAdSizeStandard;
ad_size.width = 320;
ad_size.height = 50;
// my_ad_parent is a reference to an iOS UIView or an Android Activity.
// This is the parent UIView or Activity of the banner view.
banner_view->Initialize(static_cast<firebase::admob::AdParent>(my_ad_parent), kBannerAdUnit, ad_size);

Skonfiguruj reklamę pełnoekranową

Dodaj następujący nagłówek do kodu C++ swojej aplikacji:

#include "firebase/admob/interstitial_ad.h"

Zadeklaruj i utwórz instancję obiektu InterstitialAd :

firebase::admob::InterstitialAd* interstitial_ad;
interstitial_ad = new firebase::admob::InterstitialAd();

Zainicjuj reklamę pełnoekranową:

// my_ad_parent is a reference to an iOS UIView or an Android Activity.
// This is the parent UIView or Activity of the interstitial ad.
interstitial_ad->Initialize(static_cast<firebase::admob::AdParent>(my_ad_parent), kInterstitialAdUnit);

Utwórz żądanie reklamy AdMob

Biblioteka AdMob umożliwia podanie w żądaniu reklamy informacji o kierowaniu niestandardowym. Odbywa się to poprzez ustawienie członków struktury AdRequest . Struktura jest następnie przekazywana do metody BannerView::LoadAd() lub InterstitialAd::LoadAd() .

Aby uzyskać ogólne informacje na temat kierowania i dostosowywania żądań reklam, zapoznaj się z naszymi przewodnikami dotyczącymi kierowania na iOS i Androida .

Oto struktura AdRequest używana przez BannerView i InterstitialAd do wysyłania żądania reklamy:

struct AdRequest {
  const char **test_device_ids;
  unsigned int test_device_id_count;
  const char **keywords;
  unsigned int keyword_count;
  const KeyValuePair *extras;
  unsigned int extras_count;
  int birthday_day;
  int birthday_month;
  int birthday_year;
  Gender gender;
  ChildDirectedTreatmentState tagged_for_child_directed_treatment;
};

Zadeklaruj i zainicjuj strukturę AdRequest :

// Initialize all the AdRequest struct member values to zero.
firebase::admob::AdRequest my_ad_request = {};

Poniższy kod ustawia wartości elementów członkowskich struktury AdRequest w celu dodania informacji o kierowaniu do żądania reklamy:

// If the app is aware of the user's gender, it can be added to the
// targeting information. Otherwise, "unknown" should be used.
my_ad_request.gender = firebase::admob::kGenderUnknown;

// The user's birthday, if known. Note that months are indexed from one.
my_ad_request.birthday_day = 10;
my_ad_request.birthday_month = 11;
my_ad_request.birthday_year = 1976;

// Additional keywords to be used in targeting.
static const char* kKeywords[] = {"AdMob", "C++", "Fun"};
my_ad_request.keyword_count = sizeof(kKeywords) / sizeof(kKeywords[0]);
my_ad_request.keywords = kKeywords;

// "Extra" key value pairs can be added to the request as well.
static const firebase::admob::KeyValuePair kRequestExtras[] = {
    {"the_name_of_an_extra", "the_value_for_that_extra"}};
my_ad_request.extras_count = sizeof(kRequestExtras) / sizeof(kRequestExtras[0]);
my_ad_request.extras = kRequestExtras;

// Register the device IDs associated with any devices that will be used to
// test your app. Below are sample test device IDs used for making the ad request.
static const char* kTestDeviceIDs[] =
    {"2077ef9a63d2b398840261c8221a0c9b",
     "098fe087d987c9a878965454a65654d7"};
my_ad_request.test_device_id_count =
    sizeof(kTestDeviceIDs) / sizeof(kTestDeviceIDs[0]);
my_ad_request.test_device_ids = kTestDeviceIDs;

Przekaż strukturę AdRequest do BannerView::LoadAd() i Interstitial::LoadAd() :

banner_view->LoadAd(my_ad_request);
interstitial_ad->LoadAd(my_ad_request);

Note: A single `AdRequest` struct can be reused for multiple calls.

Użyj Futures do monitorowania stanu zakończenia wywołań metod

Futures umożliwiają określenie stanu realizacji poprzednich wywołań metod BannerView lub InterstitialAd . Na przykład po wywołaniu metody InterstitialAd::LoadAd() tworzona jest i zwracana nowa Future. Aplikacje mogą sondować stan przyszłości, aby określić, kiedy reklama została załadowana. Gdy przyszłość dobiegnie końca, reklama pełnoekranowa jest gotowa do wyświetlenia w następnym naturalnym punkcie zatrzymania w Twojej aplikacji.

Większość metod w BannerView i InterstitialAd ma odpowiednią metodę „ostatniego wyniku”, której aplikacje mogą używać do pobierania najnowszej przyszłości dla danej akcji. Na przykład metoda InterstitialAd::LoadAd( InterstitialAd::LoadAd() ma odpowiednią metodę o nazwie InterstitialAd::LoadAdLastResult() . Zwraca Future, której można użyć do sprawdzenia statusu ostatniego wywołania metody InterstitialAd::LoadAd() .

Podobnie aplikacje mogą używać metody BannerView::InitializeLastResult() , aby uzyskać Future reprezentującą stan (i kod błędu, jeśli istnieje) ostatniego wywołania metody BannerView::Initialize() . Jeśli jego stan jest kompletny, a kod błędu to firebase::admob::kAdMobErrorNone , możesz wyświetlić widok banera, wywołując BannerView::Show() :

if (banner_view->InitializeLastResult().status() ==
    firebase::kFutureStatusComplete &&
    banner_view->InitializeLastResult().error() ==
    firebase::admob::kAdMobErrorNone) {
  banner_view->Show();
}

Po zakończeniu stanu Future dla ostatniego wywołania metody BannerView::Show() możesz załadować reklamę do widoku banera:

if (banner_view->ShowLastResult().status() ==
    firebase::kFutureStatusComplete &&
    banner_view->ShowLastResult().error() ==
    firebase::admob::kAdMobErrorNone) {
  banner_view->LoadAd(my_ad_request);
}

W przypadku reklam pełnoekranowych użyj metody InterstitialAd::InitializeLastResult() , aby uzyskać wartość Future reprezentującą stan (i kod błędu, jeśli występuje) ostatniego wywołania metody InterstitialAd::Initialize() . Jeśli jej stan jest kompletny, a kod błędu to firebase::admob::kAdMobErrorNone , możesz wczytać reklamę pełnoekranową:

if (interstitial_ad->InitializeLastResult().status() ==
    firebase::kFutureStatusComplete &&
    interstitial_ad->InitializeLastResult().error() ==
    firebase::admob::kAdMobErrorNone) {
  interstitial_ad->LoadAd(my_ad_request);
}

Po zakończeniu stanu Future dla ostatniego wywołania metody InterstitialAd::LoadAd() możesz wyświetlić reklamę pełnoekranową w następnym naturalnym punkcie zatrzymania w aplikacji:

if (interstitial_ad->LoadAdLastResult().status() ==
    firebase::kFutureStatusComplete &&
    interstitial_ad->LoadAdLastResult().error() ==
    firebase::admob::kAdMobErrorNone) {
  interstitial_ad->Show();
}

Możesz także zarejestrować wywołania zwrotne, które będą wywoływane po zakończeniu Future. Ten fragment kodu używa wskaźnika funkcji do wywołania zwrotnego:

// Initialize the interstitial ad.
interstitial_ad->Initialize(static_cast<firebase::admob::AdParent>(my_ad_parent), kInterstitialAdUnit);

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. In this example, we pass the interstitial ad object to be
// used in the OnCompletionCallback function.
interstitial_ad->InitializeLastResult().OnCompletion(OnCompletionCallback, interstitial_ad /*user_data*/);

// The OnCompletion callback function.
static void OnCompletionCallback(const firebase::Future<void>& future, void* user_data) {
  // Called when the Future is completed for the last call to the InterstitialAd::Initialize()
  // method. If the error code is firebase::admob::kAdMobErrorNone, then you're ready to
  // load the interstitial ad.
  firebase::admob::InterstitialAd *interstitial_ad = static_cast<firebase::admob::InterstitialAd*>(user_data);
  if (future.error() == firebase::admob::kAdMobErrorNone) {
    interstitial_ad->LoadAd(my_ad_request);
  }
}

Użyj detektora, aby otrzymywać powiadomienia o zdarzeniach w cyklu życia reklamy

AdMob udostępnia abstrakcyjną BannerView::Listener , którą można rozszerzyć i przekazać do metody BannerView::SetListener() , aby otrzymywać powiadomienia o zmianach stanu prezentacji widoku baneru i ramki ograniczającej. Podobna abstrakcyjna klasa InterstitialAd::Listener jest również dostępna dla reklam pełnoekranowych, które można rozszerzyć w celu otrzymywania powiadomień o zmianach stanu prezentacji reklamy pełnoekranowej.

Poniżej przykładowa implementacja klasy rozszerzającej klasę BannerView::Listener (podobną implementację można zastosować do reklam pełnoekranowych):

class ExampleBannerViewListener
    : public firebase::admob::BannerView::Listener {
public:
  ExampleBannerViewListener() {}

  void OnPresentationStateChanged(
      firebase::admob::BannerView* banner_view,
      firebase::admob::BannerView::PresentationState state) override {
    // This method gets called when the banner view's presentation
    // state changes.
  }

  void OnBoundingBoxChanged(
      firebase::admob::BannerView* banner_view,
      firebase::admob::BoundingBox box) override {
    // This method gets called when the banner view's bounding box
    // changes.
  }
};

Co dalej

Dowiedz się, jak zarabiać na swojej aplikacji dzięki AdMob, i pamiętaj, aby zastąpić identyfikatory testowej jednostki reklamowej używane w tym przewodniku własnymi identyfikatorami jednostki reklamowej.