Integrar o Chartboost à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Chartboost usando mediação, cobrindo integrações de hierarquia. Ele aborda como adicionar a Chartboost à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Chartboost a um Android app.

Integrações e formatos de anúncio compatíveis

O adaptador de mediação para Chartboost tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

  • API do Android de nível 21 ou mais recente

  • SDK dos anúncios para dispositivos móveis do Google mais recente

  • Concluir o Guia explicativo de mediação

Etapa 1: definir as configurações na interface do Chartboost

Inscreva-se em uma conta da Chartboost e faça login depois que ela for verificada. Em seguida, acesse a guia Gerenciamento de apps.

Painel de apps do Chartboost

Clique no botão Adicionar novo app para criar o app.

Gerenciamento de apps

Preencha o restante do formulário e clique no botão Add App para finalizar o app.

Novo formulário de app

Depois que o app for criado, o painel será aberto. Anote o ID e a assinatura do app.

Configurações do app

A AdMob exige o ID do usuário e a assinatura do usuário do Chartboost para configurar o ID do bloco de anúncios da AdMob. Para encontrar esses parâmetros, clique em Mediação da Chartboost na interface da Chartboost.

Painel de mediação do Chartboost

Navegue até a guia Resources > API Explorer e anote o ID do usuário e a assinatura do usuário na seção Authentication.

Chartboost api explorer

Ativar o modo de teste

Para ativar o modo de teste no app, acesse a guia Gerenciamento de apps na interface do Chartboost, selecione seu app na lista e clique em Editar configurações do app.

Editar configurações do app

Nas configurações do app, é possível ativar ou desativar o Modo de teste.

Modo de teste do Chartboost

Com o modo de teste ativado, é possível solicitar anúncios usando o ID do bloco de anúncios criado anteriormente e receber um anúncio de teste da Chartboost.

Depois que você puder receber anúncios de teste da Chartboost, seu app será colocado na Revisão de apps do editor da Chartboost. Para que a monetização na Chartboost funcione, a revisão do app do editor precisa ser aprovada pela empresa.

Etapa 2: configurar a demanda da Chartboost na interface Ad Manager

Adicionar Chartboost ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA

Siga as etapas em Configurações do GDPR e Regulamentações estaduais dos EUA para adicionar a Chartboost à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador do Chartboost

No arquivo settings.gradle.kts do projeto, adicione os seguintes repositórios:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

Em seguida, no arquivo build.gradle.kts do app, adicione as dependências e configurações de implementação abaixo. Use as versões mais recentes do SDK e do adaptador da Chartboost:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:chartboost:9.8.0.0")
}

Integração manual

  1. Faça o download do arquivo .aar da versão mais recente do SDK da Chartboost no Maven Central e adicione-o ao seu projeto.

  2. Navegue até os artefatos do adaptador da Chartboost no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador Chartboost e adicione-o ao projeto.

Etapa 4: implementar as configurações de privacidade no SDK da Chartboost

De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que algumas informações sejam fornecidas e que o consentimento seja obtido dos usuários no Espaço Econômico Europeu (EEE) sobre o uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao solicitar o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a escolha de consentimento do usuário para essas redes automaticamente.

Na versão 8.1.0 do SDK, a Chartboost adicionou o método addDataUseConsent(). O exemplo de código abaixo define o consentimento de uso de dados como NON_BEHAVIORAL. Se você optar por chamar esse método, recomendamos que o faça antes de solicitar anúncios por meio do SDK dos anúncios para dispositivos móveis do Google.

Java

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

Consulte o artigo do GDPR da Chartboost e os métodos de privacidade do Android para mais detalhes e os valores que podem ser fornecidos em cada método.

Leis Estaduais de Privacidade dos EUA

Leis estaduais de privacidade dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a lei define esses termos), com a opção de recusa oferecida por um link "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.

Na versão 8.1.0 do SDK, a Chartboost adicionou o método addDataUseConsent(). O exemplo de código abaixo define o consentimento de uso de dados como OPT_IN_SALE. Se você optar por chamar esse método, recomendamos que o faça antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

Java

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

Consulte o artigo sobre a CCPA do Chartboost e os Métodos de privacidade do Android para mais detalhes e os valores que podem ser fornecidos em cada método.

Etapa 5: adicionar o código necessário

Modificar o AndroidManifest

Outros elementos

Adicione o seguinte atributo a cada atividade no arquivo AndroidManifest.xml que vai mostrar anúncios da Chartboost e oferece suporte a diferentes orientações:

android:configChanges="keyboardHidden|orientation|screenSize"

Eventos de ciclo de vida

De acordo com a recomendação da Chartboost, adicione o código a seguir a todos os eventos de ciclo de vida da atividade que exibirão anúncios da Chartboost.

Java

