Integrar o Chartboost à Mediação

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

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

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

Requisitos

• Android API de nível 21 ou mais recente

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

• Concluir a mediação Guia explicativo

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.

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.

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.

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

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

Integração com o Android Studio (recomendado)

No arquivo settings.gradle.kts do projeto, adicione o seguinte repositórios:

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

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

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

Integração manual

1. Baixe o arquivo .aar da versão mais recente do SDK da Chartboost de Maven Central e adicione-o ao seu projeto.

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

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

Consentimento da UE e GDPR

De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.

Na versão 8.1.0 do SDK, o Chartboost adicionou o método addDataUseConsent(). O a seguir, o exemplo de código define o consentimento para o uso de dados como NON_BEHAVIORAL. Se você escolher para chamar esse método, recomendamos que você o faça antes de solicitar 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 os artigo do GDPR e as 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

Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" na página inicial de seu grupo. O Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.

Na versão 8.1.0 do SDK, o Chartboost adicionou o método addDataUseConsent(). O a seguir, o exemplo de código define o consentimento para o uso de dados como OPT_IN_SALE. Se você escolher o método, recomendamos que você o faça antes de solicitar pelo 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 os o artigo sobre a CCPA e as 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 obrigatório

Modificar o AndroidManifest

Outros elementos

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

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 todas eventos do ciclo de vida da atividade que exibirão 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

Ativar anúncios de teste

Registre seu dispositivo de teste em Ad Manager e ative o modo de teste na Chartboost interface.

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, a Chartboost recomenda adicionar as seguintes opções permissões para o arquivo AndroidManifest.xml do seu 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

Estes são os códigos e as mensagens correspondentes gerados pelo adaptador da Chartboost quando ocorre uma falha no carregamento de 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 a versão 9.7.0 do SDK do Chartboost.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 23.0.0.

Criado e testado com:

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

Versão 9.5.0.0

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

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

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

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

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

Versão 9.1.1.0

• O método ChartboostMediationAdapter.setAppParams(String, String) foi adicionado como uma forma opcional de codifique o ID e a assinatura do app a serem usados para inicializar o SDK do Chartboost.
• Compatibilidade verificada com o SDK do Chartboost 9.1.1.
• 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 do 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 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 a API 31.
• 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 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 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 8.3.0.
• 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 do Chartboost versão 8.3.0.

Versão 8.2.1.0

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

• 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.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 8.2.0.
• 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.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.
• Atualização da 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

• Compatibilidade adicionada 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 do Chartboost versão 8.0.3.

Versão 8.0.3.0

• Compatibilidade verificada com o SDK do Chartboost 8.0.3.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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.
• 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.
• Requer 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 Chartboost falha ao invocar eventos de anúncio.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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 7.5.0.
• O adaptador foi migrado para usar dependências do AndroidX.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 18.1.1.

Versão 7.3.1.1

• Adaptador atualizado para oferecer suporte à nova API Premiada em versão Beta aberta.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 17.2.0.

Versão 7.3.1.0

• Compatibilidade verificada com o SDK do Chartboost 7.3.1.

Versão 7.3.0.0

• Compatibilidade verificada com o SDK do Chartboost 7.3.0.

Versão 7.2.1.0

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

Versão 7.1.0.0

• Compatibilidade verificada com o SDK do Chartboost 7.1.0.

Versão 7.0.1.0

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

Versão 7.0.0.0

• O adaptador foi atualizado para ser 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 6.6.1.

Versão 6.6.0.0

• O sistema de nomenclatura de versões foi alterado para [Versão do SDK do 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'
• Movido para distribuir o adaptador como um aar em vez de um arquivo jar. (consulte o LEIAME para mais instruções).

Versão 1.1.0

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