Estamos sempre publicando atualizações em nossa documentação, mas pode ser que elas ainda não estejam disponíveis em seu idioma. Para ter acesso às informações mais atualizadas, use a ​​versão em inglês.

Relatório de dados brutos da Meta para Android

A Meta permite que os anunciantes enriqueçam seus dados brutos para Android usando install referrers. Os metadados de campanha são anexados ao install referrer em um formato criptografado. Para ler os metadados, é necessário usar uma chave de descriptografia oferecida pela Meta para o seu aplicativo.

Há dois install referrers com suporte que podem ser usados para enriquecer seus dados brutos:

  • O Google Play Install Referrer (GPIR)
  • O Meta Install Referrer (MIR)

Ambos os install referrers oferecem mais informações sobre as instalações do aplicativo originadas dos aplicativos da Meta, como Facebook e Instagram. No entanto, somente o MIR oferece suporte à atribuição de visualizações e à atribuição de cliques em sessões distintas.

Antes de começar

Antes de começar, você precisa saber o seguinte:

Requisitos

GPIR

Para habilitar o GPIR, você deve configurar o Google Play Install Referrer.

MIR

Para habilitar o plug-in do MIR, você deve atualizar o SDK da Adjust para Android para a versão 5 e configurar o plug-in do Meta Install Referrer.

Como funciona

Usando a solução install referrer, você pode vincular a atividade in-app do usuário à sua fonte de aquisição para anúncios servidos no Android. Isso permite que você continue a mensurar o sucesso das campanhas e identifique tendências principais de aquisição.

  1. Quando um usuário instala seu aplicativo, o install referrer coleta dados de referência da fonte de instalação.
  2. A Meta compartilha esses dados criptografados usando a API do install referrer.
  3. A Adjust, então, extrai os dados e os descriptografa usando sua chave de descriptografia da Meta.

Uma string de dados descriptografados vai ter a seguinte aparência:

{
"ad_id":"12345",
"ad_objective_name":"APP_INSTALL",
"adgroup_id":"54321",
"adgroup_name":"Test Ad Group",
"campaign_id":"987654",
"campaign_name":"Test Campaign",
"campaign_group_id":"654321",
"campaign_group_name":"Test Campaign Group",
"account_id":"444444",
"publisher_platform":"Test Publisher Platform",
}

Você pode usar placeholders para coletar dados descriptografados em suas exportações de dados brutos.

Dica:
Se você habilitar ambos MIR e GPIR, receberá informações das duas fontes em suas exportações de dados brutos. A Adjust somente desduplica as informações do MIR e GPIR no Datascape. Recomendamos priorizar o GPIR.

Quais dados não são compartilhados?

A Meta não envia IDs de dispositivos.

Os seguintes pontos de dados estão disponíveis somente quando você usa o MIR:

  • Conversões de visualização
  • Eventos de aplicativos de lojas de aplicativos Android que não sejam o Google Play (por exemplo, Galaxy Store e Amazon Appstore).

Configurar o install referrer

Para configurar a solução de install referrer e receber detalhes no nível de campanha da Meta, siga estes passos.

Compartilhe suas credenciais da Meta com a Adjust

Para permitir que a Adjust descriptografe os dados do referrer, forneça a sua chave de descriptografia do install referrer.

Encontre sua chave de descriptografia

Uma chave de descriptografia é uma string de 64 caracteres disponível por ID do app da Meta.

Exemplo: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Para encontrar sua chave de descriptografia, siga estes passos.

  1. Abra seu painel do aplicativo.
  2. Selecione o aplicativo relevante.
  3. Selecione Settings > Basic.
  4. Navegue até a seção Android.
  5. Copie a  chave de descriptografia do install referrer.
A screenshot from Meta's App Dashboard that shows where to find your Decryption Key. Refer to the textual instructions above.

Adicione sua chave de descriptografia na Adjust

Para adicionar sua chave de descriptografia na Adjust, siga os próximos passos.

  1. Abra Campaign Lab > Parceiros.
  2. Busque por Facebook e selecione-o para abrir a página de visão geral.
  3. Selecione a aba Compartilhamento de dados para ver a lista de aplicativos.
  4. Encontre o app que você gostaria de configurar e selecione o botão de Editar ().
  5. Em Habilitar o compartilhamento de dados para o Facebook, selecione Editar.
  6. Cole a chave de descriptografia que você copiou na etapa anterior no campo Chave de descriptografia (opcional).
  7. Clique no botão Salvar.

Adicione placeholders do referrer da Meta aos seus callbacks

A Adjust pode usar placeholders para enviar a você dados descriptografados da Meta. Para recebê-los em suas exportações de dados brutos, adicione os placeholders relevantes a sua URL de callback ou definiçāo de CSV.

Placeholders disponíveis

