Crear una audiencia del sector inmobiliario

A partir de la versión 15.0 de la API de marketing, ya no podrás crear audiencias de anuncios especiales. Consulta Audiencias de anuncios especiales para obtener más información.

Crea una audiencia del sector inmobiliario:

Paso 1: Configurar señales de usuario para eventos del sector inmobiliario
Paso 2: Asociar señales de usuario al catálogo
Paso 3: Crear un grupo de orígenes de eventos del sector inmobiliario
Paso 4: Crear audiencias del sector inmobiliario

Paso 1: Configurar señales de usuario para eventos del sector inmobiliario

Son nombres de evento predefinidos que puedes enviar desde tu sitio web o aplicación y que te permiten medir el rendimiento de tus campañas y capturar la intención de las audiencias. Consulta la configuración del píxel de Facebook.

Los anuncios del sector inmobiliario requieren los siguientes eventos estándar del píxel del sitio web y la aplicación para móviles:

Evento del píxel	Evento de la aplicación	Nivel del requisito	Descripción
`Search`	`fb_mobile_search`	◉	Alguien ha buscado anuncios de viviendas.
`ViewContent`	`fb_mobile_content_view`	◉	Alguien ha visualizado un anuncio específico.
`InitiateCheckout`	`fb_mobile_initiated_ checkout`	◉	Alguien ha guardado o ha indicado que le gusta un anuncio o ha mostrado un interés especial por un anuncio.
`Purchase`	`fb_mobile_purchase`	◉	Alguien ha contactado con un agente en relación con un anuncio.

◉ Obligatorio: los anuncios no funcionarán sin estos parámetros.
◎ Recomendado: no es estrictamente necesario, pero permite mejores recomendaciones y más opciones de segmentación para los anuncios. Proporciona tantos como sea posible.
◯ Opcional: no es obligatorio y se puede ignorar.

Por ejemplo, para notificar un evento Search para un anuncio usando el píxel de Facebook o los eventos de la aplicación, coloca este código en tu página de resultados de la búsqueda:

<!-- Facebook Pixel Code -->

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "home_listing");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "[\"1234\", \"2345\", \"3456\", \"4567\"]"); // top search results

// we must prefix all travel-specific parameters with fb_
parameters.putString("fb_city", "New York City"); // Required for Search event
parameters.putString("fb_region", "New York"); // region is the state for the US. Required for Search event
parameters.putString("fb_country", "US"); // Required for Search event

logger.logEvent(
  AppEventsConstants.EVENT_NAME_SEARCHED,
  parameters
);

[FBSDKAppEvents logEvent:FBSDKAppEventNameSearched
  parameters:@{
    FBSDKAppEventParameterNameContentType : @"home_listing",
    FBSDKAppEventParameterNameContentID : @"[\"1234\", \"2345\", \"3456\", \"4567\"]", // top search results
		// we must prefix all travel-specific parameters with fb_
		@"fb_city" : @"New York City", //Required for Search event
	  @"fb_region" : @"New York", // region is the state for the US. Required for Search event
	  @"fb_country" : @"US", // Required for Search event
  }
];

Una vez determinados los eventos que deben activarse, deberías proporcionar los parámetros de cada uno de ellos.

Parámetros de eventos

En la tabla siguiente, se muestran los parámetros obligatorios y recomendados.

Parámetro del píxel	Parámetro del móvil	Nivel del requisito
`content_ids`	`fb_content_id`	◉
`content_type`	`fb_content_type`	◯
`lease_start_date`		◎
`lease_end_date`		◎
`preferred_baths_range`		◎
`preferred_beds_range`		◎
`preferred_price_range`		◎
`currency`	`fb_currency`	◎
`property_type`		◎
`listing_type`		◎
`availability`		◎
`city`	`fb_city`	◎
`neighborhood`		◎
`region`	`fb_region`	◎
`country`	`fb_country`	◎

Detalles del parámetro

Nombre del parámetro	Tipo de datos	Descripción
`availability`	`string`	El valor debe ser `available_soon`, `for_rent`, `for_sale`, `off_market`, `recently_sold` o `sale_pending`.
`city`	`string`	Proporciona la ciudad de interés del usuario, como `'Menlo Park'`
`content_ids`	`string` o `string[]`	Cualquier identificador del catálogo de anuncios. Por ejemplo, para el evento `ViewContent`, envía el identificador del elemento visualizado. O bien, para el evento `Search`, envía una matriz de identificadores de los resultados destacados: `['1234', '2345', '3456', '4567']`
`content_type`	`string` o `string[]`	Ejemplo: `'home_listing'` `['home_listing', 'product']` `['home_listing', 'hotel']`
`country`	`string`	País de interés de destino, como `'United States'`
`currency`	`string`	Se especifica con el formato de divisa ISO 4217: `'USD'`
`lease_start_date`	`string`	Nos permite recomendar propiedades en función de la disponibilidad de fecha (mediante el valor de `available_dates_price_config` del catálogo) y mejorar la experiencia de destino del usuario (mediante etiquetas de plantilla). Especificado mediante el formato de fecha ISO 8601: `'YYYY-MM-DD'` (p. ej., `2018-01-01`).
`lease_end_date`	`string`	Especificado mediante el formato de fecha ISO 8601: `'YYYY-MM-DD'` (p. ej., `'2018-02-01'`).
`listing_type`	`string`	El valor debe ser `for_rent_by_agent`, `for_rent_by_owner`, `for_sale_by_agent`, `for_sale_by_owner`, `foreclosed`, `new_construction` o `new_listing`.
`neighborhood`	`string`	Comunidad local de interés: `'Menlo Oaks'`
`preferred_baths_range`	`[int`(mín.)`, int`(máx.)`]`	Número de baños elegido como intervalo: `[1, 2]`
`preferred_beds_range`	`[int`(mín.)`, int`(máx.)`]`	Número de dormitorios elegido como intervalo: `[1, 2]`
`preferred_price_range`	`[float`(mín.)`, float`(máx.)`]`	Intervalo de precios: `[1000.99, 2000.99]`
`property_type`	`string`	Debe ser `apartment`, `condo`, `house`, `land`, `manufactured`, `other` o `townhouse`.
`region`	`string`	Estado, distrito o región de interés: `'California'`

