Pierwsze kroki z AdMob w projekcie w C++

Ten krótki przewodnik jest przeznaczony dla wydawców i deweloperów, którzy chcą używać AdMob do zarabiania na aplikacji utworzonej za pomocą Firebase. Jeśli nie planujesz włączyć Firebase do swojej aplikacji, zapoznaj się z samodzielnym AdMob przewodnikiem.

Jeśli jeszcze tego nie zrobisz, dowiedz się więcej o zaletach korzystania z AdMob, Firebase i Google Analytics.

Jeśli korzystasz z tego przewodnika po raz pierwszy, zalecamy pobranie i postępowanie zgodnie z instrukcjami w aplikacji testowej pakietu SDK do reklam mobilnych Google w C++.

Zanim zaczniesz

• Jeśli nie masz jeszcze projektu Firebase ani aplikacji Firebase, skorzystaj z przewodnika dla początkujących użytkowników Firebase: Dodaj Firebase do projektu C++.

• Sprawdź, czy w projekcie Firebase włączona jest usługa Google Analytics:

  • Jeśli tworzysz nowy projekt Firebase, w trakcie tworzenia projektu włącz Google Analytics.

  • Jeśli masz dotychczasowy projekt Firebase bez włączonej usługi Google Analytics, możesz ją włączyć na karcie Integracje w sekcji settings > Ustawienia projektu.

Krok 1. Skonfiguruj aplikację na koncie AdMob

1. Zarejestruj każdy wariant aplikacji na danej platformie jako aplikację AdMob.

   1. Zaloguj się lub zarejestruj na koncie AdMob.

   2. Zarejestruj każdą wersję aplikacji na danej platformie w AdMob. W tym kroku utworzysz aplikację AdMob z unikalnym AdMobidentyfikatorem aplikacji, którego będziesz potrzebować w dalszej części tego przewodnika.

   Pojawi się prośba o dodanie do aplikacji pakietu SDK Mobile Ads. Szczegółowe instrukcje dotyczące tego zadania znajdziesz w dalszej części tego przewodnika.

2. Połącz każdą aplikację AdMob z odpowiednią aplikacją Firebase.

   Ten krok jest opcjonalny, ale zdecydowanie zalecany. Dowiedz się więcej o korzyściach płynących z włączenia danych o użytkownikach i połączenia aplikacji AdMob z Firebase.

   W przypadku każdego wariantu platformy wykonaj te 2 czynności w panelu Aplikacje na koncie AdMob:

   1. Włącz dane o użytkownikach, aby umożliwić usłudze AdMob przetwarzanie i wyświetlanie uporządkowanych danych analitycznych na koncie AdMob. To też wymagane ustawienie, aby połączyć aplikację AdMob z Firebase.

   2. Połącz aplikację AdMob z istniejącym projektem Firebase i odpowiednią aplikacją Firebase.

      Upewnij się, że wpisujesz tę samą nazwę pakietu (Android) lub identyfikator pakietu (iOS) co w przypadku aplikacji Firebase. Znajdź nazwę pakietu lub identyfikator pakietu aplikacji Firebase na karcie Twoje aplikacje w sekcji settings > Ustawienia projektu.

Krok 2. Dodaj do aplikacji identyfikator aplikacji AdMob

Android

Dodaj identyfikator aplikacji AdMob do pliku AndroidManifest.xml aplikacji, dodając tag <meta-data>, jak pokazano poniżej.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

iOS

W pliku Info.plist aplikacji dodaj klucz GADApplicationIdentifier o wartości ciągu znaków odpowiadającej AdMobidentyfikatorowi aplikacji.

Możesz wprowadzić tę zmianę programowo:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Możesz też edytować go w edytorze listy właściwości:

Krok 3. Dodaj pakiet SDK do reklam mobilnych Google

Pakiet SDK Google Mobile Ads w C++ znajduje się w przestrzeni nazw firebase::gma, więc pobierz pakiet SDK Firebase w C++, 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.

Android

1. W pliku gradle.properties projektu określ lokalizację rozpakowanego pakietu SDK:

   systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK

2. Dodaj do pliku settings.gradle projektu te informacje:

   def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')
   
   gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
   includeBuild "$firebase_cpp_sdk_dir"

3. Do pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle) dodaj następującą treść, która zawiera zależność biblioteki pakietu SDK C++ do reklam mobilnych Google.

   android.defaultConfig.externalNativeBuild.cmake {
     arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
   }
   
   # Add the dependency for the Google Mobile Ads C++ SDK
   apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
   firebaseCpp.dependencies {
     gma
   }

4. Dodaj do pliku CMakeLists.txt projektu te treści.

   # Add Firebase libraries to the target using the function from the SDK.
   add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)
   
   # Add the Google Mobile Ads C++ SDK.
   
   # The Firebase C++ library `firebase_app` is required,
   # and it must always be listed last.
   
   set(firebase_libs
     firebase_gma
     firebase_app
   )
   
   target_link_libraries(${target_name} "${firebase_libs}")

