Rozpocznij

Ten przewodnik jest przeznaczony dla wydawców, którzy chcą zarabiać na aplikacji C++ za pomocą AdMob bez korzystania z Firebase. Jeśli planujesz uwzględnić Firebase w swojej aplikacji lub rozważasz taką możliwość, zapoznaj się z wersją tego przewodnika dotyczącą AdMob z Firebase.

Zintegrowanie pakietu SDK do reklam mobilnych Google w C++ z aplikacją to pierwszy krok do wyświetlania reklam i generowania przychodów. Po zintegrowaniu pakietu SDK możesz wybrać format reklamy, np. pełnoekranową lub z nagrodą, i wykonać czynności, aby go wdrożyć.

Pakiet SDK do reklam mobilnych Google w C++ zawiera pakiety SDK do reklam mobilnych Google na iOS i Androida i jest dostępny tylko na tych platformach. Pakiet SDK do reklam mobilnych Google w C++ korzysta z konstrukcji Firebase w C++, aby obsługiwać operacje asynchroniczne, więc znajduje się w przestrzeni nazw firebase::gma.

Jeśli po raz pierwszy korzystasz z tego przewodnika, zalecamy pobranie aplikacji testowej Google Mobile Ads w C++ i postępowanie zgodnie z instrukcjami.

Wymagania wstępne

Konfigurowanie aplikacji na koncie AdMob

Aby zarejestrować aplikację jako aplikację w AdMob:

1. Zaloguj się lub zarejestruj na konto AdMob.

2. Zarejestruj aplikację w AdMob. W ten sposób utworzysz aplikację w AdMob z unikalnym identyfikatorem aplikacji w AdMob, który będzie potrzebny w dalszej części tego przewodnika.

Instalowanie pakietu SDK do reklam mobilnych Google w C++

Pakiet SDK do reklam mobilnych Google w C++ znajduje się w przestrzeni nazw firebase::gma, dlatego pobierz pakiet Firebase C++ SDK i rozpakuj go do wybranego katalogu.

Pakiet Firebase C++ SDK nie jest przeznaczony na konkretną platformę, ale wymaga konfiguracji bibliotek na poszczególnych platformach.

Wszystko gotowe Twoja aplikacja w C++ jest skonfigurowana do korzystania z pakietu SDK do reklam mobilnych Google w C++ bez żadnych innych usług Firebase.

Konfigurowanie identyfikatora aplikacji w AdMob

Inicjowanie pakietu SDK do reklam mobilnych Google

Zanim aplikacja wczyta reklamy, musi zainicjować pakiet SDK do reklam mobilnych Google w C++, wywołując funkcję firebase::gma::Initialize(), która inicjuje pakiet SDK i po zakończeniu inicjowania (lub po 30 sekundach bezczynności) zwraca firebase::Future. Należy to zrobić tylko raz, najlepiej przy uruchomieniu aplikacji.

Reklamy mogą być wstępnie wczytywane przez pakiet SDK do reklam mobilnych Google w C++ lub pakiety SDK partnerów zapośredniczenia po wywołaniu funkcji Initialize(). Jeśli musisz uzyskać zgodę użytkowników z Europejskiego Obszaru Gospodarczego (EOG), ustawić flagi związane z żądaniem (np. tag_for_child_directed_treatment lub tag_for_under_age_of_consent) albo podjąć inne działania przed wczytaniem reklam, pamiętaj, aby wywołać funkcję firebase::gma::SetRequestConfiguration() przed zainicjowaniem pakietu SDK do reklam mobilnych Google w C++. Więcej informacji znajdziesz w naszym przewodniku po kierowaniu.

Oto przykład wywołania Initialize():

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

Używanie obiektu Future do monitorowania stanu realizacji wywołania metody

Future umożliwia określenie stanu ukończenia wywołań metod asynchronicznych.

Na przykład gdy aplikacja wywołuje firebase::gma::Initialize(), tworzony i zwracany jest nowy obiekt firebase::Future. Aplikacja może następnie odpytywać status() zasobu Future, aby określić, kiedy inicjowanie zostało zakończone. Po zakończeniu aplikacja może wywołać result(), aby uzyskać wynik AdapterInitializationStatus.

Metody, które zwracają obiekt Future, mają odpowiadającą im metodę „ostatni wynik”, której aplikacje mogą używać do pobierania najnowszego obiektu Future dla danego działania. Na przykład firebase::gma::Initialize() ma odpowiednią metodę o nazwie firebase::gma::InitializeLastResult(), która zwraca obiekt Future. Aplikacja może go użyć do sprawdzenia stanu ostatniego wywołania metody firebase::gma::Initialize().

Jeśli stan Future to „ukończono”, a kod błędu to firebase::gma::kAdErrorCodeNone, operacja zakończyła się pomyślnie.

Możesz też zarejestrować wywołania zwrotne, które mają być wywoływane po zakończeniu działania Future. W niektórych przypadkach wywołanie zwrotne będzie działać w innym wątku, więc upewnij się, że kod jest wątkowo bezpieczny. Ten fragment kodu używa wskaźnika funkcji do wywołania zwrotnego:

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
  /*user_data=*/nullptr);

// The OnCompletion callback function.
static void OnCompletionCallback(
  const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
  // Called when the Future is completed for the last call to firebase::gma::Initialize().
  // If the error code is firebase::gma::kAdErrorCodeNone,
  // then the SDK has been successfully initialized.
  if (future.error() == firebase::gma::kAdErrorCodeNone) {
    // success!
  } else {
    // failure.
  }
}

Wybierz format reklamy

Pakiet SDK do reklam mobilnych Google w C++ został zaimportowany i możesz teraz zaimplementować reklamę. AdMob oferuje wiele różnych formatów reklam, dzięki czemu możesz wybrać ten, który najlepiej pasuje do Twojej aplikacji.

Baner

Prostokątne reklamy, które wyświetlają się u góry lub u dołu ekranu urządzenia. Banery reklamowe pozostają na ekranie, gdy użytkownicy wchodzą w interakcję z aplikacją, i mogą być automatycznie odświeżane po upływie określonego czasu. Jeśli dopiero zaczynasz przygodę z reklamą mobilną, to świetny punkt wyjścia.

Implementowanie banerów reklamowych

Pełnoekranowa

Reklamy pełnoekranowe, które zakrywają interfejs aplikacji, dopóki użytkownik ich nie zamknie. Najlepiej używać ich w naturalnych przerwach w działaniu aplikacji, np. między poziomami gry lub tuż po ukończeniu zadania.

Zaimplementuj reklamy pełnoekranowe

Z nagrodą

Reklamy, które nagradzają użytkowników za oglądanie krótkich filmów i wchodzenie w interakcje z reklamami demonstracyjnymi gier oraz wypełnianie ankiet. Służy do zarabiania na grach bezpłatnych.

Wdrażanie reklam z nagrodą