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 a mediação, abordando integrações em cascata. 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 app Unity.

Integrações e formatos de anúncio aceitos

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 4 ou versões mais recentes
  • Para fazer a implantação no Android,
    • API do Android de nível 23 ou mais recente
  • Para fazer a implantação no iOS:
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Conclua o guia de primeiros passos da mediação.

Etapa 1: definir 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.

Painel de apps da Chartboost

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

Gerenciamento de apps

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

Formulário de novo app

Depois que o app for criado, você será direcionado ao painel dele. Anote o ID do app e a assinatura do app.

Android

Configurações do app

iOS

Configurações do app

A AdMob exige o ID do usuário e a assinatura do usuário da 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 da Chartboost

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

API Explorer da Chartboost

Atualizar o app-ads.txt

O app-ads.txt de vendedores autorizados para apps é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.

Para implementar o app-ads.txt na Chartboost, consulte app-ads.txt.

Ativar o modo de teste

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

Android

Editar configurações do app

iOS

Editar configurações do app

Nas configurações do app, ative o Modo de teste.

Modo de teste da Chartboost

Depois que o modo de teste é ativado, você pode 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 Análise de apps de editores da Chartboost. Para que a monetização na Chartboost funcione, a análise do app do publisher precisa ser aprovada pela Chartboost.

Etapa 2: configurar a demanda da Chartboost na interface da AdMob

Configurar as configurações de mediação do bloco de anúncios

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

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

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

Etapa 3: importar o SDK e o adaptador da Chartboost

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, execute o seguinte comando no diretório raiz do projeto para instalar o plug-in de mediação do Chartboost dos anúncios para dispositivos móveis do Google no Unity:

openupm add com.google.ads.mobile.mediation.chartboost

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.

Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Mediação do Chartboost com os anúncios para dispositivos móveis do Google e clique em Instalar.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para Chartboost usando o link de download no Registro de alterações e extraia o GoogleMobileAdsChartboostMediation.unitypackage do arquivo ZIP.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsChartboostMediation.unitypackage que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

Importar do Unity

Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

Forçar resolução

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

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 feitas e que os consentimentos sejam obtidos dos usuários no Espaço Econômico Europeu (EEE) em relação ao 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 sua cadeia de mediação que possa coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não consegue transmitir automaticamente a opção de consentimento do usuário para essas redes.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para Chartboost versão 3.1.0 inclui o método Chartboost.AddDataUseConsent(). O exemplo de código a seguir define o consentimento de uso de dados como NonBehavioral. Se você optar por chamar esse método, recomendamos que faça isso antes de solicitar anúncios usando o SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

Leis estaduais de privacidade dos EUA

As leis de privacidade dos estados 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 em destaque com a mensagem "Não vender minhas informações pessoais" na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a opção de ativar o tratamento 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 anúncios na sua cadeia de mediação. Portanto, identifique cada rede de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para Chartboost versão 3.1.0 inclui o método Chartboost.AddDataUseConsent(). O exemplo de código a seguir define o consentimento de uso de dados como OptInSale. Se você optar por chamar esse método, recomendamos que faça isso antes de solicitar anúncios usando o SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

Etapa 5: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração da Chartboost.

iOS

Integração da SKAdNetwork

Siga a documentação da Chartboost para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Etapa 6: testar a implementação

Ativar anúncios de teste

Não se esqueça de registrar seu dispositivo de teste na AdMob e ativar 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 (hierarquia).

Etapas opcionais

Android

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

iOS

Nenhuma outra etapa é necessária para a integração com o iOS.

Códigos de erro

Se o adaptador não receber um anúncio da Chartboost, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

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

iOS

GADMAdapterChartboost
GADMediationAdapterChartboost

Confira os códigos e as mensagens correspondentes gerados pelo adaptador da Chartboost quando um anúncio não é carregado:

Android

Código do erro Motivo
0-99 O SDK da Chartboost retornou um erro.
101 O tamanho de 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 da AdMob estão ausentes ou são inválidos.
104 O anúncio intersticial ou premiado da Chartboost não está pronto para ser exibido.

iOS

Código do erro Motivo
101 Os parâmetros do servidor da Chartboost configurados na interface da AdMob estão ausentes ou são inválidos.
102 O SDK da Chartboost retornou um erro de inicialização.
103 O anúncio da 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 compatível com a Chartboost.
105 A versão do SO do dispositivo é inferior à versão mínima compatível do SO do SDK da Chartboost.
200-299 Erros de cache do SDK da Chartboost. Consulte o código para mais detalhes.
300-399 O SDK da Chartboost mostra erros. Consulte o código para mais detalhes.
400-499 Erros de clique do SDK da Chartboost. Consulte o código para mais detalhes.

Registro de mudanças do plug-in de mediação do Unity da Chartboost

Versão 4.8.0

Versão 4.7.3

Versão 4.7.2

Versão 4.7.1

Versão 4.7.0

Versão 4.6.1

Versão 4.6.0

Versão 4.5.0

Versão 4.4.0

Versão 4.3.0

Versão 4.2.0

Versão 4.1.1

Versão 4.1.0

Versão 4.0.0

Versão 3.5.1

Versão 3.5.0

Versão 3.4.1

Versão 3.4.0

Versão 3.3.1

Versão 3.3.0

Versão 3.2.0

Versão 3.1.0

Versão 3.0.1

Versão 3.0.0

Versão 2.0.1

Versão 2.0.0

  • Compatível com a versão 7.5.0.0 do adaptador do Android da Chartboost.
  • Compatibilidade com a versão 8.0.1.1 do adaptador do iOS da Chartboost.

Versão 1.3.0

  • O plug-in foi atualizado para oferecer suporte à nova API Rewarded.
  • Compatível com a versão 7.3.1.1 do adaptador do Android da Chartboost.
  • Compatível com a versão 7.5.0.0 do adaptador do iOS da Chartboost.

Versão 1.2.0

  • Compatibilidade com a versão 7.3.0.0 do adaptador do Android da Chartboost.
  • Compatível com a versão 7.3.0.0 do adaptador do iOS da Chartboost.

Versão 1.1.1

  • Compatível com a versão 7.2.0.1 do adaptador do Android da Chartboost.
  • Compatibilidade com a versão 7.2.0.1 do adaptador do iOS da Chartboost.

Versão 1.1.0

  • Compatível com a versão 7.2.0 do SDK do Android da Chartboost.
  • Compatível com a versão 7.2.0 do SDK do iOS da Chartboost.
  • Adição do método Chartboost.RestrictDataCollection() para ativar as restrições de coleta de dados do GDPR no SDK da Chartboost.

Versão 1.0.0

  • Primeira versão!
  • Compatível com a versão 7.0.1 do SDK do Android da Chartboost.
  • Compatível com a versão 7.1.2 do SDK do iOS da Chartboost.