Audiencias personalizadas de interacción

Crea audiencias basadas en las personas que han interactuado con tu contenido en Facebook o Instagram. Actualmente, los tipos de audiencia que se admiten son los siguientes: página, perfil de empresa de Instagram, anuncios para clientes potenciales, anuncios de experiencias instantáneas, compras y realidad aumentada.

En esta guía se describe la API y, para ello, se utilizan las audiencias de interacción con páginas como ejemplo. Facebook actualiza tu audiencia personalizada para las interacciones de la página mediante la adición continua de personas que interactúan con tu página. Al crear este público por primera vez, Facebook lo rellena previamente con una lista de personas que ya han interactuado con tu página durante el período de retención especificado.

Desde septiembre de 2018, no admitimos subtype para las audiencias personalizadas de sitios web, aplicaciones, audiencias personalizadas de interacción y audiencias creadas a partir de datos de conversión offline. La excepción es que subtype se admite para las audiencias personalizadas de interacción de vídeo.
Si creas audiencias de Europa o segmentas a personas de Europa, consulta nuestro cambio sin versión del 2 de diciembre de 2020.

Creación de audiencias

Para crear una audiencia personalizada de interacción, deben aceptarse las Condiciones del servicio de las audiencias personalizadas de la cuenta publicitaria en el administrador de anuncios.

Para crear una audiencia con personas que han interactuado con tu página según el evento page_engaged, utiliza el código siguiente:

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 de la audiencia personalizada.
`rule` objeto JSON	Obligatorio. Reglas para definir la audiencia. Sigue la misma sintaxis que la audiencia personalizada del sitio web.

Las audiencias personalizadas de interacción son tipos de audiencias personalizadas. Para conocer todos los campos disponibles, consulta la referencia sobre las audiencias personalizadas.

Nota: Cada cuenta publicitaria puede crear un máximo de 500 audiencias personalizadas de interacción.

Reglas de interacción

Puedes determinar si Facebook añade a alguien a la audiencia personalizada con las reglas de audiencia.

Especifica los campos type e id en event_sources en la regla para indicar los valores de type e id del objeto de interacción. El campo id toma el identificador de objeto único o una matriz de identificadores del mismo tipo.

Los siguientes son los orígenes de eventos admitidos y los identificadores de objetos de interacción correspondientes:

page: identificador de la página de Facebook.
lead: identificador del formulario de cliente potencial.
ig_lead_generation: identificador del formulario de cliente potencial.
canvas: identificador de Canvas
ig_business: identificador del perfil de empresa de Instagram.
shopping_page: identificador de la página de la tienda de Facebook.
shopping_ig: identificador de la tienda de Instagram.
ar_experience: experiencia instantánea que usa efectos de realidad aumentada.
ar_effects: efecto de Facebook o Instagram del que eres propietario. No incluye los efectos usados en los anuncios.

Cada regla consta de los objetos object_id y event_name.

Páginas

Establece object_id en tu identificador de página. En event_name, utiliza uno de los eventos de interacción siguientes:

page_engaged: personas que visitaron tu página o interactuaron con alguno de los anuncios o los contenidos de tu página en Facebook o Messenger. Este es el tipo de interacción más inclusivo y abarca todos los demás 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 los detalles sobre retención y las reglas relacionadas con los Me gusta de la página).
page_messaged: personas que han enviado un mensaje a tu página.
page_cta_clicked: personas que han hecho clic en cualquier botón de llamada a la acción de tu página; por ejemplo, “Contactar” o “Comprar”.
page_or_post_save: personas que han guardado tu página o cualquiera de tus publicaciones de la página.
page_post_interaction: personas que han interactuado con alguna de tus publicaciones de la página. Las interacciones incluyen reacciones (Me gusta, Me encanta, Me divierte, Me asombra, Me entristece o Me enfada), publicaciones compartidas, comentarios, clics en el enlace o deslizamientos de dedo en secuencias.

Anuncios para clientes potenciales

Establece object_id en FORM_ID y el valor de rule para hacer un seguimiento de los siguientes eventos de anuncios para clientes potenciales:

