Anuncios del catálogo Advantage+ para apps para celulares

Puedes configurar los anuncios del catálogo Advantage+ en dispositivos móviles con los SDK de Facebook. Debes incorporar enlaces profundos y enlaces profundos diferidos en tu app para proporcionar a las personas que la utilizan la mejor experiencia posible.

Paso 1: Configuración del SDK de Facebook Móvil para iOS o Android

Integra el SDK de Facebook para iOS o Android.

Paso 2: Configuración de eventos de la app para celulares

En la web, utiliza los eventos del píxel de Meta, como ViewContent, para realizar un seguimiento de las interacciones con el evento. En los dispositivos móviles, puedes realizar un seguimiento de los mismos eventos con eventos de la app.

Debes enviar los mismos tres eventos obligatorios desde tu app, tal como lo haces desde el píxel: ViewContent, AddToCart y Purchase. Los anuncios del catálogo Advantage+ necesitan estos eventos para funcionar correctamente.

Evento de iOS	Evento de Android	Equivalente web
`FBSDKAppEventNameViewedContent`	`AppEventsConstants:: EVENT_NAME_VIEWED_CONTENT`	`ViewContent`
`FBSDKAppEventNameAddedToCart`	`AppEventsConstants:: EVENT_NAME_ADDED_TO_CART`	`AddToCart`
`[[FBSDKAppEvents shared] logPurchase:(double) currency:(NSString ) parameters:(NSDictionary )];`	`AppEventsConstants:: EVENT_NAME_PURCHASED`	`Purchase`

Por ejemplo, cuando una persona ve un producto en una app, se activa un evento ViewContent:

