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 Mediação da AdMob, 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 iOS app.

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

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

• Destino de implantação do iOS 12.0 ou mais recente

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

• Concluir o Guia explicativo de 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 Adicionar novo 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.

Observação: para acessar o painel do app, selecione a guia Gerenciamento de apps mostrada anteriormente.

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.

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ê 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 no Chartboost funcione, a análise do app do editor precisa ser aprovada pelo Chartboost.

Etapa 2: configurar a demanda da Chartboost na interface AdMob

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

Adicione Chartboost à configuração de mediação do bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, navegue até a guia Mediation. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome dele para editá-lo e pule para Adicionar Chartboost como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio e clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios AdMob . Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai ser preenchido com os blocos que você selecionou:

Adicionar Chartboost como uma origem de anúncios

No card Hierarquia, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Chartboost.

Selecione Chartboost e ative a chave Optimize. Insira o ID do usuário e a assinatura do usuário obtidos na seção anterior para configurar a otimização da origem de anúncios para a Chartboost. Em seguida, insira um valor de eCPM para a Chartboost e clique em Continuar.

Observação: só é necessário configurar a otimização da origem de anúncios uma vez por rede.

Se você já tiver um mapeamento para a Chartboost, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o ID do app, a assinatura do app e a localização do anúncio que você recebeu na seção anterior. Em seguida, clique em Concluído.

Os locais de anúncios da Chartboost (Locais nomeados) são nomes simples que representam um lugar no seu app em que você quer mostrar um anúncio. A AdMob envia solicitações para o local especificado nas configurações. Depois que as solicitações são enviadas, a Chartboost adiciona o local à plataforma para fins de geração de relatórios. Os usuários também podem criar novos locais de anúncios diretamente na plataforma da Chartboost antes de fazer a chamada nos jogos.

Observação: a AdMob pode estimar os CPMs dos três principais locais de anúncios no app Chartboost. Todos os outros locais são representados com um CPM combinado.

Na interface da Chartboost, é possível revelar seus locais de anúncio na página Configurações básicas clicando em Configurações avançadas. Consulte o guia [Locais nomeados](https://docs.chartboost.com/en/monetization/publishing/ad-locations/) do Chartboost para mais detalhes.
Por fim, clique em Concluído para adicionar a Chartboost como uma origem de anúncios e, depois, em Salvar.

Observação: a otimização da origem de anúncios leva alguns dias para coletar dados suficientes para calcular o eCPM com precisão para uma rede de mediação. Enquanto isso, o status de otimização da origem de anúncios é PENDING. Portanto, é necessário definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios vai começar a atualizar o eCPM automaticamente.

Adicionar Chartboost à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Importante: verifique se você tem a permissão Gerenciamento de conta para concluir a configuração do consentimento para usuários da UE e do GDPR, da CPRA e da plataforma de mensagens do usuário. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

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

Observação: a falha na integração das versões compatíveis do SDK dos anúncios para dispositivos móveis do Google e da Chartboost pode causar problemas de build.

Usando o CocoaPods (recomendado)

• Adicione a seguinte linha ao Podfile do seu projeto:

  pod 'GoogleMobileAdsMediationChartboost'
  

• Na linha de comando, execute:

  pod install --repo-update
  

Integração manual

• Faça o download da versão mais recente do SDK da Chartboost e vincule Chartboost.framework e CHAMoatMobileAppKit.framework no seu projeto.

• Faça o download da versão mais recente do adaptador Chartboost no link de download em Changelog e vincule ChartboostAdapter.framework no seu projeto.

• Adicione as seguintes estruturas ao projeto:

  • StoreKit
  • Foundation
  • CoreGraphics
  • WebKit
  • AVFoundation
  • UIKit

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.

Na versão 8.2.0 do SDK, a Chartboost adicionou o método addDataUseConsent. O exemplo de código abaixo define o consentimento de uso de dados como CHBGDPRConsentNonBehavioral. Se você optar por chamar esse método, recomendamos que o faça antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

Swift

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

Consulte o artigo do GDPR da Chartboost e os métodos de privacidade do iOS para mais detalhes e os valores que podem ser fornecidos em cada método.

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 legal desses termos). 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 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.

Na versão 8.2.0 do SDK, a Chartboost adicionou o método addDataUseConsent. O exemplo de código abaixo define o consentimento de uso de dados como CHBCCPAConsentOptInSale. Se você escolher chamar esse método, recomendamos que o faça antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

Swift

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

Consulte o artigo da CCPA da Chartboost e os métodos de privacidade do iOS para mais detalhes e os valores que podem ser fornecidos em cada método.

Códigos de erro

Se o adaptador não receber um anúncio da Chartboost, verifique o erro subjacente da resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMAdapterChartboost
GADMediationAdapterChartboost

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

Código do erro	Motivo
101	Os parâmetros do servidor da Chartboost configurados na interface AdMob estão ausentes ou 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 do anúncio solicitado não corresponde a um tamanho de banner compatível com a Chartboost.
105	A versão do SO do dispositivo é anterior à versão mínima do SO com suporte do SDK 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 Chartboost. Consulte o código para mais detalhes.

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

