Integrar o Chartboost à mediação

Selecionar plataforma: Android Novo Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da Chartboost usando mediação, incluindo integrações em hierarquia. Ele explica 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 Flutter.

Integrações e formatos de anúncio aceitos

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado

Requisitos

  • Mais recente Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 ou mais recente
  • Para implantação no Android
    • API Android nível da API 23 ou mais recente
  • Para implantação no iOS
    • Destino de implantação do iOS 13.0 ou mais recente
  • Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configurar a Mediação da AdMob

Etapa 1: definir 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, navegue até a guia Apps management (Gerenciamento de apps).

Painel de apps da Chartboost

Clique no botão Add new app (Adicionar novo app) para criar seu app.

Gerenciamento de apps

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

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 Chartboost mediation (Mediação da Chartboost) na interface da Chartboost.

Painel de mediação da Chartboost

Navegue até a guia Resources > API Explorer (Recursos > Explorador de APIs) e anote o ID do usuário e a assinatura do usuário localizados na seção Authentication (Autenticação).

API Explorer da Chartboost

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é 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 dos anúncios, implemente um arquivo app-ads.txt. Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.

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

Ativar o modo de teste

Para ativar o modo de teste no app, navegue até a guia Apps management (Gerenciamento de apps) na interface da Chartboost, selecione o app na lista e clique em Edit app settings (Editar configurações do app).

Android

Editar configurações do app

iOS

Editar configurações do app

Nas configurações do app, você pode ativar o modo de teste.

Modo de teste da Chartboost

Depois que o modo de teste estiver 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 de receber anúncios de teste da Chartboost, seu app será colocado na análise de apps de publishers 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

Definir 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

Integração pelo pub.dev

Adicione a dependência abaixo com as versões mais recentes do SDK e do adaptador da Chartboost no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_chartboost: ^1.4.2

Integração manual

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, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a dependência abaixo:

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

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

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a personalização de anúncios Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação. O Google não consegue transmitir automaticamente a escolha 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 abaixo define o consentimento de uso de dados como NonBehavioral. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios usando Google Mobile Ads Flutter Plugin.

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 desses termos na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade 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 publicidade 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 dessas redes 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 abaixo define o consentimento de uso de dados como OptInSale. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios usando Google Mobile Ads Flutter Plugin.

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

Etapa 5: adicionar o código necessário

Android

Nenhum código extra é 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 seu projeto.

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 (hierarquia).

Etapas opcionais

Android

Permissões

Para um desempenho ideal, a Chartboost recomenda adicionar as seguintes permissões opcionais ao arquivo AndroidManifest.xml do seu app:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

iOS

Nenhuma etapa extra é necessária para a integração do iOS.

Códigos de erro

Se o adaptador não receber um anúncio da Chartboost, os publishers poderão verificar o erro 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 geradas 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 de cada 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 mostrado.

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 está 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 do SO compatível com o SDK da Chartboost.
200-299 Erros de cache do SDK da Chartboost. Consulte o código para mais detalhes.
300-399 Erros de exibição do SDK da Chartboost. 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 alterações do adaptador de mediação da Chartboost para o Flutter

Versão 1.5.0 (em andamento)

Versão 1.4.2

  • Versão mínima do Flutter atualizada para 3.38.1.
  • Atualizado para oferecer suporte à versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
  • Oferece suporte à versão 9.11.1.1 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.11.0.3 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.4.1

  • Oferece suporte à versão 9.11.1.0 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.11.0.3 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.4.0

  • Versão mínima do Flutter atualizada para 3.35.1
  • Atualizado para oferecer suporte à versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter
  • Oferece suporte à versão 9.11.0.1 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.11.0.1 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.3.3

Versão 1.3.2

Versão 1.3.1

  • Oferece suporte à versão 9.10.0.1 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.10.0.0 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.3.0

  • Oferece suporte à versão 9.10.0.0 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.10.0.0 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.2.1

  • Oferece suporte à versão 9.9.2.0 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.9.2.0 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.2.0

  • Oferece suporte à versão 9.9.0.0 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.9.1.0 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.0

  • Oferece suporte à versão 9.8.3.1 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.9.0.0 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.2

  • Oferece suporte à versão 9.8.3.1 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.8.1.0 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.1

  • Oferece suporte à versão 9.8.3.0 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.8.1.0 do adaptador iOS da Chartboost.
  • Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.0

  • Versão inicial.
  • Oferece suporte à versão 9.8.1.0 do adaptador Android da Chartboost.
  • Oferece suporte à versão 9.8.0.0 do adaptador iOS da Chartboost .
  • Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.