Primeiros passos

Este guia é para editores que desejam gerar receita com um aplicativo C++ com a AdMob, sem usando o Firebase. Se você planeja incluir o Firebase em seu aplicativo (ou se estiver pensando nisso. Consulte a AdMob com Firebase desta guia.

A integração do SDK dos anúncios para dispositivos móveis do Google para C++ a um app é a primeira etapa exibir anúncios e gerar receita. Depois de integrar o SDK, será possível escolha um formato de anúncio, como intersticial ou premiado, e siga as etapas para implementá-los.

O SDK dos anúncios para dispositivos móveis do Google para C++ envolve os SDKs dos anúncios para dispositivos móveis do Google para iOS e Android, e só está disponível nessas plataformas. O SDK dos anúncios para dispositivos móveis do Google para C++ facilita uso de construções em C++ do Firebase para dar suporte a operações assíncronas, portanto, no namespace firebase::gma.

Se esta for a primeira vez que você consulta este guia, recomendamos que faça o download e acompanhe usando o teste C++ dos anúncios para dispositivos móveis do Google app.

Pré-requisitos

Configurar o app na sua conta da AdMob

Registre seu app como um app da AdMob seguindo estas etapas:

1. Faça login ou inscreva-se para uma conta da AdMob.

2. Registre seu app com AdMob. Esta etapa cria uma conta da AdMob com um ID exclusivo do app AdMob que será necessária 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 depois descompacte-o em um diretório de sua escolha.

O SDK do Firebase para C++ não é específico da plataforma, mas exige configurações de biblioteca específicas da plataforma.

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

Configurar o ID do app AdMob do seu app

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

Antes de carregar anúncios, configure o app para inicializar o SDK dos anúncios para dispositivos móveis do Google para C++ da seguinte forma: chame firebase::gma::Initialize(), que inicializa o SDK e conclui uma firebase::Future quando a inicialização for concluída (ou após 30 segundos) tempo limite). 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ê precisa obter o consentimento dos usuários no Espaço Econômico Europeu (EEE), defina sinalizações específicas para solicitações (como tag_for_child_directed_treatment ou tag_for_under_age_of_consent) ou antes de carregar os anúncios, faça isso invocando firebase::gma::SetRequestConfiguration() antes de inicializar o Google Mobile SDK do Google Ads para C++. Para mais informações, consulte nossa 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

Com um Future, você pode determinar o status de conclusão da chamadas de método assíncronas.

Por exemplo, quando seu app chamar firebase::gma::Initialize(), uma nova firebase::Future é criado e retornado. Seu app pode pesquisar status() do Future para determinar quando a inicialização foi concluída. Depois de concluído, o app pode invocar result() para receber o resultado AdapterInitializationStatus.

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

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

Você também pode registrar callbacks a serem invocados quando uma Future for concluída. Em em alguns casos, a chamada de retorno será executada em uma linha de execução diferente, portanto seu código é thread-safe. Esse 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.
  }
}

Selecione 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 uma anúncio. A AdMob oferece vários formatos de anúncio diferentes, e você pode escolher aquele que melhor se adapte à experiência do usuário do seu app.

Banner

Anúncios retangulares que aparecem na parte superior ou inferior da tela do dispositivo. Os anúncios de banner permanecem na tela enquanto os usuários interagem com o aplicativo e podem são atualizadas automaticamente depois de um determinado período. Se você está começando a usar dispositivos móveis publicidade, elas são um ótimo ponto de partida.

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 mais úteis em pausas naturais no fluxo de execução de um app, como entre os níveis 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 jogos anúncios e pesquisas. Usado para gerar receita com apps sem custo financeiro.

Implementar anúncios premiados