GPIR
MIR
Espaço reservadoDescrição
{fb_install_referrer}Todo o conteúdo do install referrer da Meta, em formato descriptografado.
{fb_install_referrer_campaign_group_name}O valor "campaign_group_name" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_campaign_group_id}O valor "campaign_group_id" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_campaign_name}O valor "campaign_name" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_campaign_id}O valor "campaign_id" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_adgroup_id}O valor "adgroup_id" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_adgroup_name}O valor "adgroup_name" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_ad_id}O valor "ad_id" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_account_id}O valor "account_id" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_ad_objective_name}O valor "ad_objective_name" a partir do conteúdo integral do install referrer da Meta.
{fb_install_referrer_publisher_platform}O valor "publisher_platform" a partir do conteúdo integral do install referrer da Meta.

Mapeamento de relatórios e placeholder

A Adjust usa os seguintes mapeamentos para alinhar os dados recebidos dos placeholders do referrer da Meta aos nossos relatórios.

GPIR
MIR
Campo de atribuição da AdjustRelatório da MetaEspaço reservadoExemplo de valor
network_namePlataforma do publisher {fb_install_referrer_publisher_platform} Instalações da Meta
campaign_nameNome da campanha
ID da campanha
{fb_install_referrer_campaign_group_name}
({fb_install_referrer_campaign_group_id})
Teste de campanha da Meta no Android (123456789)
adgroup_nameNome do conjunto de anúncios
ID do conjunto de anúncios
{fb_install_referrer_campaign_name}
({fb_install_referrer_campaign_id})
Android - EUA - Conjunto básico de anúncios (234567890)
creative_nameNome do anúncio
ID do anúncio
{fb_install_referrer_adgroup_name}
({fb_install_referrer_adgroup_id})
 Banner de verão (345678901)

Como a Adjust exibe o network_name

A Adjust usa a seguinte lógica para reportar o nome da rede ou network_name:

publisher_platformnetwork_name relatado como:
“facebook”, “unknown” ou outroFacebook Installs
"instagram”Instagram Installs
"messenger”Facebook Messenger Installs
"audience_network”Off-Facebook Installs

Exemplo de callbacks

GPIR
MIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&fb_referrer={fb_install_referrer}&PhFbInstallReferrerAdId={fb_install_referrer_ad_id}&PhFbInstallReferrerAdGroupId={fb_install_referrer_adgroup_id}&PhFbInstallReferrerAdGroupName={fb_install_referrer_adgroup_name}&PhFbInstallReferrerCampaignId={fb_install_referrer_campaign_id}&PhFbInstallReferrerCampaignName={fb_install_referrer_campaign_name}&PhFbInstallReferrerCampaignGroupId={fb_install_referrer_campaign_group_id}&PhFbInstallReferrerCampaignGroupName={fb_install_referrer_campaign_group_name}&PhFbInstallReferrerAccountId={fb_install_referrer_account_id}&PhFbInstallReferrerAdObjectiveName={fb_install_referrer_ad_objective_name}&PhFbInstallReferrerPublisherPlatform={fb_install_referrer_publisher_platform}

Exemplo de callback preenchido com valores

GPIR
MIR
https://app.my-random-server.com/?tracker=unattr&tracker_name=Unattributed&referrer=adjust_reftag%3DceJTzfSP7kyVV%26utm_source%3Dfacebook%26utm_content%3D%257B%2522source%2522%253A%257B%2522data%2522%253A%2522afe56cf6228c6ea8c79da49186e718e92a579824596ae1d0d4d20d7793dca797bd4034ccf467bfae5c79a3981e7a2968c41949237e2b2db678c1c3d39c9ae564c5cafd52f2b77a3dc77bf1bae063114d0283b97417487207735da31ddc1531d5645a9c3e602c195a0ebf69c272aa5fda3a2d781cb47e117310164715a54c7a5a032740584e2789a7b4e596034c16425139a77e507c492b629c848573c714a03a2e7d25b9459b95842332b460f3682d19c35dbc7d53e3a51e0497ff6a6cbb367e760debc4194ae097498108df7b95eac2fa9bac4320077b510be3b7b823248bfe02ae501d9fe4ba179c7de6733c92bf89d523df9e31238ef497b9db719484cbab7531dbf6c5ea5a8087f95d59f5e4f89050e0f1dc03e464168ad76a64cca64b79%2522%252C%2522nonce%2522%253A%2522b7203c6a6fb633d16e9cf5c1%2522%257D%257D&fb_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhFbInstallReferrerAdId=12345&PhFbInstallReferrerCampaignId=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhFbInstallReferrerCampaignName=Adams+Test+Campaign&PhFbInstallReferrerCampaignGroupId=654321&PhFbInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhFbInstallReferrerAccountId=444444&PhFbInstallReferrerAdObjectiveName=APP_INSTALLS &PhFbInstallReferrerAdObjectiveName=APP_INSTALLS&FbInstallReferrerPublisherPlatform=facebook

Instalações não atribuídas à Meta

Se um referrer for anexado a uma instalação e a atribuição final for concedida a um parceiro que não seja a Meta, você ainda receberá informações do referrer em seus dados.

GPIR
MIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&fb_install_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D