Integrar a AdColony com a 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 AdColony usando a mediação, e abrangendo integrações de lances e hierarquia. Ele aborda como adicionar o AdColony à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da AdColony a um app Unity.

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

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado

Requisitos

  • Unity 5.6 ou mais recente
  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • [Para lances]: plug-in de mediação de anúncios para dispositivos móveis do Google para o AdColony 1.0.5 ou superior (versão mais recente recomendada)
  • Para implantar no Android
    • Android API de nível 19 ou mais recente
  • Para implantar no iOS:
    • Meta de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia explicativo de mediação

Etapa 1: definir configurações na interface do AdColony

Inscreva-se e faça login na sua conta da AdColony. Adicione seu app ao painel do editor do AdColony clicando no botão Configurar novo app.

Configuração do novo app da AdColony

Preencha o formulário e clique em Criar na parte inferior da página para adicionar seu app ao AdColony.

Android

Criar app da AdColony

iOS

Criar app da AdColony

Depois que seu app for criado, acesse o ID do app em Monetização > Apps na seção Informações básicas do app.

Android

ID do app AdColony

iOS

ID do app AdColony

Em seguida, crie uma nova zona de anúncio clicando no botão Configurar nova zona de anúncio na seção Zonas de anúncio da página do seu app. Recomendamos criar uma nova zona de anúncios para mediação com AdMob , mesmo que você já tenha uma.

Android

Zona de configuração da AdColony

iOS

Zona de configuração da AdColony

Para mais instruções sobre como criar um posicionamento de anúncio, selecione a guia correspondente ao formato de anúncio preferido.

  1. Defina A Zona está ativa? como Sim.

  2. Insira um Nome para sua zona de anúncios.

  3. Escolha Banner como Tamanho da zona de anúncio.

  4. Insira um valor para o Limite de reproduções diárias.

Intersticial

  1. Defina A Zona está ativa? como Sim.

  2. Insira um Nome para sua zona de anúncios.

  3. Escolha Anúncio precedente/intersticial como o Tipo de zona.

  4. Insira um valor para o Limite de reproduções diárias.

Premiado

  1. Defina A Zona está ativa? como Sim.

  2. Insira um Nome para sua zona de anúncios.

  3. Escolha Value Exchange/V4VC como o Tipo de zona.

  4. Defina Somente no lado do cliente? como Sim e insira um Nome de moeda virtual, Máximo de vídeos diários por usuário e Valor do prêmio.

  5. Insira um valor para o Limite de reproduções diárias.

Quando terminar de criar a zona de anúncio, clique no botão Criar.

Depois que a zona de anúncio for criada, localize seu ID da zona na seção Integração da zona de anúncio. O ID da zona vai ser usado na próxima etapa.

ID da zona do AdColony

Localizar sua chave de API do AdColony

Lances

Esta etapa não é necessária para integrações de lances.

Cascata

Você vai precisar da chave de API da AdColony para configurar o AdMob ID do bloco de anúncios. Navegue até Configurações da conta no painel do editor da AdColony para localizar a chave de API.

Configurações do AdColony

Ativar modo de teste

Para ativar anúncios de teste no AdColony, acesse o painel da plataforma e navegue até Monetization > Apps. Selecione a zona em que você quer ativar os anúncios de teste na seção Zonas de anúncios do app. Para ativar os anúncios de teste, marque Sim como Mostrar somente anúncios de teste? na seção Desenvolvimento.

Teste do AdColony

Etapa 2: configurar a demanda do AdColony na AdMob interface

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

Android

Para conferir instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

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

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar AdColony à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.

Etapa 3: importar o SDK e o adaptador do AdColony

Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para o AdColony usando o link de download no Registro de mudanças (link em inglês) e extraia o GoogleMobileAdsAdColonyMediation.unitypackage do arquivo ZIP.

No editor de projetos do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsAdColonyMediation.unitypackage que você fez o download. Verifique se todos os arquivos estão selecionados e clique em Import.

Em seguida, selecione Assets > Play Services Resolver > Android Resolver > Force Resolve. A biblioteca External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do app Unity.

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

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos deles em relação ao uso de identificadores de dispositivos 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 solicitar 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.

O plug-in de mediação de anúncios para dispositivos móveis do Google para a versão 2.6.1 do AdColony adicionou a classe AdColonyAppOptions com os métodos SetPrivacyFrameworkRequired() e SetPrivacyConsentString() para permitir que você transmita o consentimento ao SDK do AdColony. O exemplo de código a seguir demonstra como transmitir informações de consentimento para o adaptador da AdColony, que serão usadas no método de inicialização da plataforma. É preciso definir essas opções antes de inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK do AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

Consulte o artigo sobre privacidade do consumidor e o guia de implementação das leis de privacidade da AdColony para mais detalhes e os valores que podem ser fornecidos no 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 desses termos) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode 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 a versão 2.6.1 do AdColony adicionou a classe AdColonyAppOptions com os métodos SetPrivacyFrameworkRequired() e SetPrivacyConsentString() para permitir que você transmita o consentimento ao SDK do AdColony. O exemplo de código a seguir demonstra como transmitir informações de consentimento para o adaptador do AdColony, que serão usadas no método de inicialização da AdColony. É preciso definir essas opções antes de inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente ao SDK do AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

Consulte o artigo sobre privacidade do consumidor e o guia de implementação das leis de privacidade da AdColony para mais detalhes e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração com a AdColony.

iOS

Integração da SKAdNetwork

Siga a documentação da AdColony (link em inglês) para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em AdMob e ative o modo de teste na AdColony interface.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do AdColony, ative os testes de uma única origem no Ad Inspector usando as AdColony (Bidding) and AdColony (Waterfall) origens de anúncios.

