Integrar o Chartboost à Mediação

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

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

O Ad Manager adaptador de mediação do Chartboost tem os recursos abaixo:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

• Android API 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 do Chartboost e faça login depois que sua conta for verificada. Acesse a guia Gerenciamento de apps.

Clique no botão Add new app para criar o app.

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

Depois que seu aplicativo for criado, você será direcionado para o painel dele. Anote o ID e a Assinatura do app.

Observação :para acessar o painel do seu app, navegue até a guia Gerenciamento de apps mostrada anteriormente e selecione seu app.

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

Navegue até a guia Recursos > API Explorer e anote o ID do usuário e a Assinatura do usuário localizados na seção Autenticação.

Ativar modo de teste

Para ativar o modo de teste no app, acesse a guia Gerenciamento de apps na interface do Chartboost, selecione o app na lista e clique em Edit app settings.

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

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

Depois que você puder receber anúncios de teste do Chartboost, seu aplicativo será colocado na Publisher App Review do 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 do Chartboost na Ad Manager interface

Definir as configurações de mediação para seu bloco de anúncios

Faça login na sua conta do Ad Manager.

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento.

Insira um Nome exclusivo para o grupo de rendimento, defina o Status como Ativo, selecione o Formato do anúncio e o Tipo de inventário como App para dispositivos móveis. Na seção Segmentação > Inventário, selecione o bloco de anúncios em Inventário e Aplicativo para dispositivos móveis ao qual você quer adicionar a mediação.

Em seguida, clique no botão Adicionar parceiro de rendimento.

Se você já tiver um Parceiro de rendimento para Chartboost, selecione-o. Caso contrário, selecione Criar um novo parceiro de rendimento.

Selecione Chartboost como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.

Ative a Coleta de dados automática e insira o User ID and User Signature recebido na seção anterior.

Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como Plataforma e Ativo como o Status. Insira o App ID, App Signature and Ad Location obtido na seção anterior. Em seguida, insira um valor de CPM padrão.

Os locais de anúncios do Chartboost (locais nomeados) são nomes simples que representam um lugar no seu app onde você quer mostrar um anúncio. OAd Manager envia solicitações para o local especificado nas configurações. Depois que as solicitações são enviadas, o Chartboost adiciona o local à IU para fins de relatório.

Observação:o Ad Manager é capaz de estimar CPMs para os três principais locais de anúncios no seu app Chartboost. Todos os outros locais serão representados com um CPM combinado.

Na interface do Chartboost, os locais dos anúncios podem ser revelados na página Configurações básicas clicando em Configurações avançadas. Consulte o guia Locais nomeados do Chartboost para mais detalhes.

Importante: o App ID precisa estar associado ao app de destino, como na Chartboost interface.

Clique em Salvar na parte inferior da página quando terminar.

Observação :a coleta de dados automática leva alguns dias para coletar dados antes de calcular com precisão um valor de CPM dinâmico para uma rede de mediação. Assim que for possível calcular o eCPM, ele será atualizado automaticamente.

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

Importante :verifique se você tem a permissão de gerenciamento de conta para concluir a configuração de consentimento da UE e GDPR, CPRA e plataforma de mensagens do usuário. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Chartboost à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na Ad Manager IU.

Etapa 3: importar o SDK e o adaptador do Chartboost

Observação :a não integração das versões compatíveis do Chartboost e do SDK dos anúncios para dispositivos móveis do Google pode levar a problemas de compilação.

Integração com o Android Studio (recomendada)

No arquivo settings.gradle.kts no nível 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 seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK e do adaptador do Chartboost:

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

Integração manual

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

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

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

Consentimento da UE e o GDPR

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos deles em relação ao uso de identificadores de dispositivos 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 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.

Na versão 8.1.0 do SDK, o Chartboost adicionou o método addDataUseConsent(). O exemplo de código a seguir define o consentimento de uso de dados como NON_BEHAVIORAL. Se você optar por chamar esse método, é recomendável fazer isso 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 sobre o GDPR do 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

As 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 desses termos) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode 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, o Chartboost adicionou o método addDataUseConsent(). O exemplo de código a seguir define o consentimento de uso de dados como OPT_IN_SALE. Se você optar por chamar esse método, é recomendável fazer isso 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 AndroidManifest

Outros elementos

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

android:configChanges="keyboardHidden|orientation|screenSize"

Eventos de ciclo de vida

De acordo com a recomendação do Chartboost, adicione o código a seguir a todos os eventos de ciclo de vida da sua atividade que exibirão anúncios do 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 em Ad Manager e ative o modo de teste na Chartboost interface.

Importante: desative o modo de teste para Ad Manager e Chartboost antes de lançar o app.

Verificar anúncios de teste

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

Etapas opcionais

Permissões

Para um desempenho ideal, o 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 do Chartboost, é possível verificar o erro subjacente da resposta do anúncio usando ResponseInfo.getAdapterResponse() nas seguintes classes:

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

Veja abaixo os códigos e as mensagens associadas geradas pelo adaptador Chartboost quando o carregamento de um anúncio falha:

