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 a Mediação da AdMob, abrangendo integrações em hierarquia e de lances. Ele explica 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 aceitos

O adaptador de mediação da Mintegral 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 11.0 ou mais recente.

  • [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da Mintegral 7.5.3.0 ou uma versão mais recente (recomendamos usar a última versão).

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

  • Leia todo o guia para iniciantes da 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

Acesse a guia APP Setting e anote a APP Key.

Adicionar um novo aplicativo

Na guia Configuração do APP, clique no botão Adicionar APP.

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

Anote o ID do app do aplicativo.

Criar uma posição de anúncio

Depois que o aplicativo for criado, acesse a guia Posições e unidades e clique no botão Adicionar posição, conforme mostrado abaixo, para criar sua posição de anúncio.

Insira um Nome do canal 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 Em cascata como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.

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

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

Localizar sua chave da API Reporting da Mintegral

Lances

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

Cascata

Você vai precisar da chave de API de relatórios da Mintegral para configurar o ID do bloco de anúncios da AdMob. Acesse Conta > Ferramentas de API. Anote a Skey e a Secret.

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.

Para implementar o app-ads.txt na Mintegral, consulte Como o app-ads.txt pode ajudar a combater a fraude publicitária.

Etapa 2: configurar a demanda da Mintegral na interface da AdMob

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

Adicione a Mintegral à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a Mintegral como uma origem de anúncios.

Para criar um grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a Mintegral como uma origem de anúncios

Lances

No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Mintegral.

Clique em Como assinar um contrato de parceria e configure uma parceria de lances com a Mintegral.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para a Mintegral, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, 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. Em seguida, clique em Concluído.



Cascata


No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione Mintegral. Em seguida, insira um valor de eCPM para a Mintegral e clique em Continuar.



Se você já tiver um mapeamento para a Mintegral, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, 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. Em seguida, clique em Concluído.


Adicionar a Mobvista/Mintegral à 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 Mobvista/Mintegral à lista de parceiros de publicidade das regulamentações europeias e 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 da 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 usando o link de download no Changelog e vincule MintegralAdapter.xcframework no seu projeto.

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

Para cumprir a Política de consentimento de usuários da UE 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 outros armazenamentos locais quando 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úncios 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 Mintegral inclui o método setConsentStatus para transmitir informações de consentimento ao SDK da Mintegral.

O exemplo de código a seguir 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 e assim garantir que elas sejam encaminhadas corretamente ao 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 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 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 Mintegral inclui o método setDoNotTrackStatus para transmitir informações de consentimento ao SDK da Mintegral.

O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Mintegral. Se for necessário 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 ao 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 na AdMob.

Para receber anúncios de teste da Mintegral em banners, intersticiais, anúncios premiados e nativos, a Mintegral recomenda usar as chaves de app, os IDs de app, os IDs de posição e os IDs de bloco de anúncios fornecidos na página de IDs 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 (lances) e Mintegral (hierarquia).

Etapas opcionais

Adicionar a Mintegral à lista de parceiros de publicidade da CCPA

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

Anúncios nativos

Renderização de anúncios

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

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

1 O adaptador da Mintegral não fornece 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, verifique o erro na resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMediationAdapterMintegral

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

Código do erro Domínio Motivo
101 com.google.mediation.mintegral Parâmetros de 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 mostrou um anúncio.
104 com.google.mediation.mintegral O tamanho de 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 da Mintegral para iOS

Próxima versão

  • A verificação de tamanho foi removida do adaptador para anúncios de banner de RTB.

Versão 7.7.9.0

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

Criado e testado com:

  • Versão 12.8.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.7.9 do SDK da Mintegral.

Versão 7.7.8.0

  • Adição de suporte à COPPA. Agora, o adaptador encaminha a flag GADRequestConfiguration.tagForChildDirectedTreatment para o SDK da Mintegral.
  • Compatibilidade verificada com a versão 7.7.8 do SDK da Mintegral.

Criado e testado com:

  • Versão 12.4.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.7.8 do SDK da Mintegral.

Versão 7.7.7.0

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

Criado e testado com:

  • Versão 12.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.7.7 do SDK da Mintegral.

Versão 7.7.6.0

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

Criado e testado com:

  • Versão 12.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.7.6 do SDK da Mintegral.

Versão 7.7.5.1

  • Agora requer a versão 12.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • Versão 12.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.7.5 do SDK da Mintegral.

Versão 7.7.5.0

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

Criado e testado com:

  • Versão 11.13.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.7.5 do SDK da Mintegral.

Versão 7.7.4.0

  • Compatibilidade verificada com a versão 7.7.4 do SDK da Mintegral.
  • Atualizamos o adaptador para seguir as práticas recomendadas de Objective-C do Google.

Criado e testado com:

  • Versão 11.13.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.7.4 do SDK da Mintegral.

Versão 7.7.3.0

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

Criado e testado com:

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

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 mostrados.
  • Atualizamos o CFBundleShortVersionString para ter três componentes em vez de quatro.

Criado e testado com:

  • Versão 11.10.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.7.2 do SDK da Mintegral.

Versão 7.7.2.0

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

Criado e testado com:

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

Versão 7.7.1.0

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

Criado e testado com:

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

Versão 7.7.0.0

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

Criado e testado com:

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

Versão 7.6.9.0

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

Criado e testado com:

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

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

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

Versão 7.6.6.0

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

Criado e testado com:

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

Versão 7.6.4.0

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

Criado e testado com:

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

Versão 7.6.3.0

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

Criado e testado com:

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

Versão 7.6.2.0

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

Criado e testado com:

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

Versão 7.6.1.0

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

Criado e testado com:

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

Versão 7.6.0.0

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

Criado e testado com:

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

Versão 7.5.9.0

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

Criado e testado com:

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

Versão 7.5.8.0

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

Criado e testado com:

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

Versão 7.5.7.0

  • Compatibilidade verificada com a versão 7.5.7 do SDK da Mintegral.
  • Agora requer a versão mínima do iOS 12.0.
  • Agora requer a versão 11.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
  • Incluído Info.plist nas estruturas em MintegralAdapter.xcframework.

Criado e testado com:

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

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:

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

Versão 7.5.3.0

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

Criado e testado com:

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

Versão 7.4.8.0

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

Criado e testado com:

  • Versão 10.13.0 do SDK dos anúncios para dispositivos móveis do Google.
  • 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.
  • Adicionamos suporte à hierarquia para o formato de anúncio de abrir app.

Criado e testado com:

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

Versão 7.4.4.0

  • Adicionamos suporte a marcas-d'água para anúncios de lances.
  • Compatibilidade verificada com a versão 7.4.4 do SDK da Mintegral.

Criado e testado com:

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

Versão 7.4.3.0

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

Criado e testado com:

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

Versão 7.4.1.0

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

Criado e testado com:

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

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

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

Versão 7.3.7.0

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

Criado e testado com:

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

Versão 7.3.6.0

  • Compatibilidade verificada com a versão 7.3.6 do SDK da Mintegral.
  • O suporte à arquitetura armv7 foi removido.
  • Agora requer a versão mínima do iOS 11.0.
  • Agora requer a versão 10.4.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

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

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

Versão 7.3.3.0

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

Criado e testado com:

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

Versão 7.3.0.0

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

Criado e testado com:

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

Versão 7.2.9.1

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

Criado e testado com:

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

Versão 7.2.9.0

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

Criado e testado com:

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

Versão 7.2.8.0

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

Criado e testado com:

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

Versão 7.2.6.0

  • Versão inicial.
  • Adicionamos 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 a versão 9.8.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • Versão 9.13.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 7.2.6 do SDK da Mintegral.