Etapas opcionais

Android

Permissões

Para um desempenho ideal, a AdColony recomenda adicionar as permissões opcionais abaixo ao arquivo AndroidManifest.xml localizado no diretório Assets/Plugins/Android/GoogleMobileAdsPlugin do seu projeto do Unity.

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

iOS

Nenhuma outra etapa é necessária para a integração com o iOS.

Parâmetros específicos de rede

O pacote de mediação AdColony oferece suporte a outros parâmetros de configuração e solicitação, que podem ser transmitidos ao adaptador usando as classes AdColonyMediationExtras e AdColonyAppOptions.

A classe AdColonyMediationExtras inclui os seguintes métodos:

SetShowPrePopup(bool)
Define se um pop-up será ou não exibido antes de mostrar um anúncio. Defina como "false" se você não quiser mostrar um pop-up antes da veiculação dos anúncios.
SetShowPostPopup(bool)
Define se um pop-up será ou não exibido depois de mostrar um anúncio. Defina como "false" se você não quiser mostrar um pop-up após a exibição dos anúncios.

A classe AdColonyAppOptions inclui os seguintes métodos:

SetUserId(string)
Define o User-ID para o SDK do AdColony, que fornece mais análises para o servidor de anúncios da AdColony.
SetTestMode(bool)
Define se o modo de teste do SDK do AdColony será ativado ou não.

Confira um exemplo de código que mostra como definir essas configurações e parâmetros de solicitação de anúncio:

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

Códigos de erro

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

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

Confira abaixo os códigos e as mensagens associadas gerados pelo adaptador da AdColony quando o carregamento de um anúncio falha:

Android

Código do erro Motivo
100 O SDK do AdColony retornou um erro.
101 Parâmetros de servidor inválidos (por exemplo, ID de zona ausente).
102 Já foi solicitado um anúncio para o mesmo ID de zona.
103 O SDK do AdColony retornou um erro de inicialização.
104 O tamanho do banner solicitado não corresponde a um tamanho de anúncio válido da AdColony.
105 Erro de apresentação devido ao anúncio não carregado.
106 O contexto usado para inicializar o SDK do AdColony não era uma instância de Activity.

iOS

Código do erro Motivo
0 a 3 O SDK do AdColony retornou um erro. Consulte a documentação para saber mais detalhes.
101 Parâmetros de servidor inválidos (por exemplo, ID de zona ausente).
102 O controlador de visualização raiz que apresenta o anúncio é nil.
103 O SDK do AdColony retornou um erro de inicialização.
104 O SDK do AdColony não permite a configuração duas vezes em um período de cinco segundos.
105 Falha ao exibir o anúncio.
106 A zona usada para anúncios premiados não é uma zona premiada no portal AdColony.

Registros de alterações do plug-in de mediação para Unity da AdColony

Versão 2.6.3 (em andamento)

  • Correção de um aviso de definição duplicada para MediationExtras

Versão 2.6.2

Versão 2.6.1

  • As APIs de privacidade da classe AdColonyAppOptions foram atualizadas para os seguintes métodos, com suporte ao GDPR e à CCPA:
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • De SetGDPRConsentString(string) a SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • Compatível com a versão 4.8.0.1 do adaptador AdColony para Android.
  • Compatível com o adaptador para iOS da AdColony versão 4.9.0.2.
  • Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.4.1.

Versão 2.6.0

Versão 2.5.0

Versão 2.4.1

Versão 2.4.0

Versão 2.3.0

Versão 2.2.0

Versão 2.1.0

Versão 2.0.3

Versão 2.0.2

Versão 2.0.1

Versão 2.0.0

Versão 1.0.6

Versão 1.0.5

  • Os seguintes métodos da classe Builder AdColonyMediationExtras foram movidos para a classe AdColonyAppOptions:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • Os seguintes métodos foram adicionados à classe AdColonyAppOptions:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • O método SetZoneId() foi removido da classe Builder AdColonyMediationExtras
  • Oferece suporte ao adaptador AdColony para Android versão 3.3.10.1.
  • Compatível com o adaptador para iOS da AdColony versão 3.3.7.2.

Versão 1.0.4

  • Atualização do plug-in para oferecer suporte à nova API Premiada em versão Beta aberta.
  • Oferece suporte ao adaptador AdColony para Android versão 3.3.8.1.
  • Compatível com o adaptador para iOS da AdColony versão 3.3.6.1.

Versão 1.0.3

  • Oferece suporte ao adaptador AdColony para Android versão 3.3.5.1.
  • Compatível com o adaptador para iOS da AdColony versão 3.3.5.0.

Versão 1.0.2

  • Compatível com o SDK do AdColony para Android versão 3.3.4.
  • Compatível com o SDK do AdColony para iOS versão 3.3.4.
  • O SetTestMode() da classe Builder AdColonyMediationExtras agora é ignorado para Android Agora, os editores podem solicitar anúncios de teste da AdColony para Android especificando um dispositivo de teste usando o AddTestDevice() da classe Builder AdRequest.
  • Os seguintes métodos foram adicionados à classe Builder AdColonyMediationExtras:
    • SetGDPRRequired()
    • SetGDPRConsentString()

Versão 1.0.1

  • Compatível com o SDK do AdColony para Android versão 3.3.0-unity.
  • Compatível com o SDK do AdColony para iOS versão 3.3.0.

Versão 1.0.0

  • Primeira versão!
  • Compatível com o SDK do AdColony para Android versão 3.3.0.
  • Compatível com o SDK do AdColony para iOS versão 3.3.0.