Como integrar o Facebook Audience Network com o Bidding

Este guia é destinado a editores que querem usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Facebook Audience Network por meio de lances. O guia aborda como integrar o SDK e o adaptador da Facebook Audience Network a um app Unity.

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

O adaptador de mediação da AdMob para o Facebook Audience Network tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Intersticial premiado

Requisitos

  • Unity 5.6 ou posterior
  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Plug-in de mediação de anúncios para dispositivos móveis do Google para Facebook 2.11.0 ou posterior
  • Para implantar no Android:
    • API do Android de nível 16 ou mais recente.
  • Para implantar no iOS:
    • Meta de implantação do iOS de 10.0 ou mais recente
    • O SDK mais recente do Facebook Audience Network geralmente requer a versão mais recente do Xcode.
  • Um projeto do Unity em funcionamento que é configurado com o SDK dos anúncios para dispositivos móveis do Google. Veja mais detalhes em Primeiros passos.

Etapa 1: configurar o Facebook Audience Network

Inscreva-se e faça login na página inicial do Business Manager.

Clique em Criar uma nova conta do Gerenciador de Negócios e preencha os campos obrigatórios com os detalhes da sua empresa.

Criar uma propriedade do Facebook

Depois de preencher as informações necessárias, você precisará criar uma propriedade para seu app. Insira o nome desejado e clique em Acessar o Gerenciador de monetização.

Em seguida, escolha a plataforma com que você quer gerar receita.

Indique se o seu app está ativo e clique em Enviar.

Android

iOS

Você precisará criar uma veiculação de anúncio para o aplicativo. Selecione um formato, preencha o formulário e clique em Próxima.

Selecione Banner para todos os tamanhos de banner, inclusive para 300 x 250. O Facebook não é compatível com o formato de exibição Medium Rectangle nos lances, mas com um banner de largura flexível com uma altura de 50, 90 ou 250 ao usar o formato de exibição Banner.

Se você planeja integrar o formato de anúncio intersticial premiado, o formato correspondente do Facebook é Rewarded Video.

A próxima etapa apresenta uma visão geral do canal que você criou. Anote o ID da posição na seção Adicionar ID da posição.

Etapa 2: definir as configurações de mediação para seu bloco de anúncios da AdMob

É necessário adicionar o Facebook à configuração de mediação do seu bloco de anúncios. Primeiro, faça login na sua conta da AdMob.

Android

Acesse a guia Mediação. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome desse grupo para editá-lo e pule para Adicionar o Facebook Audience Network como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato do anúncio e a plataforma e clique em Continuar.

Dê um nome ao seu grupo de mediação e selecione os locais a serem segmentados. Em seguida, defina o status do grupo de mediação como Ativado. Em seguida, clique em Adicionar blocos de anúncios para abrir a sobreposição de seleção de bloco de anúncios.

Associe este grupo de mediação ao seu bloco de anúncios existente da AdMob. Clique em Concluído. Você verá o card de blocos de anúncios preenchido com os blocos selecionados.

Adicionar o Audience Network do Facebook como uma origem de anúncios

No card Origens de anúncio, selecione Adicionar rede de anúncios. Selecione Facebook Audience Network (Bidding). Insira o ID de posição recebido na seção anterior e clique em Concluído.

Por fim, clique em Salvar.

iOS

Acesse a guia Mediação. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome desse grupo para editá-lo e pule para Adicionar o Facebook Audience Network como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato do anúncio e a plataforma e clique em Continuar.

Dê um nome ao seu grupo de mediação e selecione os locais a serem segmentados. Em seguida, defina o status do grupo de mediação como Ativado. Em seguida, clique em Adicionar blocos de anúncios para abrir a sobreposição de seleção de bloco de anúncios.

Associe este grupo de mediação ao seu bloco de anúncios existente da AdMob. Clique em Concluído.

Você verá o card de blocos de anúncios preenchido com os blocos selecionados.

Adicionar o Audience Network do Facebook como uma origem de anúncios

No card Origens de anúncio, selecione Adicionar rede de anúncios. Selecione Facebook Audience Network (Bidding). Insira o ID de posição recebido na seção anterior e clique em Concluído.

Por fim, clique em Salvar.

Como usar anúncios premiados

Nas configurações do bloco de anúncios premiados, forneça valores para o valor e o tipo de prêmio. Em seguida, para garantir que você forneça o mesmo prêmio ao usuário, independentemente da rede de publicidade veiculada, marque a caixa Aplicar a todas as redes nos grupos de mediação.

Se você não aplicar essa configuração, o adaptador do Facebook usará como padrão uma recompensa do tipo "" (string vazia) com 1. O SDK do Facebook não fornece valores específicos para os anúncios premiados.

Para mais informações sobre como definir valores de recompensa para blocos de anúncios da AdMob, consulte Criar um bloco de anúncios.

Etapa 3: importar o SDK e o adaptador da Audience Network do Facebook

Faça o download da versão mais recente do plug-in de mediação de anúncios do Google para dispositivos móveis para o Facebook a partir do link de download no Registro de alterações e extraia o GoogleMobileAdsFacebookMediation.unitypackage do arquivo ZIP.

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

Em seguida, selecione Assets > Play Services Resolver > Android Resolver > Force Resolve. A biblioteca resolvedor do Unity Play Services vai fazer a resolução da dependência do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do app Unity.

Etapa 4: código adicional necessário

Android

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

iOS

Integração com a SKAdNetwork

O Facebook pede que você adicione os seguintes identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto:

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n38lu8286q.skadnetwork</string>
    </dict>
</array>

Acompanhamento de publicidade ativado

Se você está criando para o iOS 14 ou mais recente, consulte as instruções do Facebook sobre como definir a sinalização de acompanhamento de publicidade.

Etapa 5: testar a implementação

Consulte o guia Como testar a implementação da Audience Network (em inglês) para ver instruções detalhadas sobre como ativar os anúncios de teste do Facebook. Depois, use o Pacote de testes de mediação para verificar se a implementação está correta.

Pronto! Agora você tem uma integração de mediação ativa com o Audience Network do Facebook.

Etapas opcionais

De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que determinadas divulgações sejam fornecidas e recebidas por usuários do Espaço Econômico Europeu (EEE) em relação ao uso de identificadores de dispositivos e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao receber o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. Atualmente, o Google não consegue transmitir a escolha de consentimento do usuário para essas redes automaticamente.

Leia as orientações do Facebook para informações sobre o GDPR e a publicidade no Facebook.

Adicionar o Facebook à lista de parceiros de anúncios do GDPR

Siga as etapas nas configurações do GDPR para adicionar o Facebook à lista de parceiros de anúncios do GDPR na IU da AdMob.

CCPA

A A Lei de Privacidade do Consumidor da Califórnia (CCPA) exige que os residentes do estado da Califórnia tenham o direito de recusar a divulgação de informações pessoais (como a lei define esses termos), com a opção de não permitir a venda O guia de preparação da CCPA permite ativar o processamento de dados restrito para a veiculação de anúncios do Google. No entanto, o Google não consegue aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade em 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 com a CCPA.

Para usuários na Califórnia, consulte as opções de processamento de dados do Facebook.

Adicionar o Facebook à lista de parceiros de anúncios da CCPA

Siga as etapas nas configurações da CCPA para adicionar o Facebook à lista de parceiros de anúncios da CCPA na IU da AdMob.

Códigos de erro

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

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Veja os códigos e as mensagens correspondentes geradas pelo adaptador da Audience Network do Facebook quando um anúncio não é carregado:

Android

Código do erro Motivo
101 Parâmetros do servidor inválidos (por exemplo, sem ID do canal).
102 O tamanho do anúncio solicitado não corresponde ao tamanho de banner da Facebook Audience Network.
103 O editor precisa solicitar anúncios com um contexto de Activity.
104 Falha ao inicializar o SDK da Facebook Audience Network.
105 O editor não solicitou anúncios nativos unificados.
106 O anúncio nativo carregado é um objeto diferente do esperado.
107 O objeto Context usado é inválido.
108 O anúncio carregado não tem os recursos de anúncios nativos exigidos.
109 Falha ao criar um anúncio nativo a partir do payload do lance.
110 O SDK da Facebook Audience Network não conseguiu exibir o anúncio intersticial/premiado.
111 Exceção gerada ao criar um objeto AdView do Audience Network do Facebook.
1000-9999 O Facebook Audience Network retornou um erro específico do SDK. Consulte a documentação do Facebook para mais detalhes.

iOS

Código do erro Motivo
101 Parâmetros do servidor inválidos (por exemplo, sem ID do canal).
102 O tamanho do anúncio solicitado não corresponde ao tamanho de banner da Facebook Audience Network.
103 Falha ao inicializar o objeto de anúncio do Facebook Audience Network.
104 O SDK da Facebook Audience Network não conseguiu exibir o anúncio intersticial/premiado.
105 O controlador de visualização raiz do anúncio de banner é nil.
106 Falha ao inicializar o SDK da Facebook Audience Network.
1000-9999 O Facebook Audience Network retornou um erro específico do SDK. Consulte a documentação do Facebook para mais detalhes.

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

Versão 3.7.0

Versão 3.6.1

Versão 3.6.0

Versão 3.5.0

Versão 3.4.0

Versão 3.3.2

Versão 3.3.1

Versão 3.3.0

Versão 3.2.0

Versão 3.1.0

Versão 3.0.0

Versão 2.12.0

Versão 2.11.1

Versão 2.11.0

Versão 2.10.0

Versão 2.9.2

Versão 2.9.1

Versão 2.9.0

Versão 2.8.1

Versão 2.8.0

Versão 2.7.1 (Obsoleto. Use 2.8.0 ou mais recente)

Versão 2.7.0 (Obsoleto. Use 2.8.0 ou mais recente)

Versão 2.6.1 (Obsoleto. Use 2.8.0 ou mais recente)

Versão 2.6.0

Versão 2.5.1

  • Compatível com o adaptador do Facebook para Android versão 5.5.0.0.
  • Compatível com o adaptador do iOS para o Facebook versão 5.5.1.0.

Versão 2.5.0

  • Compatível com o adaptador do Facebook para Android versão 5.5.0.0.
  • Compatível com o adaptador do iOS para o Facebook versão 5.5.0.0.

Versão 2.4.1

  • Compatível com o adaptador do Facebook para Android versão 5.4.1.1.
  • Compatível com o adaptador do Facebook para iOS versão 5.4.0.0.

Versão 2.4.0

  • Compatível com o adaptador do Facebook para Android versão 5.4.0.0.
  • Compatível com o adaptador do Facebook para iOS versão 5.4.0.0.

Versão 2.3.2

  • Compatível com o adaptador do Facebook para Android versão 5.3.1.2.
  • Compatível com o adaptador do Facebook para iOS versão 5.3.2.0.

Versão 2.3.1

  • Compatível com o Facebook Android adaptador versão 5.3.1.0.
  • Compatível com o adaptador do Facebook para iOS versão 5.3.2.0.

Versão 2.3.0

  • Compatível com o Facebook Android adaptador versão 5.3.0.0.
  • Compatível com o adaptador do Facebook para iOS versão 5.3.0.0.

Versão 2.2.0

  • Atualizamos o plug-in para oferecer compatibilidade com a nova API Rewarded na versão Beta aberta.
  • Compatível com o adaptador do Facebook para Android versão 5.2.0.1.
  • É compatível com o adaptador do Facebook para iOS versão 5.2.0.1.

Versão 2.1.1

  • É compatível com a versão 5.1.0.1 do adaptador Android do Facebook.
  • Compatível com o adaptador do iOS para o Facebook versão 5.1.0.0.

Versão 2.1.0

  • Compatível com o Facebook Android adaptador versão 5.1.0.0.
  • Compatível com o adaptador do iOS para o Facebook versão 5.1.0.0.

Versão 2.0.0

  • Compatível com o Facebook Android adaptador versão 5.0.1.0.
  • Compatível com o adaptador do iOS do Facebook versão 5.0.1.0.

Version 1.2.1

  • É compatível com a versão 4.99.3.0 do adaptador Android do Facebook.
  • Compatível com o adaptador do Facebook para iOS versão 4.99.3.0.

Versão 1.2.0

  • Compatível com o adaptador do Facebook para Android versão 4.99.1.1.
  • Compatível com o adaptador do Facebook para iOS versão 4.99.2.0.

Versão 1.1.3

  • Compatível com o adaptador do Facebook para Android versão 4.28.2.1.
  • Compatível com o adaptador do Facebook para iOS versão 4.28.1.2.

Versão 1.1.2

  • Correção de um possível conflito com o plug-in de mediação do Unity para anúncios do Unity.

Versão 1.1.1

  • Compatível com o adaptador do Facebook para Android versão 4.28.2.0.
  • Compatível com o adaptador do Facebook para iOS versão 4.28.1.1.

Versão 1.1.0

  • Compatível com o SDK do Facebook para Android: versão 4.28.1.
  • Compatível com o SDK do Facebook para iOS: versão 4.28.1.

Versão 1.0.0

  • Primeira versão!
  • Compatível com o SDK do Facebook para Android versão 4.27.0.
  • Compatível com o SDK do Facebook para iOS: versão 4.27.1.