Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Начать

Вы можете использовать AdMob для показа рекламы в своих приложениях C ++. В этом руководстве показано, как интегрироваться с Firebase и взаимодействовать с SDK Google Mobile Ads.

Если вы впервые изучаете это руководство, рекомендуется загрузить его и выполнить с помощью тестового приложения AdMob .

Интеграция с Firebase

  1. Выполните шаги в разделе « Настройка для iOS» или « Настройка для Android », чтобы добавить AdMob и Firebase в свое приложение C ++.

  2. Включите следующие заголовки в код C ++ вашего приложения:

     #include "firebase/admob.h"
    #include "firebase/admob/types.h"
    #include "firebase/app.h"
    #include "firebase/future.h"
     
  3. Добавьте следующее в код C ++ в своем приложении, чтобы инициализировать библиотеку AdMob с помощью идентификатора приложения AdMob (этот код должен быть выполнен до создания представления баннера или промежуточной рекламы):

     #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);
     

Взаимодействовать с Google Mobile Ads SDK

Установите идентификаторы рекламных блоков

При написании кода C ++, который поддерживается на iOS и Android, вам может понадобиться использовать директивы препроцессора для определения кода, который должен компилироваться только в конкретной ОС. Для показа баннерной и промежуточной рекламы на iOS и Android рекомендуется создать новый идентификатор рекламного блока для каждой ОС и каждого уникального места размещения рекламы. Следующие идентификаторы рекламных блоков были созданы для iOS и Android и настроены на постоянную показ тестовых объявлений:

 #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
 

Настройте вид баннера

Добавьте следующий заголовок в код C ++ вашего приложения:

 #include "firebase/admob/banner_view.h"
 

Объявите и BannerView экземпляр объекта BannerView :

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

Создайте AdSize и инициализируйте вид баннера:

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

Настройте промежуточную рекламу

Добавьте следующий заголовок в код C ++ вашего приложения:

 #include "firebase/admob/interstitial_ad.h"
 

Объявите и создайте экземпляр объекта InterstitialAd :

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

Инициализируйте промежуточную рекламу:

 // 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);
 

Создайте запрос рекламы AdMob

Библиотека AdMob позволяет вам предоставить информацию о таргетинге на запрос объявления. Это делается путем установки членов структуры AdRequest . Затем структура передается в метод BannerView::LoadAd() или InterstitialAd::LoadAd() .

Для получения общей информации о таргетинге и настройке рекламных запросов ознакомьтесь с нашими руководствами по таргетингу на iOS и Android .

Вот структура AdRequest используемая BannerView и InterstitialAd для создания запроса объявления:

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

Объявите и инициализируйте структуру AdRequest :

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

Следующий код устанавливает значения AdRequest структуры AdRequest для добавления информации о таргетинге в запрос объявления.

 // 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;
 

Пропустите AdRequest - структуру в BannerView::LoadAd() и 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.
 

Используйте фьючерсы для контроля состояния завершения вызовов методов

Фьючерсы предоставляют вам способ определения статуса завершения ваших предыдущих BannerView метода BannerView или InterstitialAd . Например, когда InterstitialAd::LoadAd() метод InterstitialAd::LoadAd() , создается и возвращается новое будущее. Приложения могут опрашивать статус Future, чтобы определить, когда было загружено объявление. Как только будущее завершено, промежуточная реклама готова к показу на следующей естественной остановке в вашем приложении.

Большинство методов в BannerView и InterstitialAd имеют соответствующий метод «последнего результата», который приложения могут использовать для получения самого последнего Future для данного действия. InterstitialAd::LoadAd() метод, например, имеет соответствующий метод , называемый InterstitialAd::LoadAdLastResult() . Он возвращает Future, который можно использовать для проверки состояния последнего вызова метода InterstitialAd::LoadAd() .

Точно так же приложения могут использовать метод BannerView::InitializeLastResult() чтобы получить Future, представляющий состояние (и код ошибки, если таковой имеется) последнего вызова BannerView::Initialize() . Если его статус завершен, а его код ошибки - firebase::admob::kAdMobErrorNone , тогда вы готовы сделать вид баннера видимым, вызвав метод BannerView::Show() :

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

Как только статус Future для последнего вызова BannerView::Show() будет готов, вы готовы загрузить объявление в представление баннера:

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

Для промежуточных объявлений используйте метод InterstitialAd::InitializeLastResult() чтобы получить Future, представляющий статус (и код ошибки, если есть) последнего вызова метода InterstitialAd::Initialize() . Если его статус завершен и его код ошибки - firebase::admob::kAdMobErrorNone , то вы готовы загрузить промежуточную рекламу:

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

Как только статус Future для последнего вызова метода InterstitialAd::LoadAd() будет завершен, вы готовы отобразить промежуточную рекламу в следующей естественной точке остановки в вашем приложении:

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

Вы также можете зарегистрировать обратные вызовы, которые будут вызваны, когда будущее завершено. Этот фрагмент кода использует указатель функции для обратного вызова:

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

Используйте слушателя, чтобы получать уведомления о событиях жизненного цикла рекламы

AdMob предоставляет абстрактный BannerView::Listener , который можно расширить и передать в метод BannerView::SetListener() , чтобы получать уведомления об изменениях состояния представления представления баннера и ограничительной рамки. Аналогичный абстрактный класс InterstitialAd::Listener также предоставляется для промежуточной рекламы, которую можно расширить, чтобы получать уведомления об изменениях в состоянии представления промежуточной рекламы.

Ниже приведен пример реализации класса, который расширяет класс BannerView::Listener (аналогичная реализация может использоваться для промежуточной рекламы):

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

Что дальше

Узнайте, как монетизировать свое приложение с AdMob, и обязательно замените идентификаторы тестового рекламного блока, используемые в этом руководстве, на свои собственные идентификаторы рекламного блока.