Integrar a Moloco à mediação

Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios de display do SDK de anúncio da Moloco Ads usando a mediação, incluindo as integrações de lances. Ele explica como adicionar o SDK de anúncio da Moloco Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Moloco Ads a um app Unity.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para o SDK de anúncio da Moloco tem os seguintes recursos:

Pré-requisitos

Antes de continuar, verifique o seguinte:

• Versão mais recente do Google Mobile Ads Unity Plugin.
• Unity Editor versão 5.6 ou mais recente.
• Plug-in do Unity da Moloco 1.2.0 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 Google Mobile Ads Unity Plugin para mais detalhes.
• Configure a mediação.

Etapa 1: definir as configurações na interface do SDK do Moloco Ads

Faça login no Portal do editor da Moloco.

Navegue até a guia Visão geral > Apps e clique no botão Adicionar app para criar um novo app.

Selecione o SO e as Configurações de privacidade do app, preencha o restante do formulário e clique em Criar.

Android

iOS

Depois que o app for criado, selecione-o na guia Apps para ver os detalhes e anote a chave do app.

Android

iOS

Acesse a guia Visão geral > Blocos de anúncios, selecione o app no menu suspenso e clique em Novo bloco de anúncios.

Selecione In-app bidding como o Auction method e preencha o restante do formulário. Em seguida, clique em Criar.

Acesse o bloco de anúncios recém-criado na guia Blocos de anúncios para conferir os detalhes dele. Anote o ID do bloco de anúncios.

Etapa 2: configurar a demanda do SDK do Moloco Ads na interface do Ad Manager

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

Adicionar a Moloco Ads à 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 Moloco Ads à 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 Moloco Ads

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

Etapa 4: implementar configurações de privacidade no SDK da Moloco

Consentimento para a UE e o GDPR

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer algumas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de pedir o consentimento deles para usar cookies ou outro 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.

A versão 1.0.0 e mais recentes do adaptador do SDK do Unity para anúncios da Moloco permitem transmitir indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK do SDK de anúncios da Moloco. Para mais informações, consulte a documentação do MolocoPrivacy para Android e a string de consentimento da TCF para iOS.

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 plug-in de mediação do Unity dos Anúncios para Dispositivos Móveis do Google para o SDK de anúncios da Moloco inclui o método Moloco.SetDoNotSell(bool) para transmitir informações de consentimento ao SDK de anúncios da Moloco. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK de anúncios da Moloco. Se você optar por definir essas flags, recomendamos fazer isso antes de solicitar anúncios pelo Google Mobile Ads Unity Plugin.

using GoogleMobileAds.Api.Mediation.Moloco;
// ...

Moloco.SetDoNotSell(true);

Consulte as instruções de implementação recomendadas do SDK de anúncios da Moloco para Android e iOS e saiba mais.

Etapa 5: adicionar o código necessário

Nenhum código adicional é necessário para a integração do SDK da Moloco Ads.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do SDK da Moloco Ads, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Moloco (lances).

Códigos de erro

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

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Registro de alterações do plug-in de mediação da Moloco para Unity

Versão 3.10.1

• Compatível com a versão 4.12.0.1 do adaptador Android da Moloco.
• Compatível com a versão 4.10.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.10.0

• Compatível com a versão 4.12.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.10.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.9.1

• Compatível com a versão 4.11.1.0 do adaptador do Android da Moloco.
• Compatível com a versão 4.9.1.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.9.0

• Compatível com a versão 4.11.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.9.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.8.1

• Compatível com a versão 4.10.1.0 do adaptador Android da Moloco.
• Compatível com a versão 4.8.1.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.8.0

• Compatível com a versão 4.10.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.8.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.7.0

• Compatível com a versão 4.9.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.6.1.1.1 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.6.1

• Compatível com a versão 4.8.1.0 do adaptador do Android da Moloco.
• Compatível com a versão 4.6.1.1 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.6.0

• Compatível com a versão 4.8.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.6.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.1

• Compatível com a versão 4.7.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.5.1.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.0

• Compatível com a versão 4.7.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.5.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.4.1

• Compatível com a versão 4.6.0.0 do adaptador do Android da Moloco.
• Compatível com a versão 4.4.1.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.4.0

• Compatível com a versão 4.6.0.0 do adaptador do Android da Moloco.
• Compatível com a versão 4.4.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.1

• Compatível com a versão 4.5.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.3.0.2 do adaptador da Moloco para iOS.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.0

• Compatível com a versão 4.5.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.3.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.7.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.2.0

• Compatível com a versão 4.4.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.2.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.7.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.0

• Compatível com a versão 4.4.0.0 do adaptador Android da Moloco.
• Compatível com a versão 4.1.2.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.0.0

• Compatível com a versão 4.3.1.0 do adaptador Android da Moloco.
• Compatível com a versão 4.1.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 2.2.1

• Compatível com a versão 4.2.1.0 do adaptador Android da Moloco.
• Compatível com a versão 3.13.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 2.2.0

• Compatível com a versão 4.2.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.13.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 2.1.0

• Compatível com a versão 4.1.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.13.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 2.0.0

• Compatível com a versão 4.0.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.13.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.4.2 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.6.1

• Compatível com a versão 3.12.1.0 do adaptador Android da Moloco.
• Compatível com a versão 3.12.1.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.6.0

• Compatível com a versão 3.12.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.12.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.5.0

• Compatível com a versão 3.11.0.0 do adaptador do Android da Moloco.
• Compatível com a versão 3.11.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.4.0

• Compatível com a versão 3.10.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.10.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.3.1

• Compatível com a versão 3.9.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.9.1.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.3.0

• Compatível com a versão 3.9.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.9.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.2.1

• Compatível com a versão 3.8.0.1 do adaptador do Android da Moloco.
• Compatível com a versão 3.8.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.2.0

• Compatível com a versão 3.8.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.8.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.1.0

• Compatível com a versão 3.7.2.0 do adaptador Android da Moloco.
• Compatível com a versão 3.7.2.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.0.0

• Lançamento inicial!
• Compatível com a versão 3.7.0.0 do adaptador Android da Moloco.
• Compatível com a versão 3.6.0.0 do adaptador da Moloco para iOS.
• Criado e testado com a versão 9.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.