Integrar o myTarget com a Mediação

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

Este guia mostra como usar o Google Mobile Ads Unity Plugin 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 Unity.

Integrações e formatos de anúncio aceitos

Integração
Lances
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • Unity Editor versão 2019.4 ou mais recente.
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 13.0 ou mais recente.
  • Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar o Google Mobile Ads Unity Plugin para mais detalhes.
  • Configure a mediação.

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

    Faça login na sua conta do myTarget. Acesse a página "Apps" clicando em APPS no cabeçalho. Clique em ADICIONAR APP.

    Se o app for compatível com as plataformas Android e iOS, configure cada uma delas separadamente.

    Android

    Em seguida, informe o URL do Google Play do seu app.

    iOS

    Em seguida, forneça o URL do iTunes** do seu app.

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

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

    Intersticial

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

    Premiado

    Selecione VÍDEO PREMIADO entre os 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 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. Acesse a guia Perfil e selecione Tokens de acesso. Clique em Create Token ou Show 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 a 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

    Android

    Para ver as instruções, consulte a etapa 2 no guia para Android.

    iOS

    Para instruções, consulte a etapa 2 no guia para iOS.

    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

    OpenUPM-CLI

    Se a OpenUPM-CLI estiver instalada, você poderá instalar o plug-in de mediação da myTarget dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

    openupm add com.google.ads.mobile.mediation.mytarget

    OpenUPM

    No editor do projeto do Unity, selecione Edit > Configurações do projeto > Package Manager para abrir as Configurações do gerenciador de pacotes do Unity.

    Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

    • Nome: OpenUPM
    • URL: https://package.openupm.com
    • Escopos: com.google

    Detalhes do OpenUPM

    Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

    Registros do Unity

    Selecione o pacote Google Mobile Ads MyTarget Mediation e clique em Install.

    Instalar pelo OpenUPM

    Pacote do Unity

    Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para myTarget no link de download do Registro de alterações e extraia o GoogleMobileAdsMyTargetMediation.unitypackage do arquivo ZIP.

    No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsMyTargetMediation.unitypackage que você salvou. Verifique se todos os arquivos estão selecionados e clique em Importar.

    Importar do Unity

    Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Forçar resolução. A biblioteca do Gerenciador de Dependências Externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

    Forçar resolução

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

    Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar 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 plug-in de mediação dos anúncios para dispositivos móveis do Google para a versão 2.1.0 do myTarget inclui os métodos SetUserConsent() e SetUserAgeRestricted(). O exemplo de código a seguir mostra como transmitir informações de consentimento do usuário para o SDK da myTarget. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo Google Mobile Ads Unity Plugin.

    using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

    Se o usuário estiver em uma categoria restrita de idade, você também poderá chamar o método SetUserAgeRestricted().

    MyTarget.SetUserAgeRestricted(true);

    Consulte o guia Privacidade e GDPR do myTarget 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 de publicidade 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 a versão 3.13.3 do myTarget inclui o método SetCCPAUserConsent(bool). O exemplo de código a seguir mostra como transmitir informações de consentimento do usuário para o SDK da myTarget. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo Google Mobile Ads Unity Plugin.

    using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

    Entre em contato com o suporte da myTarget para mais informações.

    Etapa 5: adicionar o código necessário

    Android

    Não é necessário nenhum código adicional para a integração com a myTarget.

    iOS

    Integração da SKAdNetwork

    Siga a documentação da myTarget para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

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

    Códigos de erro

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

    Android

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

    iOS

    GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

    Android

    Código do erro Motivo
    100 O SDK do 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 de anúncio solicitado não corresponde a um tamanho de banner compatível com o myTarget.
    103 A solicitação de anúncio não é uma solicitação de anúncio nativo unificado.
    104 O anúncio nativo carregado do myTarget é diferente do solicitado.
    105 O anúncio nativo carregado do myTarget não tem alguns recursos obrigatórios (por exemplo, imagem ou ícone).
    106 O SDK do myTarget não mostrou o anúncio.

    iOS

    Código do erro Motivo
    100 O SDK da myTarget ainda não tem um anúncio disponível.
    101 Os parâmetros do servidor da myTarget configurados na interface do Ad Manager estão ausentes ou são inválidos.
    102 O adaptador do myTarget não é compatível com o formato de anúncio solicitado.
    103 Tentou mostrar um anúncio do myTarget que não foi carregado.
    104 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com o myTarget.
    105 Recursos de anúncios nativos obrigatórios ausentes.

    Registro de alterações do plug-in de mediação do Unity da myTarget

    Versão 3.42.0 (em andamento)

    Versão 3.41.1

    Versão 3.41.0

    Versão 3.40.0

    Versão 3.39.0

    Versão 3.38.0

    Versão 3.37.0

    Versão 3.36.0

    Versão 3.35.0

    Versão 3.34.0

    Versão 3.33.0

    Versão 3.32.1

    Versão 3.32.0

    Versão 3.31.0

    Versão 3.30.1

    Versão 3.30.0

    Versão 3.29.0

    Versão 3.28.0

    Versão 3.27.1

    Versão 3.27.0

    Versão 3.26.0

    Versão 3.25.0

    Versão 3.24.0

    Versão 3.23.0

    Versão 3.22.0

    Versão 3.21.1

    Versão 3.21.0

    Versão 3.20.0

    Versão 3.19.0

    Versão 3.18.2

    Versão 3.18.1

    Versão 3.18.0

    Versão 3.17.1

    Versão 3.17.0

    Versão 3.16.2

    Versão 3.16.1

    Versão 3.16.0

    Versão 3.15.0

    Versão 3.14.0

    Versão 3.13.2

    Versão 3.13.1

    Versão 3.13.0

    Versão 3.12.0

    Versão 3.11.4

    Versão 3.11.3

    Versão 3.11.2

    Versão 3.11.1

    Versão 3.11.0

    Versão 3.10.2

    Versão 3.10.1

    Versão 3.10.0

    Versão 3.9.0

    Versão 3.8.2

    Versão 3.8.1

    Versão 3.8.0

    Versão 3.7.0

    Versão 3.6.1

    Versão 3.6.0

    Versão 3.5.2

    Versão 3.5.1

    Versão 3.5.0

    Versão 3.4.0

    Versão 3.3.0

    Versão 3.2.0

    Versão 3.1.0

    Versão 3.0.0

    • Atualizamos o plug-in para oferecer suporte à nova API Rewarded em versão Beta aberta.
    • Compatibilidade com a versão 5.3.9.0 do adaptador do myTarget para Android.
    • Compatível com a versão 5.0.4.0 do adaptador myTarget para iOS.

    Versão 2.3.2

    • Compatível com a versão 5.2.5.0 do adaptador do myTarget para Android.
    • Compatibilidade com a versão 4.8.9.0 do adaptador myTarget para iOS.

    Versão 2.3.1

    • Compatível com a versão 5.2.5.0 do adaptador myTarget para Android.
    • Compatível com a versão 4.8.5.0 do adaptador do myTarget para iOS.

    Versão 2.3.0

    • Compatível com a versão 5.2.2.0 do adaptador do myTarget para Android.
    • Compatível com a versão 4.8.0.0 do adaptador do myTarget para iOS.

    Versão 2.2.0

    • Compatível com a versão 5.1.4.0 do adaptador do myTarget para Android.
    • Compatível com a versão 4.8.0.0 do adaptador iOS myTarget.

    Versão 2.1.2

    • Compatível com a versão 5.1.3.0 do adaptador Android myTarget.
    • Compatível com a versão 4.7.11.0 do adaptador myTarget para iOS.

    Versão 2.1.1

    • Compatível com a versão 5.1.1.0 do adaptador do myTarget para Android.
    • Compatibilidade com a versão 4.7.10.0 do adaptador do myTarget para iOS.

    Versão 2.1.0

    • Compatível com a versão 5.1.0 do SDK do myTarget para Android.
    • Compatível com a versão 4.7.9 do SDK do myTarget para iOS.
    • Os seguintes métodos foram adicionados:
      • MyTarget.SetUserConsent() para encaminhar o status de consentimento do usuário ao SDK do MyTarget.
      • Método MyTarget.SetUserAgeRestricted que define uma sinalização para indicar se o usuário está em uma categoria restrita de idade (ou seja, tem menos de 16 anos).
      • Método MyTarget.IsUserConsent() para receber o status de consentimento atual do usuário.
      • Método MyTarget.IsUserAgeRestricted() para receber a flag que indica que o usuário está em uma categoria com restrição de idade (ou seja, abaixo de 16 anos).

    Versão 2.0.1

    • Compatível com a versão 5.0.2 do SDK do Android myTarget.
    • Compatível com a versão 4.7.8 do SDK do myTarget para iOS.

    Versão 2.0.0

    • Compatível com a versão 5.0.0 do SDK do Android myTarget.
    • Compatível com a versão 4.7.7 do SDK do myTarget para iOS.

    Versão 1.1.0

    • Compatível com a versão 4.7.2 do SDK do Android do myTarget.
    • Compatível com a versão 4.7.6 do SDK do myTarget para iOS.

    Versão 1.0.0

    • Primeira versão!
    • Compatível com a versão 4.6.27 do SDK do Android do myTarget.
    • Compatível com a versão 4.6.24 do SDK do myTarget para iOS.