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

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

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

Integração
Lances  1
Cascata  2
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo
1 A integração de lances está na Beta fechada (exceto para o formato de anúncio nativo na Beta aberta).

2 A integração em hierarquia está na versão Beta fechada.

Requisitos

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

  • [Para lances]: para integrar todos os formatos de anúncio com suporte nos lances, use o adaptador Mintegral 7.5.3.0 ou mais recente (recomendamos a versão mais recente)

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

  • Concluir o Guia para iniciantes de mediação

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

Crie ou faça login na sua conta da Mintegral.

Localizar a chave do app

Acesse a guia Configuração do app e anote a chave do app.

Adicionar um novo aplicativo

Na guia APP Setting, clique no botão Add APP.

Selecione a Plataforma e preencha o restante do formulário. Em seguida, clique em Salvar.

Anote o ID do app.

Criar uma posição de anúncio

Depois que a aplicação for criada, navegue até a guia Posicionamentos e unidades e clique no botão Adicionar posicionamento, conforme mostrado abaixo, para criar o posicionamento do anúncio.

Insira um nome do canal e um formato de anúncio.

Selecione Lances de cabeçalho como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.

Depois que a posição do anúncio for criada, anote o ID da posição.

Clique no menu suspenso 1 Blocos de anúncios e anote o ID do bloco de anúncios.

Localizar sua chave da API Mintegral Reporting

Lances

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

Cascata

Você vai precisar da chave da API Mintegral Reporting para configurar o ID do bloco de anúncios do Ad Manager. Navegue até Account > API Tools. Anote a chave S e a chave secreta.

Etapa 2: configurar a demanda da Mintegral na interface do Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar a Mintegral nas empresas

Lances

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

Cascata

Acesse Administrador > Empresas e clique no botão Nova empresa na guia Todas as empresas. Selecione Rede de publicidade.

Selecione Mintegral como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.

Não é necessário inserir um Nome de usuário ou uma Senha. Clique em Salvar quando terminar.

Ativar o compartilhamento de indicador seguro

Lances

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

Cascata

Esta etapa não é necessária para integrações em hierarquia.

Configurar lances da Mintegral

Lances

Navegue até Exibição > Bidders e clique em Novo bidder na guia Lances do SDK.

Selecione Mintegral como o bidder.

Ative Adicionar a biblioteca de indicadores deste bidder à lista de indicadores permitidos e Permitir que os indicadores sejam compartilhados com este bidder. Em seguida, clique em Continuar.

Clique em Continuar.

Clique em Concluído.

Cascata

Esta etapa não é necessária para integrações em hierarquia.

Configurar o mapeamento de blocos de anúncios

Lances

Navegue até Envio > Bidders e selecione a empresa para Mintegral na guia Lances do SDK.

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

Escolha Bloco de anúncios específico. Selecione um bloco de anúncios e formato, 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, o ID do app, o ID da posição e o ID do bloco de anúncios que você recebeu na seção anterior. Por fim, clique em Salvar.

Cascata

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento. Selecione o aplicativo para dispositivos móveis.

Role a tela para baixo e clique em Adicionar parceiro de rendimento.

Selecione a empresa que você criou para Mintegral na seção anterior. Escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, iOS como a Plataforma e Ativo como o Status.

Insira a chave do app, o ID do app, o ID da posição e o ID do bloco de anúncios obtidos na seção anterior e o valor do CPM padrão. Clique em Salvar.

Adicionar Mobvista/Mintegral à 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 a Mobvista/Mintegral à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA na interface do Ad Manager.

Etapa 3: importar o SDK e o adaptador da Mintegral

  • Adicione a seguinte linha ao Podfile do projeto:

    pod 'GoogleMobileAdsMediationMintegral'

  • Na linha de comando, execute:

    pod install --repo-update

Integração manual

  • Faça o download da versão mais recente do SDK Mintegral para iOS e vincule todos os arquivos e pacotes .framework no seu projeto.
  • Faça o download da versão mais recente do adaptador Mintegral no link de download no Changelog e conecte MintegralAdapter.xcframework no seu projeto.

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

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.

O SDK Mintegral inclui o método setConsentStatus para transmitir informações de consentimento ao SDK Mintegral.