5. Zsynchronizuj aplikację, aby wszystkie zależności na pewno miały odpowiednie wersje.

To już wszystko Aplikacja w języku C++ jest skonfigurowana do korzystania z pakietu SDK do reklam mobilnych Google w języku C++.

iOS

W tej sekcji znajdziesz przykład dodawania pakietu SDK do reklam mobilnych Google w języku C++ do projektu na iOS.

1. Aby uzyskać CocoaPods w wersji 1 lub nowszej, wykonaj te czynności:

   sudo gem install cocoapods --pre

2. Dodaj Google Mobile Ads pod z rozpakowanego pakietu SDK.

   1. Utwórz plik Podfile, jeśli go nie masz:

      cd YOUR_APP_DIRECTORY
      pod init

   2. Dodaj do pliku Podfile pod do pakietu SDK do reklam mobilnych Google w C++:

      pod 'Google-Mobile-Ads-SDK'

   3. Zainstaluj poda, a następnie otwórz plik .xcworkspace w Xcode.

      pod install
      open YOUR_APP.xcworkspace

   4. Dodaj do projektu te frameworki z pakietu SDK Firebase C++:

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

To już wszystko Aplikacja w języku C++ jest skonfigurowana do korzystania z pakietu SDK do reklam mobilnych Google w języku C++.

Krok 4. Zainicjuj pakiet SDK do reklam mobilnych Google

Przed wczytywaniem reklam zainicjuj pakiet SDK Mobile Ads, wywołując funkcję firebase::gma::Initialize().

To wywołanie zwraca firebase::Future, które kończy się po zakończeniu inicjalizacji (lub po 30 sekundach bezczynności). Wywołuj tę metodę tylko raz i jak najszybciej, najlepiej podczas uruchamiania aplikacji.

Oto przykład wywołania funkcji 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 Future do monitorowania stanu zakończenia wywołania metody

Future umożliwia określenie stanu zakończenia asynchronicznych wywołań metody.

Jeśli na przykład aplikacja wywołuje firebase::gma::Initialize(), zostaje utworzony i zwrócony nowy element firebase::Future. Aplikacja może następnie sprawdzać status() Future, aby określić, kiedy inicjalizacja została zakończona. Po zakończeniu działania metoda result() może wywołać metodę result(), aby uzyskać parametr AdapterInitializationStatus.

Metody, które zwracają wartość Future, mają odpowiednią metodę „ostatni wynik”, której aplikacje mogą używać do pobierania najnowszych wartości 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 niektórych przypadkach wywołanie zwrotne będzie wykonywane w innym wątku, dlatego upewnij się, że Twój kod jest bezpieczny w takim przypadku. Ten fragment kodu wykorzystuje wskaźnik funkcji 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.
  }
}

Krok 5. Wybierz format reklamy do implementacji w aplikacji

AdMob oferuje wiele różnych formatów reklam, więc możesz wybrać ten, który najlepiej odpowiada potrzebom użytkowników Twojej aplikacji. Kliknij przycisk formatu reklamy, aby wyświetlić szczegółowe instrukcje implementacji w dokumentacji AdMob.

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ą odświeżać się automatycznie po upływie określonego czasu. Jeśli dopiero zaczynasz korzystać z reklam mobilnych, powinien on być dla Ciebie przydatnym punktem wyjścia.

Pełnoekranowa

reklamy pełnoekranowe, które zakrywają interfejs aplikacji, dopóki użytkownik ich nie zamknie;

Reklamy pełnoekranowe najlepiej wyświetlać w naturalnych przerwach w działaniu aplikacji, np. między poziomami w grze lub tuż po ukończeniu zadania.

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 gry oraz wypełnianie ankiet

Reklamy z nagrodą (lub „oparte na nagrodzie”) mogą pomóc w zarabianiu na użytkownikach bezpłatnych gier.

Wdrażanie reklam z nagrodą

Inne interesujące tematy

Wyświetlanie danych o użytkownikach i danych analitycznych

Po zainicjowaniu pakiet SDK Mobile Ads automatycznie rozpocznie rejestrowanie z aplikacji zdarzeń Analytics i właściwości użytkownika. Możesz wyświetlać te dane bez dodawania dodatkowego kodu do aplikacji ani implementowania reklam. Oto gdzie możesz zobaczyć te dane analityczne:

• Na karcie Dane o użytkownikach na koncie AdMob (w panelu Strona główna lub Aplikacje) możesz wyświetlać wybrane dane o użytkownikach pochodzące z zebranych danych analitycznych, takie jak średni czas trwania sesji, ARPU czy utrzymanie użytkowników.

• W panelu Analytics w konsoli Firebase możesz wyświetlać zbiorcze statystyki i podsumowania kluczowych wskaźników. Jeśli dodasz pakiet SDK Firebase do Google Analytics, możesz też oznaczać konwersje w kampaniach reklamowych i tworzyć listy odbiorców niestandardowych w konsoli Firebase.