Paso 2: Asociar señales al catálogo de anuncios

Asocia tus orígenes de eventos a cada uno de tus catálogos de anuncios. Consulta la página del catálogo de Business Manager. Para seleccionar el píxel y la aplicación a través de la API que envía eventos, realiza una solicitud HTTP POST:

curl \
  -F '0=

Especifica estos parámetros:

Nombre del campo	Tipo de datos	Descripción
`external_event_sources` (obligatorio)	`int[]`	Lista de los identificadores de la aplicación y del píxel que se asociarán con el catálogo

Paso 3: Crear y compartir grupos de orígenes de eventos del sector inmobiliario

Para crear una audiencia, un administrador de tu empresa debe crear un grupo de orígenes de eventos. Este agrupa todos tus orígenes que envían señales de interés de anuncios. Creación de una solicitud HTTP POST:

curl \
  -F 'name=My Real Estate Company Events' \
  -F 'event_sources=['

A continuación, comparte este grupo de orígenes de eventos con todas las cuentas publicitarias que ejecutarán anuncios para audiencias generadas por dichos orígenes de eventos. Creación de una solicitud HTTP POST:

curl \
  -F 'accounts=['

Paso 4: Crear audiencias

En este momento, tienes señales de píxeles o eventos de la aplicación configuradas y asociadas a un grupo de orígenes de eventos y al catálogo de bienes inmuebles. Para dirigirte a personas interesadas en tus anuncios, crea una audiencia dinámica de personas. Incluye o excluye personas de la audiencia en función de las señales de interés. También puedes aplicar filtros basados en reglas adicionales para personalizar tu audiencia, igual que con las audiencias personalizadas del sitio web. Consulta Audiencias personalizadas.

Para configurar una audiencia nueva, realiza una solicitud HTTP POST a /act_<AD_ACCOUNT_ID>/customaudiences.

Parámetros necesarios

Nombre del campo	Tipo de datos	Descripción
`name`	`string`	Nombre de la audiencia.
`subtype`	`enum {CLAIM}`	Tipo de audiencia personalizada. Se debe establecer en `CLAIM`.
`claim_objective`	`enum {HOME_LISTING}`	Objetivo de la audiencia. Se debe establecer en `HOME_LISTING`.
`event_source_group`	`id`	Grupo de orígenes de eventos para crear la audiencia.
`inclusions`	`object[]`	Matriz de objetos JSON. Muestra cada señal de intención que hace que alguien sea apto para esta audiencia.
inclusions: `event` (obligatorio)	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	Nombre de evento de una señal. Se utiliza para la inclusión en una audiencia: `{'event': 'Search', …}`.
inclusions: `retention` (obligatorio)	`object`	Cantidad mínima y máxima de tiempo desde la recepción del evento. Determina si el evento se ha considerado para la inclusión. Ejemplo: `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`. La retención debe ser de cuatro horas como mínimo.
inclusions: `count`	Operadores`JSON`	Número de veces que se ha activado el evento. Puedes utilizar operadores de comparación de igualdad y numéricos, como `{…'count': {'lte': 3}, …}`.

Parámetros opcionales

Nombre del campo	Tipo de datos	Descripción
`content_type`	`enum {HOME_LISTING}`	Tipo de señales usado para crear esta audiencia.
`description`	`string`	Descripción de la audiencia.
`exclusions`	`object[]`	Matriz de objetos JSON que enumeran cada una de las señales de intención que excluye a alguien de esta audiencia.
exclusions: `event` (obligatorio)	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	Nombre de evento de una señal utilizada para la exclusión: `{'event': 'Search', …}`.
exclusions: `retention` (obligatorio)	`object`	Cantidad mínima y máxima de tiempo desde la recepción del evento. Determina si el evento se ha considerado para la exclusión; por ejemplo, `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`. La retención debe ser de 4 horas como mínimo.
`rule`	`object`	Regla de audiencia de las audiencias personalizadas del sitio web. Filtra la transmisión de eventos por estas reglas antes de procesar `inclusions` y `exclusions`. Consulta una lista de los campos específicos disponibles. Se pueden utilizar con cualquier operador `JSON` estándar de las reglas de audiencia.
rule: `home_listing_set_id` (obligatorio)	`object`	Identificador del conjunto de anuncios: `{'eq': '1234'}}`

Por ejemplo, para crear una audiencia dirigida a personas que han visualizado o comprado algún producto los últimos 14 días:

curl \
  -F 'name=Viewed or Purchased Last 14 days' \
  -F 'subtype=CLAIM' \
  -F 'claim_objective=HOME_LISTING' \
  -F 'content_type=HOME_LISTING' \
  -F 'event_source_group=