Versão 9.8.0.0

• Compatibilidade verificada com o SDK da Chartboost versão 9.8.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 11.11.0.
• SDK da Chartboost versão 9.8.0.

Versão 9.7.0.1

• CFBundleShortVersionString foi atualizado para ter três componentes em vez de quatro.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 11.10.0.
• SDK da Chartboost versão 9.7.0.

Versão 9.7.0.0

• Compatibilidade verificada com o SDK Chartboost versão 9.7.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 11.2.0.
• SDK da Chartboost versão 9.7.0.

Versão 9.6.0.1

• Agora requer a versão mínima do iOS 12.0.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 11.0 ou mais recente.
• Incluiu Info.plist nos frameworks em ChartboostAdapter.xcframework.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 11.0.1.
• SDK da Chartboost versão 9.6.0.

Versão 9.6.0.0

• Compatibilidade verificada com o SDK da Chartboost versão 9.6.0.
• O método descontinuado GADMobileAds.sharedInstance.sdkVersion foi substituído por GADMobileAds.sharedInstance.versionNumber.
• Adição da implementação de GADMediationInterstitialAd.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.14.0.
• SDK da Chartboost versão 9.6.0.

Versão 9.5.1.0

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

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.12.0.
• SDK da Chartboost versão 9.5.1.

Versão 9.4.0.0

• Compatibilidade verificada com o SDK Chartboost versão 9.4.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.7.0.
• SDK da Chartboost versão 9.4.0.

Versão 9.3.1.0

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

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.7.0.
• SDK da Chartboost versão 9.3.1.

Versão 9.3.0.0

• Compatibilidade verificada com o SDK da Chartboost versão 9.3.0.
• Agora requer a versão mínima do iOS 11.0.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.4.0 ou mais recente.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.4.0.
• SDK da Chartboost versão 9.3.0.

Versão 9.2.0.0

• A importação GADMChartboostExtras foi removida no arquivo de cabeçalho ChartboostAdapter.
• Compatibilidade verificada com o SDK Chartboost versão 9.2.0.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.0.0 ou mais recente.
• A compatibilidade com a arquitetura armv7 foi removida.
• Agora requer a versão mínima do iOS 11.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.0.0.
• SDK da Chartboost versão 9.2.0.

Versão 9.1.0.0

• Compatibilidade verificada com o SDK Chartboost versão 9.1.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 9.11.0.
• SDK da Chartboost versão 9.1.0.

Versão 9.0.0.0

• Compatibilidade verificada com o SDK Chartboost versão 9.0.0.
• Compatibilidade verificada com o SDK dos anúncios para dispositivos móveis do Google versão 9.10.0.
• Atualizamos o adaptador para usar a API didRewardUser.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 9.8.0 ou mais recente.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 9.10.0.
• SDK da Chartboost versão 9.0.0.

Versão 8.5.0.2

• Compatibilidade verificada com a versão 9.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 9.0.0 ou mais recente.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 9.0.0.
• SDK da Chartboost versão 8.5.0.

Versão 8.5.0.1.0

• Compatibilidade verificada com o SDK 8.5.0 do Chartboost, que se refere à versão 8.5.0.1 no CocoaPods.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.13.0.
• SDK da Chartboost versão 8.5.0.

Versão 8.5.0.0

• Compatibilidade verificada com o SDK Chartboost 8.5.0.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.12.0.
• SDK da Chartboost versão 8.5.0.

Versão 8.4.2.0

• Compatibilidade verificada com o SDK 8.4.2 da Chartboost.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.6.0.
• SDK da Chartboost versão 8.4.2.

Versão 8.4.1.1

• Dependência relaxada do SDK dos anúncios para dispositivos móveis do Google versão 8.0.0 ou mais recente.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.4.0.
• SDK da Chartboost versão 8.4.1.

Versão 8.4.1.0

• Compatibilidade verificada com o SDK Chartboost 8.4.1.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 8.1.0 ou mais recente.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.1.0.
• SDK da Chartboost versão 8.4.1.

Versão 8.4.0.1

• Foram adicionados códigos e mensagens de erro padronizados do adaptador.
• O adaptador foi atualizado para usar o formato .xcframework.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 8.0.0 ou mais recente.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.0.0.
• SDK da Chartboost versão 8.4.0.

Versão 8.4.0.0

• Compatibilidade verificada com o SDK 8.4.0 do Chartboost.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.68.0 ou mais recente.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.68.0.
• SDK da Chartboost versão 8.4.0.

Versão 8.3.1.0

• Compatibilidade verificada com o SDK 8.3.1 do Chartboost.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.66.0 ou mais recente.
• Agora requer a versão mínima do iOS 10.0.
• O adaptador foi atualizado para oferecer suporte a solicitações de banners adaptativos.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.66.0.
• SDK da Chartboost versão 8.3.1.

Versão 8.2.1.0

• Compatibilidade verificada com o SDK 8.2.1 da Chartboost.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.64.0 ou mais recente.
• Agora requer a versão mínima do iOS 9.0.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.64.0.
• SDK da Chartboost versão 8.2.1.

