Públicos personalizados de interacción

Crea públicos en función de las personas que interactuaron con tu contenido en Facebook o Instagram. Los tipos de público que se admiten actualmente son los siguientes: página, perfil de empresa de Instagram, anuncios para clientes potenciales, anuncios de experiencia instantánea, compras y realidad aumentada.

En esta guía, se describe la API usando como ejemplo los públicos de interacción con la página. En el caso de interacciones con páginas, Facebook actualiza el público personalizado agregando de forma continua a personas que interactúan con tu página. Cuando crees este público por primera vez, Facebook lo completará previamente con una lista de personas que ya interactuaron con tu página en el período de retención determinado.

Desde septiembre de 2018, no admitimos subtype para públicos personalizados de sitios web, apps, públicos personalizados de interacción ni públicos obtenidos a partir de datos de conversión offline. La excepción es que aún se admite subtype para públicos personalizados de interacción en el caso de videos.
Si creas públicos de Europa o personas objetivo en Europa, consulta nuestros cambios sin revisión del 2 de diciembre de 2020.

Crear un público

Para crear un público personalizado de interacción, en tu cuenta publicitaria se deben aceptar las Condiciones del servicio para públicos personalizados dentro del administrador de anuncios.

Para crear un público en el que figuren las personas que interactuaron con tu página según el evento page_engaged:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Parámetros

Nombre	Descripción
`name` Cadena	Obligatorio. Nombre del público personalizado.
`rule` Objeto JSON	Obligatorio. Reglas para definir el público. Usa la misma sintaxis que el público personalizado del sitio web.

Los públicos personalizados de interacción son tipos de públicos personalizados. Para conocer todos los campos disponibles, consulta la referencia sobre públicos personalizados.

Nota: Cada cuenta publicitaria puede crear un máximo de 500 públicos personalizados.

Reglas de interacción

Puedes determinar si Facebook agrega a alguien al público personalizado o no mediante las reglas de público.

Especifica los campos type e id en event_sources de la regla para indicar el type y el id del objeto de interacción. El campo id admite un solo identificador de objeto o una matriz de identificadores del mismo tipo.

Estos son los identificadores de orígenes de eventos y objetos de interacción correspondientes que se admiten:

page: identificador de página de Facebook
lead: identificador de formulario de cliente potencial
ig_lead_generation: identificador de formulario de cliente potencial
canvas: identificador de Canvas
ig_business: identificador de perfil de empresa de Instagram
shopping_page: identificador de página de tienda de Facebook
shopping_ig: identificador de tienda de Instagram
ar_experience: una experiencia instantánea que usa un efecto de realidad aumentada
ar_effects: un efecto de Facebook o Instagram del que eres propietario (no incluye efectos utilizados en anuncios)

Cada regla consta de un object_id y un event_name.

Páginas

Configura object_id con el identificador de tu página. En event_name, usa uno de los siguientes eventos de interacción:

page_engaged: personas que visitaron tu página o que interactuaron con el contenido o los anuncios de la página, en Facebook o Messenger. Es el tipo de interacción más inclusivo y abarca todos los otros tipos de interacción.
page_visited: personas que visitaron tu página.
page_liked: personas a las que actualmente les gusta tu página. (Consulta la información sobre retención y reglas relacionadas con los Me gusta de la página).
page_messaged: personas que enviaron un mensaje a la página.
page_cta_clicked: personas que hicieron clic en cualquier botón de llamada a la acción de tu página (por ejemplo, "Contactarnos" o "Comprar").
page_or_post_save: personas que guardaron la página o alguna publicación de esta.
page_post_interaction: personas que interactuaron con alguna publicación de la página. Las interacciones incluyen reacciones (Me gusta, Me encanta, Me divierte, Me asombra, Me entristece, Me enoja) y si el usuario compartió contenido, hizo comentarios, hizo clic en enlaces o deslizó el dedo por secuencias.

Anuncios para clientes potenciales

Debes configurar object_id en FORM_ID y definir que rule realice un seguimiento de alguno de los eventos de anuncios para clientes potenciales que figuran a continuación:

lead_generation_submitted: todos los usuarios que completaron el formulario y lo enviaron.
lead_generation_dropoff: todas las personas que cerraron el formulario sin enviarlo. Pueden haber completado algún campo o no.
lead_generation_opened: todas las personas que abrieron el formulario de generación de clientes potenciales, independientemente de si lo enviaron o no.

Experiencias instantáneas

Fija object_id en el valor "CANVAS_ID". La rule debe hacer un seguimiento de uno de los siguientes eventos:

instant_shopping_document_open
instant_shopping_document_pause
instant_shopping_document_resume
instant_shopping_document_close
instant_shopping_did_scroll
instant_shopping_element_click
instant_shopping_element_impression

