Integrar o Chartboost à mediação

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar o Google Mobile Ads Unity Plugin para carregar e exibir anúncios da Chartboost com a 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 Unity.

Integrações e formatos de anúncio aceitos

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

Integração
Lances
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • Unity Editor versão 2019.4 ou mais recente.
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 13.0 ou mais recente.
  • Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar o Google Mobile Ads Unity Plugin para mais detalhes.
  • Configure a mediação.

    • Etapa 1: definir as configurações na interface da Chartboost

    Crie 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 app.

    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

    O Ad Manager exige o ID do usuário e a assinatura do usuário da Chartboost para configurar o ID do bloco de anúncios do Ad Manager. 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 a assinatura do usuário, que estão na seção 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 de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

    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 Apps management na interface da Chartboost, selecione o app na lista e clique em Edit app settings.

    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 for 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ê conseguir receber anúncios de teste da Chartboost, seu app será colocado na análise de apps do publisher 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 do Ad Manager

    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 do Ad Manager.

    Etapa 3: importar o SDK e o adaptador da Chartboost

    OpenUPM-CLI

    Se a OpenUPM-CLI estiver instalada, você poderá instalar o plug-in de mediação da Chartboost dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

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

    OpenUPM

    No editor do projeto do Unity, selecione Edit > Configurações do Projeto > Package Manager para abrir as configurações do gerenciador de pacotes do Unity.

    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 Google Mobile Ads Chartboost e clique em Instalar.

    Instalar pelo OpenUPM

    Pacote do Unity

    Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para Chartboost no link de download do Registro de mudanças 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ê salvou. 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 > Forçar resolução. A biblioteca do Gerenciador de Dependências Externas 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

    Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para 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.

    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 que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

    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 fazer isso antes de solicitar anúncios usando Google Mobile Ads Unity Plugin.

    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 seu projeto.

    Etapa 6: testar a implementação

    Ativar anúncios de teste

    Não se esqueça de registrar seu dispositivo de teste no Ad Manager 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 etapa adicional é 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 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 de cada vez.
    103 Os parâmetros do servidor da Chartboost configurados na interface do Ad Manager 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 do Ad Manager 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 aceito pela Chartboost.
    105 A versão do SO do dispositivo é anterior à 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 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 alterações do plug-in de mediação da Chartboost para Unity

    Versão 4.15.1

    Versão 4.15.0

    Versão 4.14.0

    Versão 4.13.0

    Versão 4.12.1

    Versão 4.12.0

    Versão 4.11.3

    Versão 4.11.2

    Versão 4.11.1

    Versão 4.11.0

    Versão 4.10.3

    Versão 4.10.2

    Versão 4.10.1

    Versão 4.10.0

    Versão 4.9.3

    Versão 4.9.2

    Versão 4.9.1

    Versão 4.9.0

    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

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

    Versão 1.3.0

    • Atualizamos o plug-in 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

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

    Versão 1.1.1

    • Compatível com a versão 7.2.0.1 do adaptador da Chartboost para Android.
    • Compatível 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 Chartboost para Android.
    • Compatível com a versão 7.2.0 do SDK da Chartboost para iOS.
    • Adição do método Chartboost.RestrictDataCollection() para ativar as restrições de coleta de dados do GDPR para o 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 Chartboost para iOS.