Integrar a AppLovin 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 AppLovin usando a mediação, incluindo as integrações de lances e em hierarquia. Ele explica como adicionar a AppLovin à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da AppLovin a um app Flutter.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para a AppLovin tem os seguintes recursos:

¹ A cascata só é compatível com tamanhos de banner 320 x 50 e 728 x 90. Os lances não são compatíveis com anúncios de banner.

Requisitos

• SDK dos anúncios para dispositivos móveis do Google mais recente
• Flutter 3.7.0 ou versão mais recente
• Para implantar no Android:
  • API Android nível 23 ou mais recente.
• Para implantar no iOS:
  • Destino de implantação do iOS 12.0 ou mais recente.
• Um projeto do Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
• Leia todo o guia para iniciantes da mediação.

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

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

Para configurar seu bloco de anúncios do Ad Manager, você vai precisar da chave do SDK e da chave de relatório da AppLovin. Para encontrá-los, acesse a interface da AppLovin > Conta > Chaves para conferir os dois valores.

Se você planeja apenas integrar os lances, siga para configurar as definições de mediação.

Selecione o app para mediação

Criar uma zona

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, crie um arquivo app-ads.txt para o Ad Manager.

Para implementar o app-ads.txt na AppLovin, adicione a AppLovin ao seu arquivo app-ads.txt.

Ativar o modo de teste

Siga as instruções no guia do Modo de teste do MAX da AppLovin para saber como ativar os anúncios de teste da plataforma.

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

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

Adicionar a AppLovin Corp. à 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 Applovin Corp. à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

Etapa 3: importar o SDK e o adaptador da AppLovin

Integração pelo pub.dev

Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da Applovin ao arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_applovin: ^

Integração manual

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para Applovin, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

Consentimento para a UE e o GDPR

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

Se você não estiver usando uma CMP que grava a string de consentimento nas preferências compartilhadas, use os métodos GmaMediationApplovin.setHasUserConsent() e GmaMediationApplovin.setIsAgeRestrictedUser(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da AppLovin. 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 ao SDK da AppLovin.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

Consulte as configurações de privacidade da AppLovin 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 plug-in de mediação dos anúncios para dispositivos móveis do Google para AppLovin inclui o método GmaMediationApplovin.setDoNotSell(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da AppLovin. 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 AppLovin.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

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

Etapa 5: adicionar o código necessário

Etapa 6: testar a implementação

Ativar anúncios de teste

Não se esqueça de registrar seu dispositivo de teste no Ad Manager e ativar o modo de teste na interface da Applovin.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da Applovin, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Applovin (lances) e Applovin (hierarquia).

Etapas opcionais

Parâmetros específicos da rede

O adaptador da AppLovin permite transmitir um objeto AppLovinMediationExtras à solicitação de anúncio para definir parâmetros específicos da rede. O exemplo de código a seguir mostra como desativar o áudio em anúncios em vídeo usando o parâmetro isMuted:

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

Otimizações

Adicionar uma chamada a GmaMediationApplovin.initializeSdk('sdkKey') na sua atividade de inicialização permite que a AppLovin rastreie eventos assim que o app é iniciado.

Códigos de erro

Se o adaptador não receber um anúncio da AppLovin, os editores poderão verificar o erro na resposta do anúncio usando ResponseInfo nas seguintes classes:

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Registro de alterações do adaptador de mediação do Flutter da AppLovin

Versão 2.3.2

• Compatibilidade com a versão 13.3.1.1 do adaptador do Android da AppLovin.
• Compatível com a versão 13.3.1.0 do adaptador iOS da AppLovin.

• Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 2.3.1

• Compatível com a versão 13.3.1.0 do adaptador do Android da AppLovin.
• Compatível com a versão 13.3.1.0 do adaptador iOS da AppLovin.

• Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 2.3.0

• Compatibilidade com a versão 13.3.0.0 do adaptador do Android da AppLovin.
• Compatível com a versão 13.3.0.0 do adaptador iOS da AppLovin.

• Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 2.2.1

• Compatível com a versão 13.2.0.1 do adaptador do Android da AppLovin.
• Compatível com o adaptador iOS da AppLovin versão 13.2.0.0.

• Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 2.2.0

• Compatível com a versão 13.2.0.0 do adaptador Android da AppLovin.
• Compatível com o adaptador iOS da AppLovin versão 13.2.0.0.

• Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 2.1.0

• Compatibilidade com a versão 13.1.0.0 do adaptador do Android da AppLovin.
• Compatível com o adaptador iOS da AppLovin versão 13.1.0.0.

• Criado e testado com a versão 5.3.1 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 2.0.0

• Compatível com a versão 13.0.1.0 do adaptador do Android da AppLovin.
• Compatível com o adaptador iOS da AppLovin versão 13.0.1.0.

• Criado e testado com a versão 5.3.1 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 1.2.0

• Suporte à versão 12.6.1.0 do adaptador do Android da AppLovin.
• Compatível com a versão 12.6.1.0 do adaptador do iOS da AppLovin.

• Criado e testado com a versão 5.1.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 1.1.0

• A API para GmaMediationApplovin não é mais estática.
• Suporte à versão 12.4.3.0 do adaptador Android da AppLovin.
• Compatível com a versão 12.4.2.0 do adaptador iOS da AppLovin.

• Criado e testado com a versão 5.1.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 1.0.0

• Versão inicial.

• Compatível com a versão 12.3.0.0 do adaptador Android da AppLovin.
• Compatível com a versão 12.2.1.0 do adaptador do iOS da AppLovin.

• Criado e testado com a versão 5.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.