Integrar a Mintegral 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 Mintegral usando Mediação da AdMob, cobrindo integrações de hierarquia e 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 appiOS .

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

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

Integração
Lances
Cascata
Formatos
Abertura do aplicativo  1
Banner
Intersticial
Premiado
Intersticial premiado
Nativo  2
1 As integrações de lances e hierarquia para o formato de anúncio de abertura do app estão na versão Beta fechada.

2 As integrações de lances e hierarquia para o formato de anúncio nativo estão na versão Beta aberta.

Requisitos

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

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

  • Concluir o Guia explicativo de mediação

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

Inscreva-se ou faça login na sua conta da Mintegral.

Localizar a chave do app

Navegue até a guia Configurações de app e observe a chave de 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 da posição e um Formato do anúncio.

Lances

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

Cascata

Selecione Tradicional 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 da AdMob. Navegue até Account > API Tools. Anote a chave S e a chave secreta.

Etapa 2: configurar a demanda da Mintegral na AdMob interface

Adicionar Mintegral ao GDPR e à lista de parceiros de publicidade 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 da AdMob.

Etapa 3: importar o SDK e o adaptador da Mintegral

  • Adicione a seguinte linha ao Podfile do seu 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 do 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 da Mintegral no link de download no Changelog e no link MintegralAdapter.xcframework do 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

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 lei define esses termos), com a opção de recusa oferecida 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 da Mintegral inclui o método setDoNotTrackStatus para transmitir informações de consentimento ao SDK da 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, chame-o 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 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 obrigatório

Integração com a 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 na AdMob.

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 Mintegral à lista de parceiros de publicidade da CCPA na AdMob UI.

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 a 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 a versão 7.7.1 do SDK da Mintegral.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.8.0.
  • Versão do SDK da Mintegral 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 da Mintegral.

Criado e testado com:

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

Versão 7.6.8.0

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

Criado e testado com:

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

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 a versão 7.5.8 do SDK da Mintegral.

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 exige 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.
  • Inclusão de 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.
  • A GADMediationAdapterMintegral.h agora é 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.
  • Versão 7.4.8 do SDK da Mintegral.

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

  • Adição de compatibilidade com marca d'água para 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 a versão 7.4.1 do SDK da Mintegral.

Criado e testado com:

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

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.
  • Versão 7.3.9 do SDK da Mintegral.

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.
  • Versão 7.3.8 do SDK da Mintegral.

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.
  • Remoção da compatibilidade com a arquitetura armv7.
  • 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.
  • Versão 7.3.6 do SDK da Mintegral.

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 da 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 a versão 7.3.0 do SDK da Mintegral.

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.
  • Versão 7.2.9 do SDK da Mintegral.

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.
  • Foi adicionada compatibilidade com lances para os formatos de banner (inclui MREC), intersticial, premiado e nativo.
  • Compatibilidade verificada com a versão 7.2.6 do SDK da Mintegral.
  • Requer 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.13.0.
  • SDK Mintegral versão 7.2.6.