Começar

Este guia é destinado a editores que querem gerar receita com um app C++ usando a AdMob, sem usar o Firebase. Se você planeja incluir o Firebase no seu app ou se você está considerando essa opção, consulte a versão do guia AdMob com Firebase.

A integração do SDK dos anúncios para dispositivos móveis do Google para C++ a um app é a primeira etapa para exibir anúncios e gerar receita. Depois de integrar o SDK, você pode escolher um formato de anúncio, como intersticial ou premiado, e seguir as etapas para implementá-lo.

O SDK dos anúncios para dispositivos móveis do Google para C++ envolve os SDKs do iOS e do Android, e está disponível apenas nessas plataformas. O SDK dos anúncios para dispositivos móveis do Google para C++ usa conceitos do Firebase para C++ para oferecer suporte a operações assíncronas. Por isso, ele fica no namespace firebase::gma.

Se essa for a primeira vez que você consulta este guia, recomendamos fazer o download do app de teste do SDK dos anúncios para dispositivos móveis do Google para C++.

Pré-requisitos

Configurar o app na conta da AdMob

Siga estas etapas para registrar seu app como um app da AdMob:

1. Faça login ou crie uma conta da AdMob.

2. Registre seu app na AdMob. Essa etapa cria um app da AdMob com um ID exclusivo que será necessário mais adiante neste guia.

Instalar o SDK dos anúncios para dispositivos móveis do Google para C++

Como o SDK dos anúncios para dispositivos móveis do Google para C++ reside no namespace firebase::gma, faça o download do SDK do Firebase para C++ e descompacte-o no diretório de sua preferência.

O SDK do Firebase para C++ não é específico de uma plataforma, mas requer configurações de bibliotecas que são.

Tudo pronto! Seu app em C++ está configurado para usar o SDK dos anúncios para dispositivos móveis do Google para C++ sem outros serviços do Firebase.

Configurar o ID do app AdMob

Inicializar o SDK de anúncios do Google para dispositivos móveis

Antes de carregar anúncios, inicialize o SDK dos anúncios para dispositivos móveis do Google em C++ chamando firebase::gma::Initialize(), que inicializa o SDK e conclui um firebase::Future quando a inicialização é concluída (ou após um tempo limite de 30 segundos). Isso precisa ser feito apenas uma vez, de preferência na inicialização do app.

Os anúncios podem ser pré-carregados pelo SDK dos anúncios para dispositivos móveis do Google para C++ ou SDKs de parceiros de mediação ao chamar Initialize(). Se você precisar do consentimento de usuários no Espaço Econômico Europeu (EEE), defina sinalizadores específicos de solicitações (como tag_for_child_directed_treatment ou tag_for_under_age_of_consent) ou aja antes de carregar os anúncios. Para isso, invoque firebase::gma::SetRequestConfiguration() antes de inicializar o SDK dos anúncios para dispositivos móveis do Google em C++. Para mais informações, consulte nosso guia de segmentação.

Confira um exemplo de como chamar 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.
}

Usar um Future para monitorar o status de conclusão de uma chamada de método

Um Future permite determinar o status de conclusão das suas chamadas de método assíncronas.

Por exemplo, quando seu app chama firebase::gma::Initialize(), um novo firebase::Future é criado e retornado. Seu app vai poder consultar o status() do Future para determinar quando a inicialização foi concluída. Depois da conclusão, seu app vai poder invocar result() para receber o AdapterInitializationStatus resultante.

Os métodos que retornam um Future têm um método de "último resultado" correspondente que os apps podem usar para recuperar o Future mais recente de uma determinada ação. Por exemplo, firebase::gma::Initialize() tem um método correspondente chamado firebase::gma::InitializeLastResult(), que retorna um Future que pode ser usado pelo seu app para verificar o status da última chamada para firebase::gma::Initialize().

Se o status de Future for concluído e o código de erro for firebase::gma::kAdErrorCodeNone, significa que a operação foi concluída com sucesso.

Além disso, callbacks podem ser registrados para que sejam invocados quando um Future for concluído. Em alguns casos, o callback vai ser executado em uma linha de execução diferente. Verifique se o código é thread-safe. Este snippet de código usa um ponteiro de função para o 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.
  }
}

Selecionar um formato de anúncio

O SDK dos anúncios para dispositivos móveis do Google para C++ foi importado, e você já pode implementar um anúncio. A AdMob oferece vários formatos de anúncio diferentes para que você possa escolher o mais adequado à experiência do usuário no seu app.

Banner

Anúncios retangulares que aparecem na parte de cima ou de baixo da tela do dispositivo. Os anúncios de banner permanecem na tela enquanto os usuários interagem com o app e podem ser atualizados automaticamente após um determinado período. Se você começou a usar os anúncios para dispositivos móveis agora, saiba que eles são um bom lugar para começar.

Implementar anúncios de banner

Intersticial

Anúncios em tela cheia que cobrem a interface de um app até serem fechados pelo usuário. Eles são melhores em pausas naturais no fluxo de execução de um app, como entre as fases de um jogo ou logo após a conclusão de uma tarefa.

Implementar anúncios intersticiais

Premiado

Anúncios que recompensam os usuários por assistir a vídeos curtos e interagir com pesquisas e anúncios jogáveis. Usado para gerar receita com apps sem custo financeiro.

Implementar anúncios premiados