[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent
  valueToSum:54.23
  parameters:@{
    FBSDKAppEventParameterNameCurrency    : @"USD",
    FBSDKAppEventParameterNameContentType : @"product",
    FBSDKAppEventParameterNameContentID   : @"123456789"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "1234");

logger.logEvent(AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
                120.00,
                parameters);

También puedes proporcionar una matriz JSON de valores vinculada al identificador de un producto cuando se produce un evento de varios productos. Por ejemplo, puedes enviar varios productos con el evento Purchase.

[[FBSDKAppEvents shared] logPurchase:54.23 currency : @"USD" parameters:@{
  FBSDKAppEventParameterNameContentID   : @"['1234','5678']",
  FBSDKAppEventParameterNameContentType : @"product"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "['1234', '5678']");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASED,
                180.00,
                parameters);

Varios identificadores del contenido

Si tienes varios identificadores del contenido, debes proporcionar una matriz JSON con escape, por ejemplo:

"[\"1234\",\"5678\"]"

Parámetros opcionales

En cada evento de la app, puedes enviar parámetros adicionales. Debes enviarlos cuando una persona realice una compra:

Nombre	Descripción
`_valueToSum` Cadena	Opcional. Valor del importe de la compra o el producto.
`fb_currency` Cadena	Opcional. Divisa del importe de la compra o del producto.

Uso de un socio de medición de dispositivos móviles (MMP)

Si usas un socio de medición de dispositivos móviles (MMP) aprobado para reportar eventos en Facebook, puedes ajustar tu implementación para enviar también los eventos obligatorios. Si bien el proceso varía según el MMP, suele tener el siguiente aspecto:

Ajusta tu integración para reportar los tres eventos obligatorios al MMP, junto con los parámetros obligatorios.
Con tu MMP, asigna los nombres de tus eventos a los nombres de los eventos de Facebook.
Prueba de los eventos de la app.

Eventos obligatorios de MMP

Los siguientes eventos son obligatorios.

Nombre	Descripción
`fb_mobile_content_view`	Cuando una cuenta del centro de cuentas ve un producto
`fb_mobile_add_to_cart`	Cuando se agregó un artículo al carrito.
`fb_mobile_purchase`	Cuando se compraron uno o varios artículos.

También debes enviar dos parámetros adicionales para que los anuncios del catálogo Advantage+ funcionen:

El identificador del artículo visto, agregado al carrito o comprado.
Si el identificador es product o product_group.

Los parámetros adicionales disponibles son los siguientes:

Nombre	Descripción
`fb_content_type` Cadena	`product` o `product_group`
`fb_content_id` Cadena	Obligatorio. Una cadena que contiene una matriz con código JSON del identificador del producto o del grupo de productos del minorista.
`_valueToSum` Cadena	Opcional. El valor del producto comprado.
`fb_currency` Cadena	Opcional. Divisa del importe de la compra o del producto.

Nota: También debes enviar los parámetros _valueToSum y fb_currency cuando una persona compra artículos.

Prueba de los eventos de la app

La forma más fácil de probar si tu integración funciona es usar el asistente para anuncios sobre apps para ver los eventos y parámetros reportados a Facebook en tiempo real.

Selecciona una app.
Luego, verás dos herramientas en la parte inferior de la página. Selecciona Prueba de los eventos de la app.
Existen dos opciones: ver los eventos que reportaste tú mismo o que reportó un identificador publicitario específico. En la mayoría de los casos, seleccionar Yo es suficiente. Asegúrate de tener Facebook instalado en tu dispositivo y de haber iniciado sesión.
A medida que realizas acciones en tu app, los eventos aparecen en la herramienta con sus parámetros.

Verás estos tres nombres de eventos si la integración se realiza correctamente:

FB_MOBILE_CONTENT_VIEW
FB_MOBILE_ADD_TO_CART
FB_MOBILE_PURCHASE

Obtén más información sobre eventos de la app de iOS y Android.

Para verificar la función de eventos de tu app, puedes consultar los eventos recientes en:

Administrador de eventos de Facebook

Paso 3: Configuración de enlaces profundos

Si proporcionas enlaces profundos en tu lista de productos, las personas que interactúen con tu anuncio en Facebook pueden ir directamente a una ubicación específica de tu app. Por ejemplo, cuando una persona hace clic en un anuncio de Facebook en un dispositivo móvil, esta ve el producto en tu app para celulares. Consulta Enlaces profundos y Verificar enlaces profundos para obtener más información.

Redireccionamiento a la web o a App Store

Si utilizas enlaces profundos, puedes especificar el comportamiento de redireccionamiento en el caso de que una persona no tenga la app instalada. Cuando proporcionas enlaces profundos en tu lista de productos, las personas que no tienen la app ven la URL web del producto en el anuncio.

Dado que tu meta probable es aumentar las ventas del catálogo, seguramente desees que las personas vean páginas de productos en vez de ver la app que deben instalar. Por lo tanto, nuestra opción predeterminada es la URL web, aunque puedes especificar un comportamiento diferente para tener un mayor control. Configura el comportamiento de redireccionamiento en applink_treatment cuando crees tus anuncios del catálogo Advantage+ y uses una de estas opciones:

Nombre	Descripción
`web_only`	Se envía siempre a la persona a la URL web proporcionada. Esto reemplaza los enlaces profundos de tu lista.
`deeplink_with_web_fallback`	Si la app está instalada y tenemos tus enlaces profundos correspondientes, se envía a la persona a tu app. Si no se cumple alguna de estas condiciones, se envía a la persona a la URL del sitio web.
`deeplink_with_appstore_fallback`	Si la app está instalada y tenemos la información de los enlaces profundos correspondientes, se envía a la persona a la app. Si la app no está instalada, se envía a la persona a la tienda de apps para que la obtenga.

Paso 4: Configuración de la lista de productos

Ahora, debes proporcionar enlaces profundos reales de los anuncios del catálogo Advantage+. Consulta Catálogo de productos, Enlaces profundos para obtener más información.

Paso 5: Especificaciones de seguimiento

Para medir los eventos de conversión tanto de tu sitio web como de las apps móviles, asegúrate de que los anuncios del catálogo Advantage+ tengan las especificaciones de seguimiento correctas configuradas para estos eventos:

Evento	Especificación del seguimiento
`offsite_conversion`	`{ 'action.type': 'offsite_conversion', 'fb_pixel': FB_PIXEL_ID }`
`app_custom_event`	`{'action.type':'app_custom_event','application':APP_ID}`
`mobile_app_install`	`{'action.type':'mobile_app_install','application':APP_ID}`

Luego, Facebook puede realizar un seguimiento de los eventos que `produzcan a partir de un anuncio del catálogo Advantage+, independientemente de si una persona lo ve desde el sitio web o la app. Para configurar estas especificaciones de seguimiento:

use FacebookAds\Object\Ad;
use FacebookAds\Object\Fields\AdFields;

$ad = new Ad(<AD_ID>);

$ad->{'tracking_spec'} = array(
  array(
    'action.type' => array('app_custom_event'),
    'application' => array($app_id),
  ),
  array(
    'action.type' => array('offsite_conversion'),
    'offsite_pixel' => array(<PIXEL_ID>),
  ),
  array(
    'action.type' => array('mobile_app_install'),
    'application' => array($app_id),
  ),

);
$ad->update();

curl \
  -F 'tracking_spec=[ 
    {"action.type":["app_custom_event"],"application":["101"]}, 
    {"action.type":["offsite_conversion"],"offsite_pixel":["<PIXEL_ID>"]}, 
    {"action.type":["mobile_app_install"],"application":["101"]} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<AD_ID>