O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK da Mintegral. Essas opções precisam ser definidas antes de você inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK da Mintegral.

Swift 

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

Objective-C 

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setConsentStatus:YES];

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

Leis Estaduais de Privacidade dos EUA

As 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 na lei). Essa opção é disponibilizada por um link "Não vender minhas informações pessoais" 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.

O SDK Mintegral inclui o método setDoNotTrackStatus para transmitir informações de consentimento ao SDK Mintegral.

O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK da Mintegral. Se você precisar chamar esse método, faça isso antes de inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que eles sejam encaminhados corretamente para o SDK da Mintegral.

Swift 

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

Objective-C 

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

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

Etapa 5: adicionar o código necessário

Integração da SKAdNetwork

Siga a documentação da Mintegral 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 no Ad Manager.

Para receber anúncios de teste da Mintegral para formatos de anúncios de banner, intersticiais, premiados e nativos, a Mintegral recomenda usar as chaves de app, IDs de app, IDs de posicionamento e IDs de bloco de anúncios fornecidos na página de ID de teste da Mintegral.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da Mintegral, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Mintegral (Mediação) e Mintegral (Hierarquia).

Etapas opcionais

Adicionar a Mintegral à lista de parceiros de anúncios da CCPA

Siga as etapas em Configurações da CCPA para adicionar a Mintegral à lista de parceiros de publicidade da CCPA na interface do Ad Manager.

Anúncios nativos

Renderização do anúncio

O adaptador Mintegral retorna os anúncios nativos como objetos GADNativeAd. Ele preenche os seguintes campos para um GADNativeAd.

Campo Recursos sempre incluídos pelo adaptador Mintegral
Título
Imagem 1
Corpo
Ícone
Call-to-action
Star rating
Loja
Preço
Advertiser

1 O adaptador Mintegral não oferece acesso direto ao recurso de imagem principal dos anúncios nativos. Em vez disso, o adaptador preenche o GADMediaView com um vídeo ou uma imagem.

Códigos de erro

Se o adaptador não receber um anúncio da Mintegral, você poderá verificar o erro subjacente da resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMediationAdapterMintegral

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

Código do erro Domínio Motivo
101 com.google.mediation.mintegral Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição ausente).
102 com.google.mediation.mintegral O SDK da Mintegral retornou um erro de não preenchimento.
103 com.google.mediation.mintegral O SDK da Mintegral não conseguiu mostrar um anúncio.
104 com.google.mediation.mintegral O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Mintegral.

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

Versão 7.7.3.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.7.3.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.10.0.
  • SDK Mintegral versão 7.7.3.

Versão 7.7.2.1

  • O adaptador não verifica mais se os anúncios intersticiais e premiados estão prontos antes de serem exibidos.
  • 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 Mintegral versão 7.7.2.

Versão 7.7.2.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.7.2.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.9.0.
  • SDK Mintegral versão 7.7.2.

Versão 7.7.1.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.7.1.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.8.0.
  • SDK Mintegral versão 7.7.1.

Versão 7.7.0.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.7.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.8.0.
  • SDK Mintegral versão 7.7.0.

Versão 7.6.9.0

  • Compatibilidade verificada com a versão 7.6.9 do SDK Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.7.0.
  • SDK do Mintegral versão 7.6.9.

Versão 7.6.8.0

  • Compatibilidade verificada com a versão 7.6.8 do SDK Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.7.0.
  • SDK da Mintegral versão 7.6.8.

Versão 7.6.7.0

  • Compatibilidade verificada com a versão 7.6.7 do SDK da Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.6.0.
  • SDK Mintegral versão 7.6.7.

Versão 7.6.6.0

  • Compatibilidade verificada com a versão 7.6.6 do SDK da Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.5.0.
  • SDK Mintegral versão 7.6.6.

Versão 7.6.4.0

  • Compatibilidade verificada com a versão 7.6.4 do SDK Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.4.0.
  • SDK do Mintegral versão 7.6.4.

Versão 7.6.3.0

  • Compatibilidade verificada com a versão 7.6.3 do SDK da Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.3.0.
  • SDK Mintegral versão 7.6.3.

Versão 7.6.2.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.6.2.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.3.0.
  • SDK Mintegral versão 7.6.2.

