Integrar o Chartboost à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar 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 app do Flutter.

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

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

Requisitos

• SDK dos anúncios para dispositivos móveis do Google mais recente
• Flutter 3.7.0 ou mais recente
• Para implantar no Android
  • Nível 21 da API do Android ou mais recente
• Para implantar no iOS
  • Destino de implantação do iOS 12.0 ou mais recente
• Um projeto do Flutter configurado com o SDK dos anúncios para dispositivos móveis do Google. Confira mais detalhes em Começar.
• Conclua o Guia para iniciantes da 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 o 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 ID do usuário e a assinatura do usuário 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, você pode ativar o Modo de teste.

Quando 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 que você puder receber anúncios de teste da Chartboost, seu app será colocado na Revisão de apps do editor da Chartboost. Para que a monetização na Chartboost funcione, a análise do app do editor precisa ser aprovada pela Chartboost.

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

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

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

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

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 seguinte dependência:

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

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.

O plug-in de mediação de 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 que o faça 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

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 na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" mostrado em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na sua 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.

O plug-in de mediação de 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 que o faça 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

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

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

Códigos de erro

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

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

GADMAdapterChartboost
GADMediationAdapterChartboost

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

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

1.0.0

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