Inizia

Questa guida è rivolta ai publisher che vogliono monetizzare un'app C++ con AdMob, senza utilizzare Firebase. Se prevedi di includere Firebase nella tua app o se stai valutando questa opzione, consulta la versione di questa guida AdMob con Firebase.

L'integrazione dell'SDK Google Mobile Ads C++ in un'app è il primo passo per mostrare annunci display e generare entrate. Una volta integrato l'SDK, puoi scegliere un formato dell'annuncio, ad esempio interstitial o con premio, e seguire i passaggi per implementarlo.

L'SDK Google Mobile Ads per C++ include gli SDK Google Mobile Ads per iOS e Android ed è disponibile solo su queste piattaforme. L'SDK Google Mobile Ads C++ utilizza i costrutti Firebase C++ per supportare le operazioni asincrone, pertanto si trova nello spazio dei nomi firebase::gma.

Se è la prima volta che consulti questa guida, ti consigliamo di scaricare e seguire l'app di test Google Mobile Ads C++.

Prerequisiti

Configura l'app nel tuo account AdMob

Registra la tua app come app monetizzata con AdMob completando i seguenti passaggi:

1. Accedi o registrati per creare un account AdMob.

2. Registra l'app con AdMob. Questo passaggio crea un'app monetizzata con AdMob con un ID app AdMob univoco, necessario più avanti in questa guida.

Installa l'SDK Google Mobile Ads C++

Poiché l'SDK Google Mobile Ads C++ si trova nello spazio dei nomi firebase::gma, scarica l'SDK Firebase C++ e poi decomprimilo in una directory di tua scelta.

L'SDK Firebase C++ non è specifico per una piattaforma, ma richiede configurazioni di librerie specifiche per la piattaforma.

Ecco fatto! La tua app C++ è configurata per utilizzare l'SDK Google Mobile Ads C++ senza altri servizi Firebase.

Configura l'ID app monetizzata con AdMob della tua app

Inizializza l'SDK Google Mobile Ads

Prima di caricare gli annunci, l'app deve inizializzare l'SDK Google Mobile Ads C++ chiamando firebase::gma::Initialize(), che inizializza l'SDK e completa un firebase::Future una volta completata l'inizializzazione (o dopo un timeout di 30 secondi). Questa operazione deve essere eseguita una sola volta, idealmente al lancio dell'app.

Gli annunci possono essere precaricati dall'SDK Google Mobile Ads per C++ o dagli SDK dei partner di mediazione quando viene chiamato Initialize(). Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), impostare eventuali flag specifici per la richiesta (come tag_for_child_directed_treatment o tag_for_under_age_of_consent) o intraprendere altre azioni prima di caricare gli annunci, assicurati di farlo richiamando firebase::gma::SetRequestConfiguration() prima di inizializzare l'SDK Google Mobile Ads C++. Per saperne di più, consulta la nostra guida al targeting.

Ecco un esempio di come chiamare 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.
}

Utilizza un Future per monitorare lo stato di completamento di una chiamata al metodo

Un Future ti consente di determinare lo stato di completamento delle chiamate ai metodi asincroni.

Ad esempio, quando la tua app chiama firebase::gma::Initialize(), viene creato e restituito un nuovo firebase::Future. L'app può quindi eseguire il polling del campo status() di Future per determinare quando l'inizializzazione è stata completata. Al termine, l'app può richiamare result() per ottenere l'oggetto AdapterInitializationStatus risultante.

I metodi che restituiscono un oggetto Future hanno un metodo "ultimo risultato" corrispondente che le app possono utilizzare per recuperare l'oggetto Future più recente per una determinata azione. Ad esempio, firebase::gma::Initialize() ha un metodo corrispondente chiamato firebase::gma::InitializeLastResult(), che restituisce un Future che la tua app può utilizzare per controllare lo stato dell'ultima chiamata a firebase::gma::Initialize().

Se lo stato di Future è completo e il codice di errore è firebase::gma::kAdErrorCodeNone, l'operazione è stata completata correttamente.

Puoi anche registrare i callback da richiamare al completamento di un Future. In alcuni casi, il callback verrà eseguito in un thread diverso, quindi assicurati che il tuo codice sia thread-safe. Questo snippet di codice utilizza un puntatore di funzione per il callback:

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

Seleziona un formato dell'annuncio

L'SDK Google Mobile Ads C++ è stato importato e ora puoi implementare un annuncio. AdMob offre diversi formati degli annunci, così puoi scegliere quello che meglio si adatta all'esperienza utente della tua app.

Banner

Annunci rettangolari che vengono visualizzati nella parte superiore o inferiore dello schermo del dispositivo. Gli annunci banner rimangono sullo schermo durante l'interazione degli utenti con l'app e possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità mobile, sono un ottimo punto di partenza.

Implementa gli annunci banner

Interstitial

Annunci a schermo intero che coprono l'interfaccia di un'app finché non vengono chiusi dall'utente. È consigliabile utilizzarli in momenti di pausa naturale nel flusso di esecuzione di un'app, ad esempio tra i livelli di un gioco o subito dopo il completamento di un'attività.

Implementa gli annunci interstitial

Con premio

Annunci che premiano gli utenti per la visione di brevi video e/o l'interazione con annunci demo e sondaggi. Utilizzati per monetizzare le app free-to-play.

Implementa gli annunci con premio