Integrar o Moloco aos lances (Beta)

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Moloco usando a mediação, abordando as integrações de lances. Ela explica como adicionar a Moloco à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Moloco a um app iOS.

Integrações e formatos de anúncio aceitos

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

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

Requisitos

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

  • Adaptador da Moloco 3.9.1.0 ou mais recente

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

  • Conclua o Guia para iniciantes da mediação.

Etapa 1: configurar as configurações na interface da Moloco

Faça login no portal de editores 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.

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

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 Lances no app como o Método de leilão 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 da Moloco na interface do Ad Manager

Faça login na sua conta do Ad Manager.

Ativar o compartilhamento de indicador seguro

Acesse Administrador > Configurações globais. Acesse a guia Configurações da conta do Ad Exchange e ative a opção Compartilhamento de indicadores seguros. Clique em Salvar.

Compartilhar indicadores seguros em solicitações de lance

Acesse Inventário > Indicadores seguros. Em Indicadores seguros, pesquise SDK da Moloco Ads e ative a opção Ativar integração com o app.

Clique em Salvar.

Permitir o compartilhamento de indicadores seguros para lances do SDK

Acesse Exibição > Configurações do canal de demanda. Na guia Configurações padrão, ative a opção Permitir o compartilhamento de indicadores seguros para SDK Bidding.

Clique em Salvar.

Configurar os lances da Moloco

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Clique em Novo bidder.

Selecione Moloco Ads como o bidder.

Clique em Continuar para ativar os lances do SDK para esse bidder.

Clique em Concluído.

Configurar o mapeamento de blocos de anúncios

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Selecione a empresa para o SDK da Moloco Ads.

Acesse a guia Mapeamento de bloco de anúncios e clique em Novo mapeamento de bloco de anúncios.

Escolha Bloco de anúncios específico. Selecione um bloco e um formato de anúncio, App para dispositivos móveis como o Tipo de inventário e seu Aplicativo para dispositivos móveis. Em seguida, insira a chave do app e o ID do bloco de anúncios obtidos na seção anterior.

Por fim, clique em Salvar.

Adicionar a Moloco Ads à lista de parceiros de publicidade das regulamentações estaduais dos EUA e europeias

Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar os Anúncios da Moloco à 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

  • Adicione a seguinte linha ao Podfile do seu projeto:

    pod 'GoogleMobileAdsMediationMoloco'

  • Na linha de comando, execute:

    pod install --repo-update

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

Para obedecer à Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outro armazenamento local onde exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a 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úncio na sua cadeia de mediação. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

O SDK da Moloco inclui a flag hasUserConsent para transmitir informações de consentimento ao SDK da Moloco.

O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Moloco. Se você optar por definir essas flags, faça isso antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.hasUserConsent = true;

Objective-C 

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setHasUserConsent:YES];

Consulte a documentação de privacidade da Moloco para mais informações.

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 legal desses termos). Essa opção é disponibilizada por um link em destaque com a mensagem "Não vender minhas informações pessoais" na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados 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 anúncios na sua cadeia de mediação. Portanto, identifique cada rede de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

O SDK da Moloco inclui a flag isDoNotSell para transmitir informações de consentimento ao SDK da Moloco.

O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Moloco. Se você optar por definir essas flags, faça isso antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

Objective-C 

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setIsDoNotSell:YES];

Consulte a documentação de privacidade da Moloco para mais informações.

Etapa 5: 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 (Bidding).

Códigos de erro

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

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Código do erro Domínio Motivo
101 com.google.ads.mediation.moloco O SDK da Moloco não oferece suporte à veiculação de anúncios no iOS 12 e em versões anteriores.
102 com.google.ads.mediation.moloco Chave de app da Moloco ausente ou inválida.
103 com.google.ads.mediation.moloco O ID do bloco de anúncios da Moloco está ausente ou é inválido.
104 com.google.ads.mediation.moloco O anúncio não está pronto para ser exibido.
105 com.google.ads.mediation.moloco O anúncio não foi exibido.
106 com.google.ads.mediation.moloco Os dados de renderização não estão disponíveis para renderizar o anúncio.
-1 a 5000 Enviado pelo SDK da Moloco. O SDK da Moloco retornou um erro. Consulte a documentação da Moloco para mais detalhes.

Verificação do lado do servidor premiada

Se você Validar callbacks de verificação do lado do servidor (SSV), o identificador da origem do anúncio para a Moloco será 8267622065755668722.

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

Versão 3.12.0.0

  • Compatibilidade verificada com o SDK da Moloco versão 3.12.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.8.0.
  • Versão 3.12.0 do SDK da Moloco.

Versão 3.11.0.0

  • Compatibilidade verificada com a versão 3.11.0 do SDK da Moloco.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.6.0.
  • Versão 3.11.0 do SDK da Moloco.

Versão 3.10.1.0

  • Compatibilidade verificada com a versão 3.10.1 do SDK da Moloco.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.6.0.
  • Versão 3.10.1 do SDK da Moloco.

Versão 3.10.0.0

  • Compatibilidade verificada com a versão 3.10.0 do SDK da Moloco.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.5.0.
  • Versão 3.10.0 do SDK da Moloco.

Versão 3.9.1.0

  • Adicionamos suporte a marcas-d'água para formatos de anúncio de lances.
  • Correção de um problema ao carregar anúncios de banner MREC.
  • Compatibilidade verificada com a versão 3.9.1 do SDK da Moloco.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.3.0.
  • Versão 3.9.1 do SDK da Moloco.

Versão 3.9.0.0

  • O nome da plataforma de mediação agora é definido ao inicializar o SDK da Moloco.
  • Compatibilidade verificada com a versão 3.9.0 do SDK da Moloco.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.3.0.
  • Versão 3.9.0 do SDK da Moloco.

Versão 3.8.0.0

  • As flags -fobjc-arc e -fstack-protector-all estão ativadas.
  • Correção de um problema na obtenção da classificação por estrelas para anúncios nativos.
  • Compatibilidade verificada com o SDK da Moloco versão 3.8.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.2.0.
  • Versão 3.8.0 do SDK da Moloco.

Versão 3.7.2.0

  • Compatibilidade verificada com a versão 3.7.2 do SDK da Moloco.
  • Agora é possível dar lances no formato de anúncio nativo.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.1.0.
  • Versão 3.7.2 do SDK da Moloco.

Versão 3.7.1.0

  • Compatibilidade verificada com a versão 3.7.1 do SDK da Moloco.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.1.0.
  • Versão 3.7.1 do SDK da Moloco.

Versão 3.7.0.0

  • Compatibilidade verificada com a versão 3.7.0 do SDK da Moloco.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.0.0.
  • Versão 3.7.0 do SDK da Moloco.

Versão 3.6.0.1

  • O adaptador foi atualizado para recuperar a versão do SDK da Moloco da linha de execução principal.
  • Agora requer o SDK dos anúncios para dispositivos móveis do Google versão 12.0.0 ou mais recente.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 12.0.0.
  • Versão 3.6.0 do SDK da Moloco.

Versão 3.6.0.0

  • Compatibilidade verificada com a versão 3.6.0 do SDK da Moloco.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.13.0.
  • Versão 3.6.0 do SDK da Moloco.

Versão 3.5.0.0

  • Versão inicial.
  • Adicionamos suporte a lances para formatos de anúncio de banner (incluindo MREC), intersticial e premiado.
  • Compatibilidade verificada com o SDK da Moloco versão 3.5.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.13.0.
  • Versão 3.5.0 do SDK da Moloco.