Versão 7.6.1.0

  • Compatibilidade verificada com a versão 7.6.1 do SDK da Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.3.0.
  • SDK Mintegral versão 7.6.1.

Versão 7.6.0.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.6.0.

Criado e testado com:

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

Versão 7.5.9.0

  • Compatibilidade verificada com a versão 7.5.9 do SDK da Mintegral.

Criado e testado com:

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

Versão 7.5.8.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.5.8.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.1.0.
  • SDK Mintegral versão 7.5.8.

Versão 7.5.7.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.5.7.
  • 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 MintegralAdapter.xcframework.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.0.1.
  • SDK Mintegral versão 7.5.7.

Versão 7.5.6.0

  • Compatibilidade verificada com a versão 7.5.6 do SDK da Mintegral.
  • O GADMediationAdapterMintegral.h foi transformado em um cabeçalho público.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.0.0.
  • SDK Mintegral versão 7.5.6.

Versão 7.5.3.0

  • Compatibilidade verificada com a versão 7.5.3 do SDK da Mintegral.
  • Adição de suporte a lances para o formato de anúncio de abertura de app.

Criado e testado com:

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

Versão 7.4.8.0

  • Compatibilidade verificada com a versão 7.4.8 do SDK Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.13.0.
  • SDK Mintegral versão 7.4.8.

Versão 7.4.7.0

  • Atualização do arquivo podspec para depender de MintegralAdSDK/All em vez de MintegralAdSDK.
  • Compatibilidade verificada com a versão 7.4.7 do SDK da Mintegral.
  • Adição de suporte à hierarquia para o formato de anúncio de abertura de app.

Criado e testado com:

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

Versão 7.4.4.0

  • Suporte adicionado para marca d'água em anúncios de lances.
  • Compatibilidade verificada com a versão 7.4.4 do SDK Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.10.0.
  • SDK Mintegral versão 7.4.4.

Versão 7.4.3.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.4.3.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.9.0.
  • SDK Mintegral versão 7.4.3.

Versão 7.4.1.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.4.1.

Criado e testado com:

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

Versão 7.3.9.0

  • Compatibilidade verificada com a versão 7.3.9 do SDK da Mintegral.

Criado e testado com:

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

Versão 7.3.8.0

  • Compatibilidade verificada com a versão 7.3.8 do SDK da Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.6.0.
  • SDK Mintegral versão 7.3.8.

Versão 7.3.7.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.3.7.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.5.0.
  • SDK Mintegral versão 7.3.7.

Versão 7.3.6.0

  • Compatibilidade verificada com a versão 7.3.6 do SDK da Mintegral.
  • A compatibilidade com a arquitetura armv7 foi removida.
  • 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.5.0.
  • SDK Mintegral versão 7.3.6.

Versão 7.3.4.0

  • Compatibilidade verificada com a versão 7.3.4 do SDK da Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.2.0.
  • SDK do Mintegral versão 7.3.4.

Versão 7.3.3.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.3.3.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.2.0.
  • SDK Mintegral versão 7.3.3.

Versão 7.3.0.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.3.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.1.0.
  • SDK Mintegral versão 7.3.0.

Versão 7.2.9.1

  • Adição de suporte à hierarquia para formatos de anúncio de banner (incluindo MREC), intersticial, premiado e nativo.
  • Requer o SDK dos anúncios para dispositivos móveis do Google versão 10.0.0 ou mais recente.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.0.0.
  • SDK Mintegral versão 7.2.9.

Versão 7.2.9.0

  • Compatibilidade verificada com a versão 7.2.9 do SDK da Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 9.14.0.
  • SDK Mintegral versão 7.2.9.

Versão 7.2.8.0

  • Compatibilidade verificada com o SDK Mintegral versão 7.2.8.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 9.14.0.
  • SDK Mintegral versão 7.2.8.

Versão 7.2.6.0

  • Versão inicial.
  • Adicionado suporte a lances para formatos de anúncio de banner (incluindo MREC), intersticial, premiado e nativo.
  • Compatibilidade verificada com a versão 7.2.6 do SDK da Mintegral.
  • Requer 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.13.0.
  • SDK Mintegral versão 7.2.6.