Versão 8.2.0.0

• Compatibilidade verificada com o SDK 8.2.0 do Chartboost.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.61.0 ou mais recente.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.61.0.
• SDK da Chartboost versão 8.2.0.

Versão 8.1.0.1

• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 7.60.0.
• Atualizamos o adaptador para usar a nova API da Chartboost e removemos as APIs descontinuadas.
• Agora, o adaptador oferece suporte ao carregamento de vários anúncios do mesmo formato usando o mesmo local da Chartboost.
• Se a recompensa não for substituída na interface da AdMob ou do Ad Manager, o valor da recompensa para anúncios premiados agora será o valor especificado na interface da Chartboost em vez de 0.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.60.0.
• SDK da Chartboost versão 8.1.0.

Versão 8.1.0.0

• Compatibilidade verificada com o SDK 8.1.0 do Chartboost.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 7.59.0.
• Remoção do suporte à arquitetura i386.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.59.0.
• SDK da Chartboost versão 8.1.0.

Versão 8.0.4.0

• Compatibilidade verificada com o SDK 8.0.4 do Chartboost.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.52.0.
• SDK da Chartboost versão 8.0.4.

Versão 8.0.1.1

• Correção de um problema em que a solicitação de anúncios de banner não retornava preenchimentos.

Versão 8.0.1.0

• Compatibilidade verificada com o SDK 8.0.1 do Chartboost.
• Foi adicionado suporte para solicitar anúncios de banner.

Versão 7.5.0.1

• Foi adicionado um código para inicializar corretamente o SDK da Chartboost.

Versão 7.5.0.0

• Compatibilidade verificada com o SDK Chartboost 7.5.0.
• Atualizamos o adaptador para usar a nova API de recompensa.
• Atualizamos o adaptador para processar várias solicitações intersticiais.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.42.2 ou mais recente.

Versão 7.3.0.0

• Compatibilidade verificada com o SDK 7.3.0 do Chartboost.

Versão 7.2.0.1

• O callback adapterDidCompletePlayingRewardBasedVideoAd: foi adicionado ao adaptador.

Versão 7.2.0.0

• Compatibilidade verificada com o SDK 7.2.0 do Chartboost.

Versão 7.1.2.0

• Compatibilidade verificada com o SDK 7.1.2 do Chartboost.

Versão 7.1.1.0

• Compatibilidade verificada com o SDK 7.1.1 do Chartboost.

Versão 7.1.0.0

• Compatibilidade verificada com o SDK 7.1.0 do Chartboost.

Versão 7.0.4.0

• Compatibilidade verificada com o SDK 7.0.4 do Chartboost.

Versão 7.0.3.0

• Compatibilidade verificada com o SDK 7.0.3 da Chartboost.

Versão 7.0.2.0

• Compatibilidade verificada com o SDK 7.0.2 do Chartboost.
• Adição de suporte a dois novos códigos de erro do Chartboost.

Versão 7.0.1.0

• Compatibilidade verificada com o SDK 7.0.1 da Chartboost.

Versão 7.0.0.0

• Compatibilidade verificada com o SDK 7.0.0 do Chartboost.

Versão 6.6.3.0

• Compatibilidade verificada com o SDK 6.6.3 do Chartboost.
• O suporte para a arquitetura "armv7s" foi removido.
• Correção de um bug em que os editores enfrentavam um problema de compilação no Swift ao importar ChartboostAdapter.framework como um módulo que importava o SDK Chartboost não modular.

Versão 6.6.2.0

• Compatibilidade verificada com o SDK 6.6.2 da Chartboost.

Versão 6.6.1.0

• Compatibilidade verificada com o SDK 6.6.1 do Chartboost.

Versão 6.6.0.0

• Compatibilidade verificada com o SDK 6.6.0 do Chartboost.

Versão 6.5.2.1

• O suporte a bitcode foi ativado.
• Agora, o adaptador Chartboost está sendo distribuído como uma estrutura.
• Para importar ChartboostAdapter.framework no seu projeto, defina Allow Non-modular Includes in Framework Modules como YES em Configurações de build do destino.

Versão 6.5.2.0

• O sistema de nomenclatura de versões foi alterado para [versão do SDK da Chartboost].[versão do patch do adaptador].
• Atualizamos o SDK mínimo necessário da Chartboost para a v6.5.1.
• Atualizamos o SDK dos anúncios para dispositivos móveis do Google para a versão mínima v7.10.1.
• Correção de um bug para oferecer suporte a vários locais de anúncios da Chartboost.
• Agora os apps recebem o callback interstitialWillDismissScreen: quando o anúncio intersticial está prestes a ser dispensado.
• Agora os apps recebem o callback rewardBasedVideoAdDidOpen: quando um anúncio em vídeo com recompensa é aberto.

Versão 1.1.0

• A localização do anúncio do Chartboost foi removida dos extras do Chartboost. A localização do anúncio agora é especificada no console da AdMob ao configurar a Chartboost para mediação.

Versão 1.0.0

• Versão inicial. Suporte a anúncios em vídeo e intersticiais com recompensa.