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

Requisitos

• API Android nível 24 ou mais recente.

• Última GMA Next-Gen SDK.

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

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

Faça login na sua conta do myTarget. Clique em APPS no cabeçalho para acessar a página "Apps". Clique em ADICIONAR APP para adicionar seu app.

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

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

Na página de detalhes do bloco de anúncios, anote o ID do slot, que pode ser encontrado nas configurações do bloco como slot_id. Esse ID de slot será usado para configurar seu 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 do myTarget para configurar o ID do bloco de anúncios da AdMob. Navegue até a guia Perfil e selecione Tokens de acesso. Clique em Criar token ou Mostrar token para ver seu token de acesso permanente do 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 para myTarget, consulte Como criar e publicar um arquivo.

Ativar o modo de teste

Siga as instruções na documentação do myTarget para adicionar e configurar um dispositivo de teste na interface do 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 seu 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 o 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 automática de dados e insira o Token de acesso permanente obtido 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 obtido 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.

Adicionar o Mail.ru à 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 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 do myTarget

Integração com o Android Studio (recomendada)

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:mytarget:5.27.4.1")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:mytarget:5.27.4.1'
}

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 do myTarget, consulte a documentação do SDK do myTarget para Android.

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

Etapa 4: implementar configurações de privacidade no SDK do 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 atender aos requisitos de privacidade. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK do myTarget. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo GMA Next-Gen SDK.

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

MyTargetPrivacy.setUserConsent(true);

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, use o código a seguir para transmitir essas informações de consentimento ao SDK do myTarget.

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

MyTargetPrivacy.setUserAgeRestricted(true);

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

MyTargetPrivacy.setUserAgeRestricted(true)

Consulte o guia de Privacidade e GDPR do 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 que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

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

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

MyTargetPrivacy.setCcpaUserConsent(true);

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

MyTargetPrivacy.setCcpaUserConsent(true)

Entre em contato com o suporte do 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 do myTarget.

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

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 origens de anúncios myTarget (hierarquia).

Etapas opcionais

Como usar anúncios nativos

Renderização de anúncios

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

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

Rastreamento de impressões e cliques

O GMA Next-Gen SDK usa os callbacks do SDK do myTarget para rastreamento de impressões e cliques. Portanto, os relatórios das duas fontes 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 do myTarget quando um anúncio não é carregado: