Rozpocznij

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

Pierwszym krokiem, który musisz wykonać, aby zacząć wyświetlać reklamy i zarabiać, jest integracja pakietu SDK do reklam mobilnych Google w C++ z Twoją aplikacją. Po zintegrowaniu pakietu SDK możesz: wybierz format reklamy, np. pełnoekranowa lub z nagrodą, i postępuj zgodnie z instrukcjami, go wdrożyć.

Pakiet SDK do reklam mobilnych Google w języku C++ zawiera pakiety SDK do reklam mobilnych Google na iOS i Androida, i jest dostępna tylko na tych platformach. Pakiet SDK do reklam mobilnych Google w języku C++ sprawia, użycia konstrukcji Firebase C++ do obsługi operacji asynchronicznych, więc znajduje się w przestrzeni nazw firebase::gma.

Jeśli korzystasz z tego przewodnika po raz pierwszy, zalecamy pobierz i postępuj zgodnie z instrukcjami, korzystając z testu w języku C++ dla reklam mobilnych Google

Wymagania wstępne

Konfigurowanie aplikacji na koncie AdMob

Aby zarejestrować aplikację jako aplikację AdMob, wykonaj te czynności:

1. Zaloguj się lub zarejestruj się konta AdMob.

2. Zarejestruj aplikację w AdMob. W tym kroku tworzymy aplikacja z unikalnym identyfikatorem aplikacji AdMob które będą potrzebne w dalszej części tego przewodnika.

Zainstaluj pakiet SDK do reklam mobilnych Google w C++

Pakiet SDK do reklam mobilnych Google w języku C++ znajduje się w przestrzeni nazw firebase::gma, pobierz pakiet Firebase C++ SDK, a następnie rozpakuj go do wybranego katalogu.

Pakiet SDK Firebase C++ nie jest przeznaczony tylko dla jednej platformy, ale wymaga konfiguracji biblioteki dla danej platformy.

Wszystko gotowe Twoja aplikacja w C++ jest skonfigurowana tak, aby używać pakietu SDK do reklam mobilnych Google w języku C++ bez żadnych innych usług Firebase.

Skonfiguruj identyfikator aplikacji AdMob

Inicjalizacja pakietu SDK do reklam mobilnych Google

Przed wczytaniem reklam poproś aplikację o zainicjowanie pakietu SDK do reklam mobilnych Google w języku C++ przez wywołaną funkcję firebase::gma::Initialize(), która inicjuje pakiet SDK i wykonuje firebase::Future po zakończeniu inicjowania (lub po 30 sekundach) ). Wystarczy to zrobić tylko raz, najlepiej podczas uruchamiania aplikacji.

Reklamy mogą być wstępnie wczytywane przez pakiet SDK do reklam mobilnych Google w języku C++ lub pakiety SDK partnera zapośredniczenia po wywołaniu numeru Initialize(). Jeśli musisz uzyskać zgodę od użytkowników w Europejskim Obszarze Gospodarczym (EOG), ustaw wszelkie flagi dotyczące konkretnych żądań (np. tag_for_child_directed_treatment lub tag_for_under_age_of_consent) albo w przeciwnym razie przed wczytaniem reklam należy wykonać firebase::gma::SetRequestConfiguration() przed zainicjowaniem aplikacji Google Mobile SDK Google Ads w C++. Więcej informacji znajdziesz w Przewodnik po kierowaniu.

Oto przykład, jak zadzwonić pod numer 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żyj Future do monitorowania stanu zakończenia wywołania metody

Future pozwala określić stan ukończenia asynchronicznych wywołań metod.

Na przykład, gdy aplikacja zadzwoni pod numer firebase::gma::Initialize(), zostanie wyświetlony nowy Element firebase::Future został utworzony i zwrócony. Aplikacja może wtedy przeprowadzać ankiety status() z Future, aby określić czas zakończenia inicjowania. Po zakończeniu aplikacja może wywołać metodę result(), aby uzyskać wynik AdapterInitializationStatus

Metody, które zwracają wartość Future, mają odpowiedni „ostatni wynik” które aplikacje, których mogą używać do pobierania najnowszych danych z kategorii Future dla danego działania. Na przykład firebase::gma::Initialize() ma odpowiednią metodę o nazwie firebase::gma::InitializeLastResult(), która zwraca wartość Future, której Twoja aplikacja może użyć do sprawdzenia stanu ostatniego wywołania funkcji firebase::gma::Initialize().

Jeśli stan Future to „complete” (ukończono) i jego kod błędu to firebase::gma::kAdErrorCodeNone, oznacza to, że operacja została ukończona pomyślnie.

Możesz też zarejestrować wywołania zwrotne, które mają być wywoływane po zakończeniu Future. W w niektórych przypadkach wywołanie zwrotne będzie uruchamiane w innym wątku, więc upewnij się, czyli kod musi być bezpieczny w wątkach. 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 języku C++ został zaimportowany. Możesz go zaimplementować reklama. AdMob oferuje wiele różnych formatów reklam, możesz więc wybrać ten, który które najlepiej pasują do korzystania z Twojej aplikacji.

Baner

Kwadratowe reklamy wyświetlane u góry lub na dole ekranu urządzenia. Banery reklamowe pozostają na ekranie, gdy użytkownicy wchodzą w interakcję z aplikacją i mogą są odświeżane automatycznie po upływie określonego czasu. Jeśli dopiero zaczynasz korzystać z urządzeń mobilnych reklamy, to dobry 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 procesie wykonywania aplikacji, np. między poziomami gry lub tuż po ukończeniu zadania.

Zastosuj reklamy pełnoekranowe

Z nagrodą

Reklamy, które umożliwiają nagradzanie użytkowników w zamian za oglądanie krótkich filmów, wchodzenie w interakcje z reklamami demonstracyjnymi gier oraz wypełnianie ankiet. Umożliwia zarabianie na bezpłatnych aplikacjach.

Wdróż reklamy z nagrodą