Esta página foi traduzida pela API Cloud Translation.

Integrar a Mintegral aos lances (Beta)

Neste guia, mostramos como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da Mintegral usando mediação, abrangendo 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
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
Leia 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 de app

Navegue até a guia Configuração do app e anote a chave do app.

Adicionar um novo aplicativo

Na guia APP Settings, 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 seu aplicativo for criado, acesse a guia Canais e blocos 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ê 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 Ad Manager interface

Adicionar Mintegral à lista de parceiros de publicidade do GDPR e dos regulamentos 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

Usando o CocoaPods (recomendado)

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

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 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 for necessário chamar esse método, chame-oantes 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 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 publicidade 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 da Mintegral não fornece acesso direto ao recurso de imagem principal para os 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 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 Mintegral para iOS

Versão 7.7.3.0

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

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

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

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 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.
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:

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 a versão 7.6.2 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.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.
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 é 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 da 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

O arquivo podspec foi atualizado 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 da 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 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.
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.
A compatibilidade com a arquitetura armv7 foi removida.
Agora exige 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.
Versão 7.3.4 do SDK da Mintegral.

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