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

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

  • O Meta Install Referrer (MIR)
  • O Google Play Install Referrer (GPIR)
Observação:
Ambos os install referrers oferecem mais informações sobre as instalações do app originadas pelos aplicativos da Meta, como Facebook e Instagram. No entanto, o MIR oferece suporte à atribuição de visualizações e atribuição de cliques em sessões distintas, o que não é suportado pelo GPIR. É recomendável usar o MIR para obter o máximo possível das suas campanhas da Meta.

Antes de começar

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

Requisitos

MIR

GPIR

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.

Quando um usuário instala seu app, o install referrer coleta conteúdo de referência da fonte de instalação. A Meta compartilha os dados usando a API do install referrer em um formato criptografado. 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.

Aviso:
Se você habilitar ambos MIR e GPIR, receberá informações das duas fontes. A Adjust desduplica as informações do MIR e GPIR no Datascape, mas você receberá ambos os conjuntos de dados em suas exportações de dados brutos. Você deve priorizar os dados MIR sobre os dados GPIR.

Quais dados não são compartilhados?

A Meta não envia nenhum dos seguintes metadados:

Os seguintes metadados estão disponíveis apenas ao usar o MIR:

  • Conversões de visualização
  • Eventos do aplicativo ocorrendo em lojas de aplicativos Android fora do Google Play Store (por exemplo, Galaxy Store e Amazon Appstore).

Configure a solução Install Referrer

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

1. Atualize suas credenciais da Meta na Adjust

Para habilitar a Adjust a descriptografar os metadados do referenciador, é preciso compartilhar sua chave de descriptografia do install referrer. Trata-se de uma string de 64 caracteres com letras minúsculas (a-f) e números (0-9). Uma chave de descriptografia está disponível por ID de app da Meta.

Exemplo: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Encontre sua chave de descriptografia

Para encontrar sua chave de descriptografia, siga estes passos.

  1. Faça o login no portal de desenvolvedores da Meta.
  2. Clique em My Apps no canto superior direito.
  3. Selecione o aplicativo para o qual você deseja acessar a chave de descriptografia.
  4. Selecione Settings > Basic.
  5. Navegue até a seção Android.
  6. Busque a Install Referrer Decryption Key (chave de descriptografia do Install Referrer) no cabeçalho do Google Play.

Adicione sua chave de descriptografia na Adjust

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

  1. Em Campaign Lab, selecione Parceiros.
  2. Busque por Facebook e selecione o link para ir até a página de visão geral.
  3. Selecione a aba Compartilhamento de dados para ver a lista de apps.
  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. Insira sua chave de descriptografia para cada plataforma que deseja configurar.

2. Adicione placeholders do referrer da Meta aos seus callbacks

A Adjust pode usar certos placeholders para enviar dados descriptografados da Meta em suas exportações de dados brutos. Para receber essa informação, atualize sua URL de callback ou definição de CSV com os placeholders necessários.

Placeholders disponíveis

MIR
GPIR
Espaço reservadoDescrição
{meta_install_referrer}Todo o conteúdo do install referrer da Meta, em formato descriptografado.
{meta_install_referrer_campaign_group_name}O valor "campaign_group_name" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_campaign_group_id}O valor "campaign_group_id" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_campaign_name}O valor "campaign_name" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_campaign_id}O valor "campaign_id" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_adgroup_id}O valor "adgroup_id" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_adgroup_name}O valor "adgroup_name" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_ad_id}O valor "ad_id" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_account_id}O valor "account_id" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_ad_objective_name}O valor "ad_objective_name" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_publisher_platform}O valor "publisher_platform" a partir do conteúdo integral do install referrer da Meta.
{meta_install_referrer_is_click}Indica se o tipo de engajamento é um clique. Os valores possíveis são 1 , se o engajamento for um clique, ou 0 se não for.
{meta_install_referrer_actual_timestamp}O valor "actual_timestamp" do conteúdo integral do install referrer da Meta usando o formato Unix de marca temporal.

Mapeamento de relatórios e placeholder

Para alinhar os dados recebidos dos placeholders do referrer da Meta em nossos relatórios, a Adjust usa os seguintes mapeamentos.

MIR
GPIR
Campo de atribuição da AdjustRelatório da MetaEspaço reservadoExemplo de valor
network_namePlataforma do publisher
  • {meta_install_referrer_publisher_platform}
Instalações da Meta
campaign_nameNome da campanha
ID da campanha
  • {meta_install_referrer_campaign_group_name}({meta_install_referrer_campaign_group_id})
 Android Facebook campaign test (123456789)
adgroup_nameNome do conjunto de anúncios
ID do conjunto de anúncios
  • {meta_install_referrer_campaign_name}({meta_install_referrer_campaign_id})
 Android - US - Basic Ad Set (234567890)
creative_nameNome do anúncio
ID do anúncio
  • {meta_install_referrer_adgroup_name}({meta_install_referrer_adgroup_id})
 Summer banner (345678901)

Como a Adjust exibe o network_name

Exemplo de callbacks

Exemplo de URL de callback

MIR
GPIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&meta_referrer={meta_install_referrer}&PhMetaInstallReferrerAdId={meta_install_referrer_ad_id}&PhMetaInstallReferrerAdGroupId={meta_install_referrer_adgroup_id}&PhMetaInstallReferrerAdGroupName={meta_install_referrer_adgroup_name}&PhMetaInstallReferrerCampaignId={meta_install_referrer_campaign_id}&PhMetaInstallReferrerCampaignName={meta_install_referrer_campaign_name}&PhMetaInstallReferrerCampaignGroupId={meta_install_referrer_campaign_group_id}&PhMetaInstallReferrerCampaignGroupName={meta_install_referrer_campaign_group_name}&PhMetaInstallReferrerAccountId={meta_install_referrer_account_id}&PhMetaInstallReferrerAdObjectiveName={meta_install_referrer_ad_objective_name}&PhMetaInstallReferrerPublisherPlatform={meta_install_referrer_publisher_platform}&PhMetaInstallReferrerIsClick={meta_install_referrer_is_click}&PhMetaInstallReferrerActualTimestamp={meta_install_referrer_actual_timestamp}

Exemplo de callback preenchido com valores

MIR
GPIR
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&meta_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&PhMetaInstallReferrerAdId=12345&PhMetaInstallReferrerCampaignId=%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&PhMetaInstallReferrerCampaignName=Adams+Test+Campaign&PhMetaInstallReferrerCampaignGroupId=654321&PhMetaInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhMetaInstallReferrerAccountId=444444&PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS &PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS&MetaInstallReferrerPublisherPlatform=facebook&PhMetaInstallReferrerIsClick=1&PhMetaInstallReferrerActualTimestamp=1234567890

Para instalações não atribuídas à Meta

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

MIR
GPIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&meta_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