Creación de público de bienes inmuebles

A partir del lanzamiento de la versión 15.0 de la API de marketing, ya no podrás crear públicos de anuncios especiales. Para obtener más información, consulta la sección Públicos de anuncios especiales.

Crea un público de bienes inmuebles:

Paso 1: Configurar señales de usuarios para eventos de bienes inmuebles
Paso 2: Asociar señales de usuarios al catálogo
Paso 3: Crear un grupo de orígenes de eventos de bienes inmuebles
Paso 4: Crear públicos de bienes inmuebles

Paso 1: Configurar señales de usuarios para eventos de bienes inmuebles

Son nombres de eventos definidos previamente que puedes enviar desde tu sitio web o app, tanto para medir el rendimiento de tus campañas como para capturar las intenciones de tus públicos. Consulta Configuración del píxel de Facebook.

Los anuncios para bienes inmuebles requieren los siguientes eventos estándar de tu app móvil y el píxel de tu sitio web:

Evento del píxel	Evento de la app	Nivel de obligatoriedad	Descripción
`Search`	`fb_mobile_search`	◉	Una persona buscó anuncios de propiedades.
`ViewContent`	`fb_mobile_content_view`	◉	Una persona vio un anuncio específico.
`InitiateCheckout`	`fb_mobile_initiated_ checkout`	◉	Alguien guardó o indicó que le gusta un anuncio, o mostró un interés especial en él.
`Purchase`	`fb_mobile_purchase`	◉	Alguien se puso en contacto con un agente por un anuncio.

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

Por ejemplo, para reportar un evento de búsqueda de un anuncio con un píxel de Facebook o eventos de la app, coloca este código en la página de los resultados de 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
  }
];

Después de determinar qué eventos deben activarse, debes proporcionar los parámetros de cada evento.

Parámetros de eventos

En la tabla que aparece a continuación, se muestran los parámetros obligatorios y recomendados.

Parámetro del píxel	Parámetro móvil	Nivel de obligatoriedad
`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, p. ej., `'Menlo Park'`.
`content_ids`	`string` o `string[]`	Identificadores en el catálogo de tu anuncio. Por ejemplo, para el evento `ViewContent`, envía el identificador del artículo visto o, para `Search`, envía una matriz de identificadores para los resultados principales: `['1234', '2345', '3456', '4567']`.
`content_type`	`string` o `string[]`	Por ejemplo: `'home_listing'` `['home_listing', 'product']` `['home_listing', 'hotel']`
`country`	`string`	Dirígete al país de interés, p. ej., `'United States'`.
`currency`	`string`	Se especifica con el formato de la divisa ISO 4217: `'USD'`.
`lease_start_date`	`string`	Te permite recomendar propiedades según su disponibilidad de fechas (usando `available_dates_price_config` en el catálogo), y mejorar la experiencia del usuario en la página de destino (usando etiquetas de plantilla). Se especifica con el formato de fecha ISO 8601: `'YYYY-MM-DD'` (por ejemplo, `2018-01-01`).
`lease_end_date`	`string`	Se especifica con el formato de fecha ISO 8601: `'YYYY-MM-DD'` (por ejemplo, `'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`	Barrio de interés: `'Menlo Oaks'`.
`preferred_baths_range`	`[int`(mín.)`, int`(máx.)`]`	Cantidad de baños escogidos como rango: `[1, 2]`.
`preferred_beds_range`	`[int`(mín.)`, int`(máx.)`]`	Cantidad de habitaciones escogidas como rango: `[1, 2]`.
`preferred_price_range`	`[float`(mín.)`, float`(máx.)`]`	Rango de precio: `[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 los orígenes de eventos a cada uno de tus catálogos de anuncios. Consulta la Página del catálogo del administrador comercial. Para seleccionar el píxel y la app mediante la API que envía eventos, utiliza HTTP POST:

curl \
  -F '0=

Especifica los siguientes parámetros:

Nombre del campo	Tipo de datos	Descripción
`external_event_sources` (obligatorio)	`int[]`	Lista de los identificadores de la app y el píxel para asociar al catálogo.

Paso 3: Crear y compartir grupos de orígenes de eventos de bienes inmuebles

Para crear un público, un administrador del negocio debe crear un grupo de orígenes de eventos. Esto agrupa todos los orígenes que envían señales de interés en el anuncio. Utiliza HTTP POST:

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

Luego, comparte este grupo de orígenes de eventos con las cuentas publicitarias que ejecuten anuncios para los públicos generados por estos orígenes de eventos. Utiliza HTTP POST:

curl \
  -F 'accounts=['

Paso 4: Crear públicos

En este punto, tienes señales de eventos de la app o píxeles configurados y asociados con un grupo de orígenes de eventos y tu catálogo de bienes inmuebles. Para dirigirte a las personas interesadas en tus anuncios, crea un público dinámico de personas. Incluye o excluye a personas del público según las señales de intención. También puedes aplicar filtros adicionales basados en reglas para personalizar tu público, como con los públicos personalizados de sitio web. Consulta Públicos personalizados.

Para configurar un nuevo público, utiliza HTTP POST en /act_<AD_ACCOUNT_ID>/customaudiences.

Parámetros obligatorios

Nombre del campo	Tipo de datos	Descripción
`name`	`string`	Nombre del público.
`subtype`	`enum {CLAIM}`	Tipo de público personalizado. Debe configurarse como `CLAIM`.
`claim_objective`	`enum {HOME_LISTING}`	Objetivo del público. Debe configurarse como `HOME_LISTING`.
`event_source_group`	`id`	Grupo de orígenes de eventos para crear el público.
`inclusions`	`object[]`	Matriz de objetos JSON. Muestra cada señal de intención que hace que una persona reúna los requisitos para este público.
Inclusiones: `event` (obligatorio)	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	Nombre del evento de una señal. Se utiliza para la inclusión en el público: `{'event': 'Search', …}`.
Inclusiones: `retention` (obligatorio)	`object`	Cantidad de tiempo mínimo y máximo desde la recepción del evento. Determina si el evento se considera para su inclusión. Ejemplo: `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`. La retención debe ser de, al menos, 4 horas.
Inclusiones: `count`	operadores`JSON`	Cantidad de activaciones del evento. Pueden utilizarse operadores de comparación numéricos y de paridad, como `{…'count': {'lte': 3}, …}`.

Parámetros opcionales

Nombre del campo	Tipo de datos	Descripción
`content_type`	`enum {HOME_LISTING}`	Tipo de señales utilizadas para crear este público.
`description`	`string`	Descripción del público.
`exclusions`	`object[]`	Matriz de objetos JSON que muestran cada señal de intención que incluye a una persona de este público.
Exclusiones: `event` (obligatorio)	`enum { Search, ViewContent, InitiateCheckout, Purchase }`	Nombre del evento de una señal utilizado para la exclusión: `{'event': 'Search', …}`.
Exclusiones: `retention` (obligatorio)	`object`	Cantidad de tiempo mínimo y máximo desde la recepción del evento. Determina si el evento se considera para la exclusión, por ejemplo, `{…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}`. La retención debe ser de, al menos, 4 horas.
`rule`	`object`	Regla de público de públicos personalizados de sitio web. Filtra la transmisión de eventos según estas reglas antes del procesamiento de `inclusions` y `exclusions`. Consulta una lista de campos específicos disponibles. Puedes utilizarlos junto con operadores para reglas de público`JSON` estándar.
Regla: `home_listing_set_id` (obligatorio)	`object`	Identificador del conjunto del anuncio: `{'eq': '1234'}}`

Por ejemplo, para crear un público dirigido a las personas que vieron o compraron en 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=