Perfil de empresa de Instagram

object_id debe ser "INSTAGRAM_BUSINESS_PROFILE_ID", y rule debe realizar un seguimiento de alguno de los eventos de perfil de empresa de Instagram que figuran a continuación:

ig_business_profile_all: las personas que visitaron tu perfil de empresa de Instagram o que interactuaron con el contenido o los anuncios de tu perfil de empresa de Instagram. Es el tipo de interacción más inclusivo y abarca todos los otros tipos de interacción. Es una unión de ig_business_profile_engaged, ig_user_messaged_business y ig_user_messaged_business.
ig_business_profile_engaged: personas que interactuaron con tu perfil de empresa de Instagram o con el contenido o los anuncios de tu perfil de empresa de Instagram.
ig_user_messaged_business: personas que enviaron mensajes a tu perfil de empresa de Instagram.
ig_business_profile_visit: personas que visitaron tu perfil de empresa de Instagram.
ig_business_profile_ad_saved: personas que guardaron contenido orgánico o anuncios de tu perfil de empresa de Instagram.
ig_ad_like
ig_ad_comment
ig_ad_share
ig_ad_save
ig_ad_cta_click
ig_ad_carousel_swipe
ig_organic_like
ig_organic_comment
ig_organic_share
ig_organic_save
ig_organic_swipe
ig_organic_carousel_swipe

Actualmente, el tipo de creador de contenido multimedia de Instagram no es compatible para la creación de públicos personalizados de interacción con video.

Compras

Una regla de interacción de compra debe hacer un seguimiento de uno de los siguientes eventos:

VIEW_CONTENT: personas que hayan visto tu página de detalles de productos. Esta opción está disponible en todo el mundo.
ADD_TO_CART: personas que hayan agregado tu producto a su carrito de compras. Esto se encuentra disponible únicamente para negocios con compras habilitadas y consumidores de Estados Unidos.
PURCHASE: personas que compraron tus productos. Esto se encuentra disponible únicamente para negocios con compras habilitadas y consumidores de Estados Unidos.

Para crear una regla que agregue personas que hayan visto tu producto:

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Es posible que los parámetros page_messaged y ig_user_messaged_business no estén disponibles en Europa debido a las nuevas reglas de privacidad.

Realidad aumentada

Los públicos personalizados de interacción con realidad aumentada pueden contener dos partes: experiencia de AR o efecto de AR.

En el caso del público personalizado de interacción con la experiencia de realidad aumentada, configura el object_id en el identificador del contenedor de datos de anuncios de AR y, para el event_name archivado, usa ar_camera_open o camera_cta_click.
En el caso del público personalizado de interacción con efecto de AR, configura object_id en el identificador del efecto de AR y usa ar_effect_open para el campo event_name.

Días de retención máximos

Por razones jurídicas y de privacidad, permitimos distintas cantidades máximas de días de retención por cada tipo de origen de evento:

Anuncios de generación de clientes potenciales: 90 días
Perfil de empresa de Instagram: 730 días
Página: 730 días
- Nota: El público de los Me gusta de la página no tiene retención
Experiencias instantáneas, conocidas previamente como "Canvas": 730 días
Compras: 365 días. Los datos se encuentran disponibles desde abril de 2020.
Realidad aumentada: 365 días

Sección de reglas de interacción con exclusión

Las reglas de público de interacción son compatibles con las reglas de públicos personalizados de sitios web. Por lo tanto, pueden tener varias reglas de inclusión y exclusión. Los usuarios que coincidan al menos con una de las reglas se agregarán al público.

En el siguiente ejemplo, creamos un público que incluye usuarios que visitaron la página o interactuaron con ella, pero excluye a los que hicieron clic en la llamada a la acción:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Para obtener más información, consulta Públicos personalizados de tu sitio web.

Varias reglas

Los públicos de interacción pueden tener varias reglas de interacción, y los usuarios que coincidan con al menos una de las reglas se agregarán al público. El siguiente es un ejemplo de cómo crear un público que incluya usuarios que enviaron mensajes a la página o hicieron clic en una llamada a la acción:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Varias páginas

Las reglas no se limitan a una página. Puedes tener una página diferente para cada regla y nosotros incluiremos en el público a las personas que interactuaron con al menos una de las páginas.

El siguiente es un ejemplo de un público que incluye a todas las personas que visitaron al menos una de tres páginas:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Para obtener información detallada sobre los públicos personalizados, consulta la referencia sobre públicos personalizados.

Retención y reglas de los Me gusta de la página

El público de los Me gusta de la página no tiene retención (retention_seconds=0). Además, las reglas de las páginas no se pueden combinar con otros eventos de la página.

A continuación, verás un ejemplo de creación de público de los Me gusta de la página:

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences