Integrar o Chartboost à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da Chartboost usando Mediação da AdMob, cobrindo integrações de hierarquia. Ele mostra como adicionar o Chartboost aos blocos de anúncios configuração de mediação e como integrar o SDK e o adaptador do Chartboost em um iOS app.

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

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

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

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

• Concluir a mediação Guia explicativo

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

Inscreva-se para ter uma conta da Chartboost e faça login depois que sua conta for verificada. Em seguida, acesse a guia Gerenciamento de apps.

Clique no botão Add new app para criar seu app.

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

Depois que o app for criado, o painel será aberto. Anote o ID do app e a assinatura do app.

Observação :para acessar o painel do app, acesse o Guia Gerenciamento de apps mostrada anteriormente e selecionando seu app.

Android

iOS

A AdMob requer o User ID da Chartboost e Assinatura do usuário para configurar seu anúncio da AdMob ID da unidade. Para encontrar esses parâmetros, clique em Mediação do Chartboost em interface do Chartboost.

Acesse o menu Recursos > guia "Explorador de APIs" e anote suas User ID e User Signature localizados na seção Authentication.

Ativar modo de teste

Para ativar o modo de teste no seu app, acesse Gerenciamento de aplicativos da interface do Chartboost, selecione seu aplicativo na lista e clique em Edite as configurações do app.

Android

iOS

Nas configurações do app, é possível ativar ou desativar o Modo de teste.

Com o modo de teste ativado, é possível solicitar anúncios usando o ID do bloco de anúncios criado antes e receber um anúncio de teste da Chartboost.

Quando você receber anúncios de teste da Chartboost, seu app será posicionado na Revisão de app do editor da Chartboost. Para que a monetização no Chartboost funcione, a revisão do aplicativo do editor deverá precisam ser aprovados pela Chartboost.

Etapa 2: configurar a demanda do Chartboost na AdMob interface

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

Você precisa adicionar Chartboost à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para editá-lo e prossiga para Adicionar Chartboost como uma origem de anúncios.

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

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

Atribua um nome ao seu grupo de mediação e selecione locais para segmentar. 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únciosAdMob existentes. Em seguida, clique em Concluído.

Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados:

Adicionar Chartboost como uma origem de anúncios

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

Selecione Chartboost e ative a chave Otimizar. Insira o User ID and User Signature recebido na seção anterior para configurar a otimização da origem de anúncios para Chartboost. Em seguida, insira um valor de eCPM para 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á tem um mapeamento para Chartboost, pode selecioná-lo. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o App ID, App Signature and Ad Location recebido na seção anterior. Em seguida, clique em Concluído.

Importante: o App ID precisa estar associado ao app de destino, como na Chartboost interface.

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

Observação:o AdMob é capaz de estimar CPMs para os três principais locais de anúncios no seu app Chartboost. Todos os outros locais seriam representados com um CPM combinado.

Na interface do Chartboost, os locais dos anúncios podem ser revelados na página Configurações básicas clicando em Configurações avançadas. Consulte o guia Locais nomeados do Chartboost para mais detalhes.

Por fim, clique em Concluído para adicionar o Chartboost como uma origem de anúncios e, em seguida, clique em Salvar.

Observação :a otimização da origem de anúncios leva alguns dias para coletar dados suficientes e calcular com precisão o eCPM para uma rede de mediação. Enquanto isso, o status de otimização da origem de anúncio é PENDING. Portanto, você precisa definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios começará a atualizá-lo automaticamente por você.

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

Importante: Verifique se você tem permissão de Gerenciamento de conta para concluir o configuração para consentimento e GDPR da UE, CPRA e plataforma de mensagens do usuário. Consulte Gerencie o acesso dos usuários aos seus padrão para mais detalhes.

Etapa 3: importar o SDK e o adaptador do Chartboost

Observação :falha na integração do SDK compatível do Chartboost e dos anúncios para dispositivos móveis do Google mais recentes pode levar a problemas de build.

Como usar CocoaPods (recomendado)

• Adicione a seguinte linha ao Podfile do projeto:

  pod 'GoogleMobileAdsMediationChartboost'
  

• Na linha de comando, execute:

  pod install --repo-update
  

Integração manual

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

• Faça o download da versão mais recente do adaptador Chartboost pelo link de download em Changelog e Vincule ChartboostAdapter.framework ao projeto.

• Adicione os seguintes frameworks ao seu projeto:

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

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

Consentimento da UE e GDPR

De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.

Na versão 8.2.0 do SDK, o Chartboost adicionou o método addDataUseConsent. A a seguir, o exemplo de código define o consentimento para o uso de dados como CHBGDPRConsentNonBehavioral. Se optar por chamar esse método, é recomendável que você o faça antes de solicitando anúncios por meio do 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 os artigo do GDPR e as 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

Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" da página inicial de seu grupo. A Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.

Na versão 8.2.0 do SDK, o Chartboost adicionou o método addDataUseConsent. A a seguir, o exemplo de código define o consentimento para o uso de dados como CHBCCPAConsentOptInSale. Se você optar por chamar esse método, é recomendável que você o faça antes de solicitar com o 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 os o artigo sobre a CCPA e as 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, você poderá verificar o erro subjacente da resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMAdapterChartboost
GADMediationAdapterChartboost

Estes são os códigos e as mensagens correspondentes gerados pelo adaptador da Chartboost quando ocorre uma falha no carregamento de um anúncio:

