Anuncios de catálogo de Advantage+ para aplicaciones para móviles

Puedes configurar los anuncios de catálogo de Advantage+ para móviles con los SDK de Facebook. Debes incorporar los enlaces profundos y los enlaces profundos diferidos en tu aplicación para proporcionar a los usuarios que usan tu aplicación 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 aplicación para móviles

En la web, utiliza eventos del píxel de Meta, como ViewContent, para hacer un seguimiento de las interacciones con los eventos. En el móvil, puedes realizar un seguimiento de los mismos eventos con eventos de la aplicación.

Debes enviar los mismos tres eventos necesarios de la aplicación que del píxel: ViewContent, AddToCart y Purchase. Los anuncios de catálogo de Advantage+ requieren 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, un evento ViewContent se activa cuando alguien ve un producto en una aplicación:

[[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 de valores JSON para el identificador de producto cuando un evento se aplica a 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 de contenido

Si tienes varios identificadores de contenido, debes proporcionar una matriz JSON con escape, como la siguiente:

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

Parámetros opcionales

Para cada evento de la aplicación, puedes enviar parámetros adicionales. Debes enviarlos cuando alguien realice una compra:

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

Uso de un socio de evaluación de la actividad en móviles (MMP)

Si usas un socio de evaluación de la actividad en móviles (MMP) aprobado para notificar eventos en Facebook, puedes ajustar tu implementación para enviar también los eventos obligatorios. Aunque el proceso varía según el MMP, normalmente tiene el aspecto siguiente:

Ajusta la integración para notificar los tres eventos requeridos al MMP, junto con los parámetros requeridos.
Con tu MMP, asigna los nombres de tus eventos a los nombres de los eventos de Facebook.
Probar los eventos de la aplicación.

Eventos obligatorios para MMP

Los eventos siguientes son obligatorios:

Nombre	Descripción
`fb_mobile_content_view`	Cuando una cuenta del Centro de Cuentas ha visto un producto.
`fb_mobile_add_to_cart`	Cuando se ha añadido un artículo al carrito.
`fb_mobile_purchase`	Cuando se han comprado uno o varios artículos.

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

El identificador del artículo que se ha visto, añadido al carrito o comprado.
Si el identificador es un product o un product_group.

Los parámetros adicionales disponibles son:

Nombre	Descripción
`fb_content_type` Cadena	`product` o `product_group`
`fb_content_id` Cadena	Obligatorio. Cadena con una matriz codificada con JSON de los identificadores del producto o del grupo de productos del minorista.
`_valueToSum` Cadena	Opcional. Valor del producto comprado.
`fb_currency` Cadena	Opcional. Divisa del producto o el importe de la compra.

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

Prueba de eventos de la aplicación

La forma más sencilla de probar si funciona la integración es el asistente para anuncios sobre aplicaciones para ver los eventos y parámetros que se han notificado a Facebook en tiempo real.

Selecciona una aplicación.
Podrás observar dos herramientas en la parte inferior de la página. Selecciona Probar los eventos de la aplicación.
Existen dos opciones: ver los eventos que has comunicado tú mismo o usar un identificador de publicidad específico. En la mayoría de los casos, seleccionar Yo será suficiente. Asegúrate de tener Facebook descargado en el dispositivo y de haber iniciado sesión.
A medida que realizas acciones en tu aplicación, los eventos aparecen en la herramienta con sus parámetros.

Se ven estos tres nombres de evento si la integración se ha realizado correctamente:

FB_MOBILE_CONTENT_VIEW
FB_MOBILE_ADD_TO_CART
FB_MOBILE_PURCHASE

Obtén más información acerca de los eventos de la aplicación para iOS y Android.

Para verificar la función de eventos de la aplicación, puedes comprobar los eventos recientes en

administrador de eventos de Facebook

Paso 3: Configuración de enlaces profundos

Al proporcionar enlaces profundos en tu lista de productos, cualquier persona que interactúe con tu anuncio en Facebook puede ir directamente a una ubicación específica de tu aplicación. Por ejemplo, cuando alguien hace clic en un anuncio en Facebook en el móvil, ve el producto en tu aplicación para móviles. Consulta Enlaces profundos y Verificar los enlaces profundos para obtener más información.

Reserva para web frente a App Store

Si usas enlaces profundos, puedes especificar el comportamiento de reserva si alguien no tiene tu aplicación descargada. Si proporcionas enlaces profundos en tu lista de productos, las personas que no tengan tu aplicación verán la URL web del producto en el anuncio.

Dado que tu objetivo es, probablemente, aumentar las ventas del catálogo, querrás que los usuarios vean páginas de productos en lugar de tu aplicación para descargarla. Por tanto, se muestran por defecto las URL web, aunque puedes especificar otro comportamiento para aumentar el control. Define el comportamiento de reserva en applink_treatment cuando crees tu anuncio de catálogo de Advantage+ y utiliza una de estas opciones:

Nombre	Descripción
`web_only`	Siempre se envía a alguien a la URL web proporcionada. Esto invalida los enlaces profundos de tu lista.
`deeplink_with_web_fallback`	Si la aplicación está instalada y tenemos los enlaces profundos correspondientes, se envía a alguien a tu aplicación. Si alguna de estas condiciones no se cumple, se envía a esta persona a la URL del sitio web.
`deeplink_with_appstore_fallback`	Si la aplicación está instalada y tenemos la información de enlaces profundos correspondiente, se envía a alguien a la aplicación. Si la aplicación no está instalada, se envía a esta persona a la tienda de aplicaciones para que la obtenga.

Paso 4: Configuración de la lista de productos

Ahora debes proporcionar enlaces profundos reales para los anuncios de catálogo de 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 del sitio web y las aplicaciones para móviles, asegúrate de que cualquier anuncio de catálogo de Advantage+ tenga las Especificaciones de seguimiento correctas establecidas para estos eventos:

Evento	Especificación de 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}`

A continuación, Facebook puede realizar un seguimiento de todos los eventos que se produzcan desde un anuncio de catálogo de Advantage+, independientemente de si se visualiza en el sitio web o la aplicación. Para establecer 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>