import com.chartboost.sdk.Chartboost;
// ...

@Override
public void onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed()) {
        return;
    } else {
        super.onBackPressed();
    }
}

Kotlin

import com.chartboost.sdk.Chartboost
// ...

@Override
fun onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed())
        return
    else
        super.onBackPressed()
}

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob e ative o modo de teste na interface do Chartboost.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do Chartboost, ative o teste de origem de anúncios única no Ad Inspector usando as origens de anúncios Chartboost (cascata).

Etapas opcionais

Permissões

Para um desempenho ideal, a Chartboost recomenda adicionar as seguintes permissões opcionais ao arquivo AndroidManifest.xml do app:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Códigos de erro

Se o adaptador não receber um anúncio da Chartboost, você poderá verificar o erro subjacente da resposta do anúncio usando ResponseInfo.getAdapterResponses() nas seguintes classes:

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

Veja a seguir os códigos e as mensagens associadas geradas pelo adaptador da Chartboost quando há falha no carregamento de um anúncio:

Código do erro Motivo
0-99 O SDK da Chartboost retornou um erro. Consulte a documentação da Chartboost para mais detalhes.
101 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Chartboost.
102 A Chartboost só consegue carregar um anúncio por local por vez.
103 Os parâmetros do servidor da Chartboost configurados na interface Ad Manager estão ausentes ou inválidos.
104 O anúncio intersticial ou premiado da Chartboost não está pronto para ser mostrado.

Registro de alterações do adaptador de mediação do Chartboost para Android

Versão 9.8.0.0

  • Compatibilidade verificada com o SDK Chartboost versão 9.8.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.4.0.
  • SDK do Chartboost versão 9.8.0.

Versão 9.7.0.0

  • Compatibilidade verificada com o SDK da Chartboost versão 9.7.0.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 23.0.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
  • SDK da Chartboost versão 9.7.0.

Versão 9.6.1.0

  • Compatibilidade verificada com a versão 9.6.1 do SDK da Chartboost.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
  • SDK da Chartboost versão 9.6.1.

Versão 9.6.0.0

  • Compatibilidade verificada com a versão 9.6.0 do SDK do Chartboost.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.5.0.
  • SDK da Chartboost versão 9.6.0.

Versão 9.5.0.0

  • Compatibilidade verificada com o SDK da Chartboost versão 9.5.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
  • SDK da Chartboost versão 9.5.0.

Versão 9.4.1.0

  • Compatibilidade verificada com o SDK Chartboost versão 9.4.1.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.2.0.
  • SDK do Chartboost versão 9.4.1.

Versão 9.4.0.0

  • Compatibilidade verificada com o SDK Chartboost versão 9.4.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.1.0.
  • SDK da Chartboost versão 9.4.0.

Versão 9.3.1.0

  • Compatibilidade verificada com a versão 9.3.1 do SDK da Chartboost.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.1.0.
  • SDK da Chartboost versão 9.3.1.

Versão 9.3.0.0

  • Compatibilidade verificada com a versão 9.3.0 do SDK do Chartboost.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
  • SDK do Chartboost versão 9.3.0.

Versão 9.2.1.1

  • O adaptador foi atualizado para usar a nova classe VersionInfo.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 22.0.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
  • SDK do Chartboost versão 9.2.1.

Versão 9.2.1.0

  • Compatibilidade verificada com o SDK do Chartboost 9.2.1.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK da Chartboost versão 9.2.1.

Versão 9.2.0.0

  • Compatibilidade verificada com o SDK 9.2.0 do Chartboost.
  • Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.5.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK da Chartboost versão 9.2.0.

Versão 9.1.1.0

  • O método ChartboostMediationAdapter.setAppParams(String, String) foi adicionado como uma maneira opcional de codificar em disco qual ID e assinatura do app usar para inicializar o SDK da Chartboost.
  • Compatibilidade verificada com o SDK do Chartboost 9.1.1.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.3.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.3.0.
  • SDK do Chartboost versão 9.1.1.

Versão 8.4.3.1

  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.0.0.
  • O nível mínimo de API do Android necessário foi atualizado para 19.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
  • SDK da Chartboost versão 8.4.3.

Versão 8.4.3.0

  • Compatibilidade verificada com o SDK 8.4.3 da Chartboost.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
  • SDK da Chartboost versão 8.4.3.

Versão 8.4.2.0

  • Compatibilidade verificada com o SDK do Chartboost 8.4.2.
  • compileSdkVersion e targetSdkVersion foram atualizados para a API 31.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.6.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
  • SDK do Chartboost versão 8.4.2.

Versão 8.4.1.0

  • Compatibilidade verificada com o SDK do Chartboost 8.4.1.
  • Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.6.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
  • SDK da Chartboost versão 8.4.1.

