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 prendendo in considerazione l'idea, consulta il documento AdMob con Firebase di questo guida.

L'integrazione dell'SDK Google Mobile Ads C++ in un'app è il primo passo per poter mostrare annunci 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++ racchiude gli SDK Google Mobile Ads per iOS e Android ed è disponibile solo su queste piattaforme. L'SDK Google Mobile Ads C++ rende utilizzare i costrutti C++ di Firebase per supportare le operazioni asincrone, in modo che risiedono nello spazio dei nomi firebase::gma.

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

Prerequisiti

Configurare l'app nell'account AdMob

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

1. Accedi a o registrati per un account AdMob.

2. Registra la tua app con AdMob. Questo passaggio crea un'app AdMob con un ID app AdMob univoco necessario in un secondo momento 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 quindi decomprimilo in una directory a tua scelta.

L'SDK Firebase C++ non è specifico della piattaforma, ma richiede configurazioni delle librerie specifiche della piattaforma.

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

Configurare l'ID app AdMob della tua app

Inizializza l'SDK Google Mobile Ads

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

Gli annunci possono essere precaricati dall'SDK Google Mobile Ads C++ o dagli SDK dei partner di mediazione al momento della chiamata a Initialize(). Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), imposta eventuali flag specifici per la richiesta (ad es. tag_for_child_directed_treatment o tag_for_under_age_of_consent) o intervieni in altro modo prima di caricare gli annunci, assicurati di farlo chiamando firebase::gma::SetRequestConfiguration() prima di inizializzare l'SDK Google Mobile Ads C++. Per ulteriori informazioni, 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.
}

Utilizzare un Future per monitorare lo stato di completamento di una chiamata di 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(), una nuova firebase::Future creato e restituito. L'app può quindi eseguire il polling status() di Future per determinare quando è stata completata l'inizializzazione. Al termine, l'app può richiamare result() per ottenere il risultato AdapterInitializationStatus.

I metodi che restituiscono un Future hanno un metodo "ultimo risultato" corrispondente che le app possono utilizzare per recuperare il Future più recente per una determinata azione. Per Ad esempio, firebase::gma::Initialize() ha un metodo corrispondente chiamato firebase::gma::InitializeLastResult(), che restituisce un Future che la tua app che puoi 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 chiamare al termine di un Future. Nella alcuni casi, il callback verrà eseguito su un thread diverso, quindi assicurati il codice sia sicuro per i thread. Questo snippet di codice utilizza un puntatore 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 puoi implementare un annuncio. AdMob offre diversi formati dell'annuncio per consentirti di scegliere quello più adatto che si adatta meglio 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 mentre gli utenti interagiscono con l'app e possono vengono aggiornate automaticamente dopo un certo periodo di tempo. Se non hai mai utilizzato un dispositivo mobile pubblicità, sono un ottimo punto di partenza.

Implementare gli annunci banner

Interstitial

Annunci a schermo intero che coprono l'interfaccia di un'app fino alla chiusura dell'utente. Sono ideali per le interruzioni naturali nel flusso di esecuzione di un'app, ad esempio tra i livelli di un gioco o subito dopo il completamento di un'attività.

Implementare gli annunci interstitial

Con premio

Annunci che premiano gli utenti per la visione di brevi video e l'interazione con contenuti riproducibili annunci e sondaggi. Utilizzato per monetizzare le app free-to-play.

Implementare gli annunci con premio