Integrar o myTarget com a Mediação

Selecione a plataforma: Android (Beta) Android iOS Unity Flutter

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da myTarget usando mediação, incluindo integrações em hierarquia. Ele explica como adicionar a myTarget à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da myTarget a um app Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da myTarget tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

• API Android nível da API 24 ou mais recente.

• Mais recente GMA Next-Gen SDK.

• Leia todo o guia para iniciantes da mediação .

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

Faça login na sua conta da myTarget. Acesse a página "Apps" clicando em APPS no cabeçalho. Adicione seu app clicando em ADICIONAR APP.

Em seguida, forneça o URL do Google Play do seu app.

Ao adicionar um app, a myTarget exige que você crie um bloco de anúncios antes de concluir o processo.

Observação: Para adicionar um bloco de anúncios a um app, abra a página de detalhes do app clicando no nome dele e clique em CRIAR BLOOCO DE ANÚNCIOS.

Banner

Selecione BANNER nos formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Intersticial

Selecione INTERSTITIAL nos formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Premiado

Selecione VÍDEO PREMIADO nos formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Nativo

Selecione NATIVO nos formatos de anúncio disponíveis e clique em ADICIONAR BLOCO DE ANÚNCIOS.

Na página de detalhes do bloco de anúncios, anote o ID do slot, que pode ser encontrado nas configurações do bloco de anúncios como slot_id. Esse ID do slot será usado para configurar o bloco de anúncios do Ad Manager na próxima seção.

Além do slot_id, você também vai precisar do token de acesso permanente da myTarget para configurar o ID do bloco de anúncios da AdMob. Acesse a guia Perfil e selecione Tokens de acesso. Clique em Criar token ou Mostrar token para conferir seu token de acesso permanente da myTarget.

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 app-ads.txt na myTarget, consulte Como criar e publicar um arquivo.

Ativar o modo de teste

Siga as instruções na documentação da myTarget para adicionar e configurar um dispositivo de teste na interface da myTarget.

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

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

Faça login na sua conta do Ad Manager.

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento.

Insira um nome exclusivo para o grupo de rendimento, defina o status como Ativo, selecione o formato do anúncio e defina o tipo de inventário como App para dispositivos móveis. Na seção Segmentação > Inventário , selecione o bloco de anúncios em Inventário e Aplicativo para dispositivos móveis a que você quer adicionar a mediação.

Em seguida, clique no botão Adicionar parceiro de rendimento.

Se você já tiver um parceiro de rendimento para a myTarget, selecione-o. Caso contrário, selecione Criar um novo parceiro de rendimento.

Selecione myTarget como a rede de publicidade, insira um nome exclusivo e ative a mediação.

Ative a coleta de dados automática e insira o token de acesso permanente recebido na seção anterior.

Depois que o parceiro de rendimento for selecionado, escolha Mediação de SDK para dispositivos móveis como o tipo de integração, Android como a plataforma, e Ativo como o status. Insira o ID do slot recebido na seção anterior. Em seguida, insira um valor de CPM padrão.

Clique em Salvar na parte de baixo da página quando terminar.

Observação: a coleta de dados automática leva alguns dias para reunir os dados antes de calcular com precisão um valor de CPM dinâmico para uma rede de mediação. Depois que o eCPM for calculado, ele será atualizado automaticamente em seu nome.

Adicionar a Mail.ru à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Importante: verifique se você tem permissão de gerenciamento da conta para concluir a configuração do consentimento da UE e do GDPR, das regulamentações estaduais dos EUA e da plataforma de mensagens de usuários. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a Mail.ru à 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 myTarget

Observação: a falha na integração das versões compatíveis do SDK da myTarget e do GMA Next-Gen SDK pode causar problemas de build.

Integração com o Android Studio (recomendada)

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mytarget:5.45.3.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mytarget:5.45.3.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

• Para incluir o SDK da myTarget, consulte a documentação do SDK do Android da myTarget.

• Navegue até os artefatos do adaptador da myTarget no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador da myTarget e adicione-o ao projeto.

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

Consentimento para a UE e o GDPR

Para cumprir a Política de consentimento de usuários da União Europeia 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.

Na versão 5.1.0 do SDK, a myTarget adicionou uma API de consentimento do usuário para oferecer suporte às normas de privacidade. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK da myTarget. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo GMA Next-Gen SDK.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

Além disso, se o usuário estiver em uma categoria com restrição de idade, você poderá usar o código a seguir para transmitir essas informações de consentimento para o SDK da myTarget.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

Consulte o guia de privacidade e GDPR da myTarget para mais informações e os valores que podem ser fornecidos no método.

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 de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma dessas redes para garantir a conformidade.

Na versão 5.9.0 do SDK, a myTarget adicionou uma API de consentimento do usuário para oferecer suporte às normas de privacidade. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK da myTarget. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo GMA Next-Gen SDK.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

Entre em contato com o suporte da myTarget para mais informações e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código necessário

Nenhum código adicional é necessário para a integração da myTarget.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager e ative o modo de teste na interface da myTarget.

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

Verificar anúncios de teste

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

Etapas opcionais

Como usar anúncios nativos

Renderização do anúncio

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

Campo	Preenchido pelo adaptador da myTarget
Título	Sempre
Imagem	Sempre
Corpo	Sempre
Ícone do app	Sempre
Call-to-action	Sempre
Classificação por estrela	Não garantido
Repositório	Não garantido
Preço	Não garantido
Logotipo	Não garantido
Advertiser	Sempre

O SDK da myTarget sempre retorna 0 para a largura e a altura de mediaView. Portanto, o adaptador da myTarget sempre retorna 0 para getAspectRatio(). O SDK da myTarget vai corrigir esse problema em uma versão futura.

Rastreamento de impressões e cliques

GMA Next-Gen SDK usa os callbacks do SDK da myTarget para rastreamento de impressões e cliques. Portanto, os relatórios de ambas as origens devem corresponder com poucas ou nenhuma discrepância.

Códigos de erro

Se o adaptador não receber um anúncio da myTarget, verifique o erro subjacente na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

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

Código do erro	Motivo
100	O SDK da myTarget retornou um erro.
101	Os parâmetros do servidor da myTarget configurados na interface do Ad Manager estão ausentes ou são inválidos.
102	O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a myTarget.
103	A solicitação de anúncio não é uma solicitação de anúncio nativo unificado.
104	O anúncio nativo carregado da myTarget é diferente do anúncio nativo solicitado.
105	O anúncio nativo carregado da myTarget não tem alguns recursos obrigatórios (por exemplo, imagem ou ícone).