Versão 8.3.1.0

  • Compatibilidade verificada com o SDK 8.3.1 do Chartboost.
  • O adaptador foi atualizado para usar a nova API AdError.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
  • SDK do Chartboost versão 8.3.1.

Versão 8.3.0.0

  • Compatibilidade verificada com o SDK 8.3.0 do Chartboost.
  • Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.5.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
  • SDK da Chartboost versão 8.3.0.

Versão 8.2.1.0

  • Compatibilidade verificada com o SDK 8.2.1 da Chartboost.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.1.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.1.0.
  • SDK da Chartboost versão 8.2.1.

Versão 8.2.0.1

  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.0.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
  • SDK da Chartboost versão 8.2.0.

Versão 8.2.0.0

  • Compatibilidade verificada com o SDK 8.2.0 do Chartboost.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.5.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
  • SDK do Chartboost versão 8.2.0.

Versão 8.1.0.0

  • Compatibilidade verificada com o SDK 8.1.0 do Chartboost.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 19.2.0.
  • SDK da Chartboost versão 8.1.0.

Versão 8.0.3.2

  • Foram adicionados códigos de erro descritivos e motivos para falhas de carregamento/exibição do adaptador.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.2.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 19.2.0.
  • SDK da Chartboost versão 8.0.3.

Versão 8.0.3.1

  • Adição de suporte para anúncios de banner da Chartboost.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
  • SDK da Chartboost versão 8.0.3.

Versão 8.0.3.0

  • Compatibilidade verificada com o SDK do Chartboost 8.0.3.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.1.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
  • SDK do Chartboost versão 8.0.3.

Versão 8.0.2.0

  • Compatibilidade verificada com o SDK 8.0.2 do Chartboost.
  • Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.0.1.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
  • SDK da Chartboost versão 8.0.2.

Versão 8.0.1.0

  • Compatibilidade verificada com o SDK 8.0.1 do Chartboost.
  • Exige o SDK Chartboost 8.0.1 ou mais recente.
  • O contexto da atividade não é mais necessário para carregar anúncios.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
  • SDK do Chartboost versão 8.0.1.

Versão 7.5.0.1

  • Correção de um bug em que o adaptador Chartboost falha ao invocar eventos de anúncio.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.3.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
  • SDK da Chartboost versão 7.5.0.

Versão 7.5.0.0

  • Compatibilidade verificada com o SDK do Chartboost 7.5.0.
  • O adaptador foi migrado para usar dependências do AndroidX.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.1.1.

Versão 7.3.1.1

  • O adaptador foi atualizado para oferecer suporte à nova API Rewarded Beta aberta.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 17.2.0.

Versão 7.3.1.0

  • Compatibilidade verificada com o SDK 7.3.1 do Chartboost.

Versão 7.3.0.0

  • Compatibilidade verificada com o SDK 7.3.0 do Chartboost.

Versão 7.2.1.0

  • Compatibilidade verificada com o SDK 7.2.1 do Chartboost.

Versão 7.2.0.1

  • Atualizamos o adaptador para invocar o evento de anúncio onRewardedVideoComplete().

Versão 7.2.0.0

  • Compatibilidade verificada com o SDK 7.2.0 do Chartboost.

Versão 7.1.0.0

  • Compatibilidade verificada com o SDK 7.1.0 do Chartboost.

Versão 7.0.1.0

  • Compatibilidade verificada com o SDK 7.0.1 da Chartboost.
  • Adição de suporte a novos códigos de erro da Chartboost.
  • Atualizamos o projeto do adaptador para o Android Studio 3.0.

Versão 7.0.0.0

  • Atualizamos o adaptador para que ele seja compatível com o SDK 7.0.0 do Chartboost.

Versão 6.6.3.0

  • Compatibilidade verificada com o SDK 6.6.3 do Chartboost.

Versão 6.6.2.0

  • Compatibilidade verificada com o SDK 6.6.2 da Chartboost.

Versão 6.6.1.0

  • Compatibilidade verificada com o SDK 6.6.1 do Chartboost.

Versão 6.6.0.0

  • O sistema de nomenclatura de versões foi alterado para [versão do SDK Chartboost].[versão do patch do adaptador].
  • Agora, os adaptadores podem ser adicionados como uma dependência de compilação adicionando o seguinte à tag de dependências do arquivo build.gradle: compile 'com.google.ads.mediation:chartboost:6.6.0.0'
  • Mudança para distribuir o adaptador como um aar em vez de um arquivo jar (consulte o README para mais instruções).

Versão 1.1.0

  • O local do anúncio do Chartboost foi removido dos extras do Chartboost. A localização do anúncio agora é especificada no console da AdMob ao configurar a Chartboost para mediação.

Versão 1.0.0

  • Versão inicial. Suporte a anúncios em vídeo e intersticiais com recompensa.