Rozpocznij

Ten przewodnik jest przeznaczony dla wydawców, którzy chcą zarabiać na aplikacji w 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.

Integracja pakietu SDK do reklam mobilnych Google w języku 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ę na konto AdMob lub zarejestruj się.

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 języku C++

Pakiet SDK do reklam mobilnych Google w C++ znajduje się w przestrzeni nazw firebase::gma, dlatego pobierz pakiet Firebase C++ SDK, a następnie 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 wykonuje firebase::Future po zakończeniu inicjowania (lub po 30 sekundach bezczynności). 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 przed zainicjowaniem pakietu SDK do reklam mobilnych Google w C++ wywołać funkcję firebase::gma::SetRequestConfiguration(). Więcej informacji znajdziesz w naszym przewodniku po kierowaniu.

Oto przykład wywołania metody 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 ukończenia wywołania metody

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

Na przykład gdy aplikacja wywołuje firebase::gma::Initialize(), tworzony i zwracany jest nowy obiekt firebase::Future. Aplikacja może następnie odpytywać pole status() obiektu 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 Future, którego aplikacja może 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 zakończeniu zadania.

Implementowanie reklam pełnoekranowych

Z nagrodą

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

Wdrażanie reklam z nagrodą