Publicamos actualizaciones constantes en nuestra documentación, y es posible que algunas de ellas aún no estén disponibles en tu idioma. Si deseas obtener la información más actual, utiliza la versión en inglés.

Cómo elaborar informes de datos sin procesar de Meta para Android

Meta permite que los anunciantes enriquezcan sus datos sin procesar (raw data) para Android mediante los referentes de instalación. Los metadatos de la campaña se anexan al referente de instalación en un formato cifrado. Para leer los metadatos, debes utilizar una clave de descifrado proporcionada por Meta para tu aplicación.

Hay dos referentes de instalación compatibles que puedes utilizar para mejorar tus datos sin procesar (raw data):

  • El referente de instalación de Google Play (GPIR)
  • El referente de instalación de Meta (MIR)

Los dos referentes de instalación proporcionan más información sobre las instalaciones de aplicaciones originadas en aplicaciones de Meta, como Facebook e Instagram. Sin embargo, únicamente el MIR es compatible con la visualización ajustable y con la atribución de clics de una sesión diferente.

Antes de comenzar

Esto es lo que necesitas saber antes de comenzar.

Requisitos

GPIR

Para habilitar el GPIR, debes configurar el referente de instalación de Google Play.

MIR

Para habilitar el complemento de MIR, debes actualizar el SDK de Adjust para Android a la versión 5 y configurar el complemento del referente de instalación de Meta

Cómo funciona

Con la herramienta del referente de instalación, puedes vincular la actividad in-app de un usuario con su fuente de adquisición para los anuncios mostrados en Android. Esto te permite seguir midiendo el éxito de tus campañas e identificar las tendencias de adquisición clave.

  1. Cuando un usuario instala tu aplicación, el referente de instalación recopila los datos de la referencia de la fuente de instalación.
  2. Meta comparte estos datos cifrados por medio de la API del referente de instalación.
  3. Luego, Adjust extrae estos datos y los descifra con tu clave de descifrado de Meta.

Este es un ejemplo potencial de una cadena de datos descifrada:

{
"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",
}

Puedes utilizar placeholders para recopilar los datos descifrados en tus exportaciones de datos sin procesar (raw data).

Consejo:
Si habilitas el GPIR y el MIR, recibirás información de las dos fuentes en tus exportaciones de datos sin procesar. Nuestro sistema únicamente deduplica la información del GPIR y el MIR en Datascape. Nuestra recomendación general es dar una mayor prioridad al GPIR.

¿Qué datos no se comparten?

Meta no envía los ID del dispositivo.

Los siguientes puntos de datos únicamente están disponibles cuando utilizas el MIR:

  • Conversiones de visualización ajustable.
  • Eventos de la aplicación provenientes de tiendas de aplicaciones de Android fuera de Google Play (por ejemplo, Galaxy Store y Amazon Appstore).

Cómo configurar el referente de instalación

Para configurar la herramienta del referente de instalación y recibir los detalles a nivel de campaña provenientes de Meta, sigue estos pasos.

Comparte tus credenciales de Meta con Adjust

Para permitir que Adjust descifre los datos del referente, debes proporcionar tu clave de descifrado del referente de instalación.

Cómo encontrar tu clave de descifrado

Una clave de descifrado es una cadena de 64 caracteres que está disponible por cada ID de la aplicación de Meta.

Ejemplo: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Para encontrar tu clave de descifrado, sigue estos pasos.

  1. Abre tu Dashboard de aplicaciones.
  2. Selecciona la aplicación correspondiente.
  3. Selecciona Configuración > Básica .
  4. Desplázate hasta la sección de Android.
  5. Copia la  clave de descifrado del referente de instalación.
A screenshot from Meta's App Dashboard that shows where to find your Decryption Key. Refer to the textual instructions above.

Cómo agregar tu clave de descifrado en Adjust

Para agregar tu clave de descifrado en Adjust, sigue estos pasos.

  1. Abre Campaign Lab > Socios.
  2. Busca y selecciona Facebook para abrir la página de descripción general.
  3. Selecciona la pestaña Uso compartido de datos para ver una lista de aplicaciones.
  4. Busca la aplicación que desees configurar y selecciona el botón Editar ().
  5. En la opción Habilitar el uso compartido de datos para Facebook, selecciona Editar.
  6. Pega la clave de descifrado que copiaste en el paso anterior en el campo Clave de descifrado (opcional).
  7. Haz clic en el botón Guardar.

Agrega los placeholders del referente de Meta a tus callbacks

Podemos utilizar placeholders para enviarte los datos descifrados de Meta. Para recibir esta información en tus exportaciones de datos sin procesar, agrega los placeholders correspondientes a tu URL de callback o tu definición de CSV.

Placeholders disponibles

GPIR
MIR
PlaceholderDescription
{fb_install_referrer}Todo el contenido del referente de instalación de Meta, en formato descifrado.
{fb_install_referrer_campaign_group_name}El valor de "campaign_group_name" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_campaign_group_id}El valor de "campaign_group_id" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_campaign_name}El valor de "campaign_name" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_campaign_id}El valor de "campaign_id" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_adgroup_id}El valor de "adgroup_id" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_adgroup_name}El valor de "adgroup_name" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_ad_id}El valor de "ad_id" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_account_id}El valor de "account_id" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_ad_objective_name}El valor de "ad_objective_name" de todo el contenido del referente de instalación de Meta.
{fb_install_referrer_publisher_platform}El valor de "publisher_platform" de todo el contenido del referente de instalación de Meta.

Informes y mapeo de placeholders

Nuestro sistema utiliza los siguientes mapeos para hacer que los datos enviados por los placeholders del referente de Meta coincidan con nuestros informes.

GPIR
MIR
Campo de atribución de AdjustInformes de MetaPlaceholderValor de ejemplo
network_namePlataforma del publisher {fb_install_referrer_publisher_platform} Instalaciones de Meta
campaign_nameNombre de la campaña
ID de la campaña
{fb_install_referrer_campaign_group_name}
({fb_install_referrer_campaign_group_id})
Prueba de campaña de Meta para Android (123456789)
adgroup_nameNombre del conjunto de anuncios
ID del conjunto de anuncios
{fb_install_referrer_campaign_name}
({fb_install_referrer_campaign_id})
Android - EE. UU. - Conjunto de anuncios básico (234567890)
creative_nameNombre del anuncio
ID del anuncio
{fb_install_referrer_adgroup_name}
({fb_install_referrer_adgroup_id})
Banner de verano (345678901)

La manera en que Adjust muestra el parámetro network_name

Nuestro sistema utiliza la siguiente lógica para elaborar los informes del parámetro network_name:

publisher_platformnetwork_name agregado a los informes como:
"facebook", "unknown" o cualquier otra cosaInstalaciones de Facebook
"instagram"Instalaciones de Instagram
"messenger"Instalaciones de Facebook Messenger
"audience_network"Instalaciones fuera de Facebook

Ejemplos 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}

Ejemplo de callback con valores agregados

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

Instalaciones no atribuidas a Meta

Si se adjunta un referente a una instalación y la atribución final se otorga a un socio que no sea Meta, de todas maneras recibirás la información del referente en tus datos.

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