lead_generation_submitted: todos los usuarios que han completado y enviado el formulario.
lead_generation_dropoff: todas las personas que cierran el formulario sin enviarlo. Puede que hayan rellenado algún campo o que no lo hayan hecho.
lead_generation_opened: todas las personas que han abierto el formulario de generación de clientes potenciales, independientemente de si lo han enviado.

Experiencias instantáneas

Establece object_id en "CANVAS_ID". rule debe realizar un seguimiento de uno de los eventos siguientes:

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 establecerse en el valor de "INSTAGRAM_BUSINESS_PROFILE_ID", mientras que rule debe hacer un seguimiento de los siguientes eventos del perfil de empresa de Instagram:

ig_business_profile_all: personas que visitaron tu perfil de empresa de Instagram o que interactuaron con alguno de los contenidos o anuncios de tu perfil de empresa de Instagram. Este es el tipo de interacción más inclusivo y abarca todos los demás tipos de interacción. Se trata de una unión de ig_business_profile_engaged, ig_user_messaged_business e ig_user_messaged_business.
ig_business_profile_engaged: personas que interactuaron con tu perfil de empresa de Instagram o con alguno de los contenidos o 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 se admite para la creación de audiencias personalizadas de interacción de vídeo.

Compras

La regla de interacción de compras debe hacer un seguimiento de los eventos siguientes:

VIEW_CONTENT: personas que han visto la página de detalles del producto. La opción está disponible en todo el mundo.
ADD_TO_CART: personas que han añadido tu producto en su carrito de la compra. Solo está disponible para las empresas que tienen las compras activadas y para los consumidores de Estados Unidos.
PURCHASE: personas que han comprado tus productos. Solo está disponible para las empresas que tienen las compras activadas y para los consumidores de Estados Unidos.

Para crear una regla que añada a personas que han 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 e ig_user_messaged_business no estén disponibles en Europa debido a las nuevas reglas de privacidad.

Realidad aumentada

Las audiencias personalizadas de interacción de realidad aumentada pueden contener dos partes: la experiencia de realidad aumentada y el efecto de realidad aumentada.

Para crear una audiencia personalizada de interacción de experiencia de realidad aumentada, establece object_id en el identificador del contenedor de datos de los anuncios de AR. Para el campo event_name, utiliza ar_camera_open o camera_cta_click.
Para crear una audiencia personalizada de interacción de efecto de realidad aumentada, establece object_id en el identificador del efecto de AR y utiliza ar_effect_open para el campo event_name.

Máximo de días de retención

En el caso de los requisitos legales y de privacidad, permitimos un número máximo de días de retención distinto para 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: La audiencia de los Me gusta de la página no tiene retención.
Experiencias instantáneas, anteriormente conocidas como Canvas: 730 días
Compras: 365 días. Los datos están disponibles desde abril de 2020.
Realidad aumentada: 365 días

Reglas de interacción con sección de exclusiones

Las reglas de la audiencia de interacción son compatibles con las de la audiencia personalizada del sitio 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 añadirán a la audiencia.

En el ejemplo siguiente, creamos una audiencia que incluye a los usuarios que visitaron tu página o interactuaron con esta, pero excluye a aquellas personas 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 Audiencias personalizadas de tu sitio web.

Varias reglas

Las audiencias de interacción pueden tener varias reglas y los usuarios que coincidan con al menos una de estas reglas se añadirán a la audiencia. A continuación, te mostramos un ejemplo de cómo crear una audiencia que incluya a los usuarios que enviaron mensajes a la página o 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"
                 },
                 {
                   "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 están limitadas a una sola página. Puedes tener una página diferente para cada regla, y las personas que han interactuado como mínimo con una de las páginas, y las incluiremos en la audiencia.

A continuación, te mostramos un ejemplo de una audiencia que incluye todas las personas que visitaron como mínimo una de las 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 detalles sobre las audiencias personalizadas, consulta la referencia de audiencia personalizada.

Reglas y retención de Me gusta de la página

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

A continuación, puedes ver un ejemplo de cómo crear una audiencia de 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