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 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	^1
Cascata	^2
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

¹ A integração de lances está na Beta fechada (exceto para o formato de anúncio nativo na Beta aberta).

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

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: configurar as configurações na interface da Mintegral

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

Localizar a chave do app

Navegue até 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.

Importante: para o formato de anúncio nativo, selecione Nativo (Renderização personalizada) como Formato do 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 Ad Manager interface

Faça login na sua conta do Ad Manager.

Adicionar Mintegral em 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 Mintegral lances

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

Acesse 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 o App Key, App ID, Placement ID, and Ad Unit ID recebido na seção anterior. Por fim, clique em Salvar.

Importante: segmente o bloco de anúncios selecionado por pelo menos um grupo de rendimento. O App ID and App Key precisa ser associado ao app segmentado, como na interfaceMintegral .

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 o App Key, App ID, Placement ID, and Ad Unit ID recebido na seção anterior e o valor de CPM padrão. Clique em Salvar.

Importante: o App ID and App Key precisa ser associado ao app de destino, como na interfaceMintegral .

Adicionar Mintegral à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Importante: verifique se você tem a permissão Gerenciamento de conta para concluir a configuração do consentimento para usuários da UE e do GDPR, da CPRA e da plataforma de mensagens do usuário. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

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

Observação: a falha na integração das versões compatíveis do Mintegral e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

Usando o CocoaPods (recomendado)

• 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 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

Consentimento da UE e GDPR

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, 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 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 do app, IDs do app, IDs de posicionamento e IDs de bloco de anúncios fornecidos na página de ID de teste da Mintegral.

Importante: desative o modo de teste do Ad Manager e do Mintegral antes de lançar o app.

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 Ad Manager 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

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

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.