Integrar o Yahoo à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios do Yahoo usando a mediação, e abrangendo integrações em hierarquia. Ele aborda como adicionar o Yahoo à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Yahoo Mobile a um Android app.

Integrações e formatos de anúncio compatíveis

O Ad Manager adaptador de mediação para o Yahoo tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

  • Android API de nível 19 ou mais recente

  • SDK dos anúncios para dispositivos móveis do Google mais recente

  • Concluir o Guia explicativo de mediação

Etapa 1: definir configurações na interface do Yahoo

Faça login no SSP do Yahoo. Em Aplicativos e sites, clique no botão + e em Aplicativo.

Preencha o formulário e clique em Salvar e adicionar posicionamento para criar o app.

Depois de criar um aplicativo, você precisará criar um Posição. Selecione um Tipo de veiculação, preencha o formulário e clique em Salvar e gerar receita.

Anote o ID da posição.

Você precisará adicionar uma Origem de anúncios à sua posição. No próximo formulário, selecione Yahoo SSP como uma Origem de anúncios e preencha o formulário com as informações necessárias. Após preencher o formulário, clique em Salvar.

Por fim, arraste a Origem de anúncios que você acabou de criar na tabela Origens de anúncios em hierarquia para adicioná-la à posição.

Anote o ID do site.

Ativar modo de teste

Para testar os anúncios do Yahoo, crie uma origem de anúncios de teste e adicione-a às origens de anúncios em hierarquia da posição. Navegue até as configurações do ID da posição, clique no botão Adicionar e selecione Testar origem de anúncios.

Depois de criar a origem de anúncios, arraste-a para Origens de anúncios em hierarquia da posição.

Pronto! Agora você tem uma integração de mediação em funcionamento com o Yahoo.

Etapa 2: configurar a demanda do Yahoo na Ad Manager interface

Definir as configurações de mediação para seu 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 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 ao qual 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 Yahoo - App & Display , selecione-o. Caso contrário, selecione Criar um novo parceiro de rendimento.

Selecione Yahoo - App & Display como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.

Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como Plataforma e Ativo como o Status. Insira o Placement ID and Site ID obtido na seção anterior. Em seguida, insira um valor de CPM padrão.

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

Adicionar Yahoo à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Yahoo à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na Ad Manager IU.

Etapa 3: importar o SDK e o adaptador do Yahoo Mobile

Adicione as seguintes dependências de implementação com as versões mais recentes do SDK e do adaptador do Yahoo Ads no arquivo build.gradle no nível do app:

repositories {
    google()
    mavenCentral()
    maven {
      url 'https://artifactory.yahooinc.com/artifactory/maven/'
    }
}

...
dependencies {
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.gms:play-services-ads:22.6.0'
    implementation 'com.google.ads.mediation:yahoo:1.4.1.1'
}
...

Integração manual

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

Leis Estaduais de Privacidade dos EUA

As 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 definição desses termos) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.

O exemplo de código a seguir mostra como transmitir informações de consentimento ao SDK do Yahoo para dispositivos móveis. Se você optar por chamar esse método, é recomendável fazer isso antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

Java

import com.yahoo.ads.YASAds;
import com.yahoo.ads.CcpaConsent;

// ...
CcpaConsent ccpaConsent = new CcpaConsent("<CCPA CONSENT>");
YASAds.addConsent(ccpaConsent);

Kotlin

import com.yahoo.ads.YASAds
import com.yahoo.ads.CcpaConsent

// ...
val ccpaConsent = CcpaConsent("<CCPA CONSENT>")
YASAds.addConsent(ccpaConsent)

Consulte Configurações de privacidade do editor para mais detalhes 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 com o Yahoo.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em Ad Manager e ative o modo de teste na Yahoo - App & Display interface.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do Yahoo - App & Display , ative os testes de uma única origem no Ad Inspector usando as Yahoo (Waterfall) origens de anúncios.

Etapas opcionais

Usar anúncios nativos

Renderização do anúncio

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

Campo Preenchido pelo adaptador do Yahoo
Título
Imagem
Body
Ícone do app
Call-to-action
Nome do anunciante
Star rating
Armazenar
Preço

Registro de alterações do adaptador de mediação do Yahoo! Android

Próxima versão

  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 22.4.0.

Versão 1.4.1.1

  • O adaptador foi atualizado para usar a nova classe VersionInfo.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 22.0.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
  • SDK do Yahoo Mobile 1.4.1

Versão 1.4.1.0

  • Adaptador Verizon Media renomeado para "Yahoo".
  • Foram adicionados códigos de erro descritivos e motivos para o carregamento do adaptador e as falhas de exibição.
  • Compatibilidade com o SDK para dispositivos móveis do Yahoo versão 1.4.1 verificada.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 21.5.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK do Yahoo Mobile 1.4.1