Código do erro	Motivo
0-99	O SDK do Chartboost retornou um erro. Consulte a documentação do Chartboost para mais detalhes.
101	O tamanho de anúncio solicitado não corresponde a um tamanho de banner suportado pelo Chartboost.
102	O Chartboost só pode carregar um anúncio por local de cada vez.
103	Os parâmetros do servidor do Chartboost configurados na Ad Manager interface estão ausentes/inválidos.
104	O anúncio premiado ou intersticial do Chartboost não está pronto para exibição.
101	Os parâmetros do servidor do Chartboost configurados na Ad Manager interface estão ausentes/inválidos.
102	O SDK do Chartboost retornou um erro de inicialização.
103	O anúncio Chartboost não é armazenado em cache no momento da exibição.
104	O tamanho de anúncio solicitado não corresponde a um tamanho de banner suportado pelo Chartboost.
105	A versão do SO do dispositivo é anterior à versão mínima compatível do SDK do Chartboost.
200-299	Erros de cache do SDK do Chartboost. Confira o código para mais detalhes.
300-399	O SDK do Chartboost mostra erros. Confira o código para mais detalhes.
400-499	Erros de clique do SDK do Chartboost. Confira o código para mais detalhes.

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

Versão 9.6.1.0

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

Criado e testado com:

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

Versão 9.6.0.0

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

Criado e testado com:

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

Versão 9.5.0.0

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

Criado e testado com:

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

Versão 9.4.1.0

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

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 com o SDK do Chartboost versão 9.4.0 verificada.

Criado e testado com:

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

Versão 9.3.1.0

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

Criado e testado com:

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

Versão 9.3.0.0

• Compatibilidade verificada com o SDK do 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 do Chartboost versão 9.3.0.

Versão 9.2.1.1

• O adaptador foi atualizado para usar a nova classe VersionInfo.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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 do Chartboost versão 9.2.1.

Versão 9.2.0.0

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

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
• SDK do 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 o ID e a assinatura do app usados para inicializar o SDK do Chartboost.
• Compatibilidade verificada com o SDK do Chartboost 9.1.1.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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

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

Criado e testado com:

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

Versão 8.4.3.0

• Compatibilidade verificada com o SDK do Chartboost 8.4.3.

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.3.

Versão 8.4.2.0

• Compatibilidade verificada com o SDK do Chartboost 8.4.2.
• compileSdkVersion e targetSdkVersion foram atualizados para o nível 31 da API
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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.1.

Versão 8.3.1.0

• Compatibilidade verificada com o SDK do Chartboost 8.3.1.
• 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 do Chartboost SDK 8.3.0.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 20.5.0.

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.0.

Versão 8.2.1.0

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

Criado e testado com:

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

Versão 8.2.0.1

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

Criado e testado com:

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

Versão 8.2.0.0

• Compatibilidade verificada com o SDK do Chartboost SDK 8.2.0.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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 do Chartboost SDK 8.1.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 19.2.0.
• SDK do 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 a 19.2.0.

Criado e testado com:

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

Versão 8.0.3.1

• Adicionado suporte a anúncios de banner Chartboost.

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.3.0

• Compatibilidade verificada com o SDK do Chartboost 8.0.3.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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 do Chartboost 8.0.2.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 19.0.1.

Criado e testado com:

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

Versão 8.0.1.0

• Compatibilidade verificada com o SDK do Chartboost 8.0.1.
• Exige o SDK do 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 do Chartboost falha ao invocar eventos de anúncio.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 18.3.0.

Criado e testado com:

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

Versão 7.5.0.0

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

Versão 7.3.1.1

• Adaptador atualizado para oferecer suporte à nova API Premiada em Beta aberto.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 17.2.0.

Versão 7.3.1.0

• Compatibilidade verificada com o SDK do Chartboost SDK 7.3.1.

Versão 7.3.0.0

• Compatibilidade verificada com o SDK do Chartboost SDK 7.3.0.

Versão 7.2.1.0

• Compatibilidade verificada com o SDK do Chartboost SDK 7.2.1.

Versão 7.2.0.1

• O adaptador foi atualizado para invocar o evento de anúncio onRewardedVideoComplete().

Versão 7.2.0.0

• Compatibilidade verificada com o SDK do Chartboost SDK 7.2.0.

Versão 7.1.0.0

• Compatibilidade verificada com o SDK do Chartboost SDK 7.1.0.

Versão 7.0.1.0

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

Versão 7.0.0.0

• O adaptador foi atualizado para torná-lo compatível com o SDK do Chartboost 7.0.0.

Versão 6.6.3.0

• Compatibilidade verificada com o SDK do Chartboost 6.6.3.

Versão 6.6.2.0

• Compatibilidade verificada com o SDK do Chartboost 6.6.2.

Versão 6.6.1.0

• Compatibilidade verificada com o SDK do Chartboost SDK 6.6.1.

Versão 6.6.0.0

• O sistema de nomenclatura de versões foi alterado para [Chartboost SDK version].[adapter patch version].
• Os adaptadores agora 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 distribuição do adaptador como aar, em vez de arquivo jar. Consulte o README para mais instruções.

Versão 1.1.0

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

Versão 1.0.0

• Versão inicial. Compatível com anúncios intersticiais e em vídeo com base em recompensas.