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 da AdMob, 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: configurar as configurações na interface da 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.
Clique no botão Adicionar novo app para criar o app.
Preencha o restante do formulário e clique no botão Add App para finalizar o app.
Depois que o app for criado, você vai ser direcionado ao painel dele. Anote o ID do app e a assinatura 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.
Navegue até a guia Resources > API Explorer e anote o ID do usuário e a assinatura do usuário na seção Authentication.
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.
Nas configurações do app, você pode ativar o Modo de teste.
Depois que o modo de teste for ativado, você poderá 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 no Chartboost funcione, a análise do app do editor precisa ser aprovada pelo Chartboost.
Etapa 2: configurar a demanda da Chartboost na interface AdMob
Configurar as configurações de mediação para o bloco de anúncios
Adicione Chartboost à configuração de mediação do bloco de anúncios.
Primeiro, faça login na sua conta da AdMob. Em seguida, navegue até a guia Mediation. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome dele para editá-lo e pule para Adicionar Chartboost como uma origem de anúncios.
Para criar um novo grupo de mediação, selecione Criar grupo de mediação.
Insira o formato e a plataforma do anúncio e clique em Continuar.
Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.
Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios AdMob . Em seguida, clique em Concluído.
O card "Blocos de anúncios" vai ser preenchido com os blocos que você selecionou:
Adicionar Chartboost como uma origem de anúncios
No card Hierarquia, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Chartboost.
Selecione Chartboost e ative a chave Optimize. Insira o ID do usuário e a assinatura do usuário obtidos na seção anterior para configurar a otimização da origem de anúncios para a Chartboost. Em seguida, insira um valor de eCPM para a Chartboost e clique em Continuar.
Se você já tiver um mapeamento para a Chartboost, selecione-o. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira o ID do app, a assinatura do app e a localização do anúncio que você recebeu na seção anterior. Em seguida, clique em Concluído.
Os locais de anúncios da Chartboost (Locais nomeados) são nomes simples que representam um lugar no seu app em que você quer mostrar um anúncio. A AdMob envia solicitações para o local especificado nas configurações. Depois que as solicitações são enviadas, a Chartboost adiciona o local à plataforma para fins de geração de relatórios. Os usuários também podem criar novos locais de anúncios diretamente na plataforma da Chartboost antes de fazer a chamada nos jogos.
Na interface da Chartboost, é possível revelar seus locais de anúncio na página Configurações básicas clicando em Configurações avançadas. Consulte o guia [Locais nomeados](https://docs.chartboost.com/en/monetization/publishing/ad-locations/) do Chartboost para mais detalhes.
Por fim, clique em Concluído para adicionar a Chartboost como uma origem de anúncios e, depois, em Salvar.
Adicionar Chartboost à lista de parceiros de publicidade do GDPR e dos regulamentos 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 da Chartboost
Integração com o Android Studio (recomendada)
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
Faça o download do arquivo
.aar
da versão mais recente do SDK da Chartboost no Maven Central e adicione-o ao projeto.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
Consentimento da UE e GDPR
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 buscar consentimento, você precisa identificar cada rede de publicidade na cadeia de mediação que pode coletar, receber ou usar dados pessoais e 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ê escolher
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 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 definição legal desses termos). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" mostrado em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na cadeia de mediação que possa 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 da CCPA da 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 abaixo a todos os eventos do ciclo de vida da atividade que vão mostrar 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 da Chartboost.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da Chartboost, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Chartboost (Waterfall).
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, verifique 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
Confira os códigos e as mensagens associadas gerados pelo adaptador da Chartboost quando um anúncio não é carregado:
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ó pode carregar um anúncio por local por vez. |
103 | Os parâmetros do servidor da Chartboost configurados na interface AdMob 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 da Chartboost versão 9.8.0.
Versão 9.7.0.0
- Compatibilidade verificada com o SDK 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 o SDK da Chartboost versão 9.6.0.
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 da 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 o SDK da Chartboost versão 9.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK da 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 da Chartboost versão 9.2.1.
Versão 9.2.1.0
- Compatibilidade verificada com o SDK 9.2.1 do Chartboost.
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.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 9.1.1 do Chartboost.
- 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 da 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 8.4.2 da Chartboost.
compileSdkVersion
etargetSdkVersion
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 da Chartboost versão 8.4.2.
Versão 8.4.1.0
- Compatibilidade verificada com o SDK Chartboost 8.4.1.
- 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 da Chartboost versão 8.4.1.
Versão 8.3.1.0
- Compatibilidade verificada com o SDK 8.3.1 do Chartboost.
- Atualizamos o adaptador 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 da Chartboost versão 8.3.1.
Versão 8.3.0.0
- Compatibilidade verificada com o SDK 8.3.0 do Chartboost.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 da 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 8.0.3 do Chartboost.
- 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 da Chartboost versão 8.0.3.
Versão 8.0.2.0
- Compatibilidade verificada com o SDK 8.0.2 do Chartboost.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 da Chartboost versão 8.0.1.
Versão 7.5.0.1
- Correção de um bug em que o adaptador Chartboost não conseguia invocar eventos de anúncios.
- 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 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 da 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
- A localização do anúncio do Chartboost foi removida 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.