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:

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 Add new app para criar seu 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 User ID e a Assinatura do usuário localizados 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, é possível ativar ou desativar o Modo de teste.

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ê receber anúncios de teste da Chartboost, seu app será colocado na Revisão de app 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 do Chartboost na Ad Manager interface

Adicionar Chartboost à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar o 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.7.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

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, o 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.

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

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, é 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 por meio do SDK dos anúncios para dispositivos móveis do Google.

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

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.

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

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

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

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 não é possível carregar um anúncio:

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

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 do 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 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 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 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google 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 da Chartboost versão 9.1.1.

Versão 8.4.3.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 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 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 da Chartboost versão 8.4.3.

Versão 8.4.2.0

• Compatibilidade verificada com o SDK 8.4.2 da Chartboost.
• 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 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.
• 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 do Chartboost 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 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

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

• Adaptador atualizado para oferecer suporte à nova API Premiada em versão 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

• O adaptador foi atualizado 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.
• Atualização do projeto Adapter 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 do Chartboost 6.6.3.

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

• Remoção do local do anúncio da Chartboost dos extras da 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.