Código do erro	Motivo
101	Os parâmetros do servidor do Chartboost configurados na AdMob interface estão ausentes/inválidos.
102	O SDK do 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 compatível do SDK do Chartboost.
200-299	Erros de cache do SDK do Chartboost. Veja o código para mais detalhes.
300-399	O SDK do Chartboost mostra erros. Veja o código para mais detalhes.
400-499	Erros de clique do SDK do Chartboost. Veja o código para mais detalhes.

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

Versão 9.7.0.0

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

Criado e testado com:

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

Versão 9.6.0.1

• Agora exige a versão mínima do iOS 12.0.
• Agora requer a versão 11.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
• Inclusão de 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 do Chartboost versão 9.6.0.

Versão 9.6.0.0

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

Criado e testado com:

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

Versão 9.5.1.0

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

Criado e testado com:

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

Versão 9.4.0.0

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

Criado e testado com:

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

Versão 9.3.1.0

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

Criado e testado com:

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

Versão 9.3.0.0

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

Criado e testado com:

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

Versão 9.2.0.0

• A importação de GADMChartboostExtras foi removida no arquivo principal ChartboostAdapter.
• Compatibilidade verificada com a versão 9.2.0 do SDK do Chartboost.
• Agora requer a versão 10.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
• Remoção da compatibilidade com a arquitetura armv7.
• 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 do Chartboost versão 9.2.0.

Versão 9.1.0.0

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

Criado e testado com:

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

Versão 9.0.0.0

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

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 9.10.0.
• SDK do 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 requer a versão 9.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

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

Versão 8.5.0.1.0

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

Criado e testado com

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

Versão 8.5.0.0

• Compatibilidade verificada com o SDK do Chartboost 8.5.0.

Criado e testado com

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

Versão 8.4.2.0

• Compatibilidade verificada com o SDK do Chartboost 8.4.2.

Criado e testado com

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

Versão 8.4.1.1

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

Criado e testado com

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

Versão 8.4.1.0

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

Criado e testado com

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

Versão 8.4.0.1

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

Criado e testado com

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

Versão 8.4.0.0

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

Criado e testado com

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

Versão 8.3.1.0

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

Criado e testado com

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

Versão 8.2.1.0

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

Criado e testado com

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

Versão 8.2.0.0

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

Criado e testado com

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

Versão 8.1.0.1

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

Criado e testado com

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

Versão 8.1.0.0

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

Criado e testado com

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

Versão 8.0.4.0

• Compatibilidade verificada com o SDK do Chartboost 8.0.4.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.52.0.
• SDK do 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 do Chartboost 8.0.1.
• Agora é possível solicitar anúncios de banner.

Versão 7.5.0.1

• Adição de código para inicializar corretamente o SDK do Chartboost.

Versão 7.5.0.0

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

Versão 7.3.0.0

• Compatibilidade verificada com o SDK do Chartboost 7.3.0.

Versão 7.2.0.1

• O callback adapterDidCompletePlayingRewardBasedVideoAd: foi adicionado ao adaptador.

Versão 7.2.0.0

• Compatibilidade verificada com o SDK do Chartboost 7.2.0.

Versão 7.1.2.0

• Compatibilidade verificada com o SDK do Chartboost 7.1.2.

Versão 7.1.1.0

• Compatibilidade verificada com o SDK do Chartboost 7.1.1.

Versão 7.1.0.0

• Compatibilidade verificada com o SDK do Chartboost 7.1.0.

Versão 7.0.4.0

• Compatibilidade verificada com o SDK do Chartboost 7.0.4.

Versão 7.0.3.0

• Compatibilidade verificada com o SDK do Chartboost 7.0.3.

Versão 7.0.2.0

• Compatibilidade verificada com o SDK do Chartboost 7.0.2.
• Foi adicionado suporte a dois novos códigos de erro da Chartboost.

Versão 7.0.1.0

• Compatibilidade verificada com o SDK do Chartboost 7.0.1.

Versão 7.0.0.0

• Compatibilidade verificada com o SDK do Chartboost 7.0.0.

Versão 6.6.3.0

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

Versão 6.6.2.0

• Compatibilidade verificada com o SDK do Chartboost 6.6.2.

Versão 6.6.1.0

• Compatibilidade verificada com o SDK do Chartboost 6.6.1.

Versão 6.6.0.0

• Compatibilidade verificada com o SDK do Chartboost 6.6.0.

Versão 6.5.2.1

• Suporte a bitcode ativado.
• Agora distribuindo o adaptador Chartboost como framework.
• Para importar ChartboostAdapter.framework no seu projeto, defina Allow Non-modular Includes in Framework Modules para YES em Build Configurações da meta.

Versão 6.5.2.0

• O sistema de nomenclatura de versões foi alterado para [Versão do SDK do Chartboost].[versão do patch do adaptador].
• Atualização do SDK mínimo necessário do Chartboost para a v6.5.1.
• Atualização do SDK mínimo dos anúncios para dispositivos móveis do Google para a versão 7.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 a anúncio intersticial está prestes a ser dispensado.
• Agora os apps recebem o callback rewardBasedVideoAdDidOpen: quando uma recompensa anúncio em vídeo é aberto.

Versão 1.1.0

• Remoção do local do anúncio da Chartboost dos extras da Chartboost. O local do anúncio agora é especificado no console da AdMob ao configurar o Chartboost para mediação.

Versão 1.0.0

• Versão inicial. É compatível com anúncios intersticiais e em vídeo baseados em prêmios.