En lo que respecta al comercio, para publicar anuncios de bienes raíces, es necesario que tu negocio esté verificado.
Paso 1: Crear un catálogo de anuncios de viviendas.
Paso 2: Configurar anuncios y precios.
Paso 3: Opciones de actualización.
Paso 4: Filtrar el catálogo de anuncios para ver el conjunto de anuncios.
Paso 5: Enviar conversiones offline (opcional)
Paso 6: Crear tu público de bienes raíces. A diferencia de lo que sucede con los anuncios de bienes raíces publicados por los usuarios, en el caso de las integraciones de socios, se envían los clientes potenciales a los socios mediante un formulario para clientes potenciales en vez de enviarse por un chat de Messenger. Obtén más información sobre cómo recuperar de clientes potenciales para el comercio.
Paso 7: Crear y entregar anuncios relacionados con viviendas.
Paso 8: Obtener información de entrega para ver la forma en que la gente en Facebook interactúa con tus anuncios. Consultar estadísticas de anuncios.
Paso 9: Usar herramientas de depuración para diagnosticar y resolver problemas. Consulta Herramientas de depuración de anuncios del catálogo Advantage+.
Tu catálogo debería contener una lista de propiedades que quieres anunciar. Consultar referencia del catálogo.
Para crear un catálogo de viviendas relacionado con los anuncios de catálogo Advantage+, configura vertical
en home_listings
:
curl \
-F 'name=Home Listing Catalog Name' \
-F 'vertical=home_listings' \
-F 'access_token=<ACCESS TOKEN>' \
https://graph.facebook.com/<API_VERSION>
Para usar la API de catálogo, necesitas nivel de acceso a la API de marketing y aceptar las Condiciones de servicio creando tu primer catálogo mediante el administrador comercial.
Para obtener instrucciones sobre cómo crear un catálogo para el comercio, consulta la documentación de la plataforma de Marketplace.
Tus anuncios contienen información sobre propiedades, como identificación del anuncio, nombre, disponibilidad, descripción, dirección, habitaciones, baños, etc. Puedes tener un conjunto de anuncios subido o extraído de tu negocio. El artículo de un anuncio es una sola propiedad que se presenta en tu sitio web o en tu app.
Puedes tener una única lista para todas las propiedades de tu catálogo, o bien, tener varias, donde una represente las propiedades de un único país, una única agencia inmobiliaria o un único agente inmobiliario.
Para los anuncios de catálogo Advantage+, debes proporcionar la lista de anuncios en alguno de estos formatos:
Formato de archivo | Descripción | Archivo de muestra |
---|---|---|
XML | Normalmente, se genera mediante sistemas de proveedores de listas automatizadas. Un nodo XML | |
CSV, TSV | En la primera fila, debes mencionar los nombres de los campos elegidos en el orden en el que se presentarán los valores. Las filas siguientes proporcionan los valores correspondientes de cada anuncio de viviendas. Los campos anidados o con varios valores, como imagen, pueden representarse con valores con código JSON o con un conjunto de columnas de texto sin formato "aplanadas", etiquetadas con sintaxis de ruta JSON, como | Descargar (CSV) |
Para el comercio, debes proporcionar la lista de anuncios en formato XML:
Formato de archivo | Descripción |
---|---|
XML | Normalmente, se genera mediante sistemas de proveedores de listas automatizadas. Un nodo XML |
CSV, TSV, JSON | Estos formatos no se admiten actualmente. |
Nuestro analizador de listas detecta automáticamente las codificaciones de texto UTF8
, UTF16
o UTF32
, y recurre a LATIN1
si aparecen secuencias de bytes inesperadas.
<?xml version="1.0" encoding="UTF-8"?> <listings> <title>example.com Feed</title> <link rel="self" href="http://www.example.com"/> <listing> <home_listing_id>12345678</home_listing_id> <name>1 Hacker Way, Menlo Park, CA 94025</name> <availability>for_rent</availability> <description>An amazing listing</description> <address format="simple"> <component name="addr1">1 Hacker Way</component> <component name="city">Menlo Park</component> <component name="region">California</component> <component name="country">United States</component> <component name="postal_code">94025</component> </address> <latitude>1.11414</latitude> <longitude>-1.835003</longitude> <neighborhood>Menlo Oaks</neighborhood> <image> <url>http://example.com/12345678-1.jpg</url> </image> <image> <url>http://example.com/12345678-2.jpg</url> </image> <image> <url>http://example.com/12345678-3.jpg</url> </image> <listing_type>for_rent_by_agent</listing_type> <num_baths>6</num_baths> <num_beds>5</num_beds> <num_units>1</num_units> <price>110000 USD</price> <property_type>house</property_type> <url>http://www.example.com/link_to_listing</url> <year_built>2007</year_built> </listing> </listings>
Los siguientes campos compatibles se diseñaron para los artículos que agregas a tu catálogo de productos.
En el caso de los catálogos localizados, consulta los campos admitidos para viviendas.
Nuestro analizador de listas detecta automáticamente las codificaciones de texto UTF8
, UTF16
o UTF32
, y recurre a LATIN1
si aparecen secuencias de bytes inesperadas. Si bien el texto de los valores de los campos puede proporcionarse en cualquier idioma, los nombres de los campos deben indicarse en inglés y exactamente como se muestra a continuación.
Nombre y tipo de campo | Descripción |
---|---|
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Identificador único de nivel de vivienda; identificador lo más detallado posible. Ejemplo: |
Tipo: cadena | No aplica a los anuncios de catálogo Advantage+. Opcional para el comercio. Identificador único del edificio o apartamento. Debe ser único por grupo. |
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Título del anuncio de la vivienda. Ejemplo: |
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Disponibilidad actual anuncio de vivienda. Los valores admitidos son: |
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Dirección de la propiedad, que se debe poder resolver en su ubicación. Consulta Parámetros de objetos de dirección. Ejemplo: |
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Ciudad donde se encuentra la propiedad. Consulta Parámetros de objetos de dirección. Ejemplo: |
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Estado, condado, región o provincia de la propiedad. Consulta Parámetros de objetos de dirección. Ejemplo: |
Tipo: objeto | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. País donde se encuentra la propiedad. Consulta Parámetros de objetos de dirección. Ejemplo: |
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. País donde se encuentra la propiedad. Consulta Parámetros de objetos de dirección. Ejemplo: |
Tipo: flotante | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Latitud del anuncio. Ejemplo: |
Tipo: flotante | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Longitud del anuncio. Ejemplo: |
Tipo: cadena | Obligatorio para anuncios de catálogo Advantage+. Opcional, pero muy recomendable para el comercio. Número máx. de comunidades permitidas: 20 Publicación de la comunidad de la propiedad. Puede tener múltiples comunidades. Si cuentas con más de una comunidad, agrega una columna para cada tipo, y usa la sintaxis de ruta JSON en cada nombre de columna para indicar el número de comunidades. Ejemplo: |
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Precio de venta o alquiler de la propiedad. El formato del precio como costo, seguido por el [código de moneda ISO de 3 dígitos] (https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70 ">), con un espacio entre el costo y la divisa. Ejemplo: |
Tipo: objeto | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Cantidad máxima de imágenes: 20 Tamaño máximo: 4 MB La URL de la imagen usada en tu anuncio.
Ejemplo: Consulta Parámetros de objetos de imagen. |
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. Enlace a la página de anuncios de propiedades. Debe ser una URL válida. Consulta Parámetros de objetos de imagen. Ejemplo: |
Tipo: cadena | Opcional para anuncios de catálogo Advantage+. Obligatorio para el comercio. Caracteres máximos: 5.000 Descripción de la propiedad. Ejemplo: |
Tipo: flotante | Opcional para anuncios de catálogo Advantage+. Obligatorio para el comercio. Número total de habitaciones. Puede ser Ejemplo: |
Tipo: flotante | Opcional para anuncios de catálogo Advantage+. Número total de baños. Si es para el comercio, debe ser |
Tipo: flotante | No se aplica a los anuncios de catálogo Advantage+. Obligatorio para el comercio. Número total de habitaciones de la propiedad. |
Tipo: cadena | Opcional para anuncios de catálogo Advantage+. Tipo de propiedad. Valores admitidos para anuncios del catálogo Advantage+: |
Tipo: cadena | Opcional para anuncios de catálogo Advantage+. Tipo de anuncio de propiedades. Valores admitidos para anuncios del catálogo Advantage+: |
Tipo: número entero | No se aplica a los anuncios de catálogo Advantage+. Obligatorio para el comercio. Área o espacio del anuncio del plano de la planta. |
Tipo: cadena | No se aplica a los anuncios de catálogo Advantage+. Obligatorio para el comercio. Las unidades (pies cuadrados o metros cuadrados) del valor de la superficie de la planta. Valores admitidos: |
Tipo: cadena | No se aplica a los anuncios de catálogo Advantage+. Opcional para el comercio. Tipo de aire acondicionado. Valores admitidos: |
Tipo: cadena | No se aplica a los anuncios de catálogo Advantage+. Opcional para el comercio. Tipo de muebles disponibles en la propiedad. Valores admitidos: |
Tipo: cadena | No se aplica a los anuncios de catálogo Advantage+. Opcional para el comercio. Tipo de calefacción instalado en la propiedad. Valores admitidos: |
Tipo: cadena | No se aplica a los anuncios de catálogo Advantage+. Opcional para el comercio. Tipo de lavadero disponible. Valores admitidos: |
Tipo: número entero | Opcional para los anuncios de catálogo Advantage+ y el comercio. Número total de unidades (apartamentos, condominios) disponibles para alquiler. Ejemplo: |
Tipo: cadena | No se aplica a los anuncios de catálogo Advantage+. Opcional para el comercio. Tipo de estacionamiento disponible en la propiedad. Valores admitidos: |
Tipo: cadena | No se aplica a los anuncios de catálogo Advantage+. Opcional para el comercio. Si la empresa asociada verificó el anuncio. Valores admitidos: |
Tipo: cadena | Año en que se construyó la propiedad en formato YYYY, año de 4 dígitos. Ejemplo: 1994. |
Tipo: cadena | No aplica para anuncios de catálogo Advantage+. Opcional para el comercio. Indica las mascotas permitidas en la propiedad: |
Tipo: objeto | Lista de fechas y precios disponibles en un anuncio. Cuando proporcionas valores, Facebook puede recomendar anuncios en función de las fechas disponibles y mostrar de manera dinámica el precio asociado a tu anuncio. |
Tipo: objeto | Enlace de la app al anuncio. |
Tipo: cadena | Controla si un artículo está activo o archivado en tu catálogo. Las personas solo pueden ver los artículos activos en tus anuncios, tiendas o cualquier otro canal. Valores admitidos: Ejemplo: Nota: Algunas plataformas asociadas, como Shopify, pueden sincronizar artículos en tu catálogo con un estado llamado preparación, que se comporta similar a Anteriormente, este campo se llamaba |
Nombre y tipo de campo | Descripción |
---|---|
Tipo: cadena | Obligatorio para los anuncios de catálogo Advantage+ y el comercio. URL de origen de la imagen. Sigue estas especificaciones de imágenes:
|
Tipo: cadena | Opcional para los anuncios de catálogo Advantage+ y el comercio. Etiqueta agregada a la imagen que muestra el contenido de la imagen. Es posible que haya varias etiquetas asociadas con una imagen. Ejemplos:
|
Nombre y tipo de campo | Descripción |
---|---|
Tipo: cadena | Obligatorio. Dirección de la calle del hotel. Ejemplo: |
Tipo: cadena | Obligatorio. Ciudad donde se ubica el hotel. Ejemplo: |
Tipo: cadena | Obligatorio. Estado, condado, región o provincia del hotel. Ejemplo: |
Tipo: cadena | Obligatorio. País del hotel. Ejemplo: |
Tipo: cadena | Código postal de la propiedad. Obligatorio, a menos que el país no use ningún sistema de códigos postales. Ejemplos: |
Con available_dates_price_config
, puedes proporcionar la disponibilidad y los precios de cada propiedad en un rango de fechas determinado. Cuando incluyes rangos de fechas en este campo, Facebook vincula esta disponibilidad con nuestras recomendaciones de productos e intenta mostrar los anuncios disponibles en el rango de fechas que las personas buscaron en tu sitio. De manera opcional, si incluyes precios también podemos mostrar precios específicos en función de las fechas en tu contenido del anuncio. Para activar esta característica, también debes enviar Facebook lease_start_date
y lease_end_date
en tus eventos de píxeles.
Nombre y tipo de campo | Descripción |
---|---|
Tipo: cadena | Opcional si se proporciona Inicio del intervalo de fechas disponible en formato ISO-8601; incluida la fecha de inicio. Si solo se proporciona Ejemplo: |
Tipo: cadena | Opcional si se proporciona Fin del rango de fechas disponible en formato ISO-8601; se excluye la fecha de finalización. Si solo proporcionas Ejemplo: |
Tipo: cadena | Precio entero del anuncio durante este intervalo de tiempo. Ejemplo: |
Tipo: cadena | Obligatorio si proporcionaste Código de divisa ISO-4217. Ejemplo: |
Tipo: cadena | Duración de la estancia de la tarifa especificada. Los valores permitidos son: |
Se trata de un ejemplo de la disponibilidad de un anuncio y cómo aparece en JSON:
"available_dates_price_config": [ { // available until 11/01 at $150/night "end_date": "2018-11-01", "rate": "15000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 - 12/01 at $200/night "start_date": "2018-11-01", "end_date": "2018-12-01", "rate": "20000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 onward at $500/week "start_date": "2018-11-01", "rate": "50000", "currency": "USD", "interval": "weekly", }, ]
Proporciona enlaces profundos en la lista siguiendo la especificación de App Links. La información de los enlaces profundos en la lista tiene prioridad sobre cualquier información que recopile Facebook con metadatos de App Links mediante nuestro rastreador web.
Si ya tienes información de los enlaces profundos de App Links, no necesitas especificar estos datos. Facebook usa información de App Links para mostrar el enlace profundo correcto. Para mostrar enlaces profundos en tus anuncios, consulta Anuncios del catálogo Advantage+, plantilla de anuncio.
En lo que respecta a los anuncios de catálogo Advantage+, puedes actualizar la información de los anuncios de viviendas en el catálogo de las siguientes maneras usando la subida directa. Consulta la referencia de lista de subida directa
Ejemplo: puedes hacer una subida de manera manual:
curl \
-F "url=http://www.example.com/sample_feed.xml" \
-F "access_token=
En relación con el comercio, puedes actualizar la información de los anuncios de viviendas en el catálogo si configuras una subida recurrente (programada) de la lista y actualizas tu lista. En Marketplace, recomendamos usar la opción Programar.
El comercio admite una experiencia multilingüe. Si agregas listas secundarias de idiomas a un catálogo, puedes crear otra lista con el idioma secundario a partir de ese mismo catálogo. La información de las listas secundarias sobrescribe el idioma predeterminado cuando un público específico ve el anuncio.
Esta característica es aplicable solo a determinados países asociados. Ponte en contacto con tu representante de Facebook para averiguar cuáles son las posibilidades en tu mercado.
Este es un grupo de artículos de un catálogo que anuncias en tus anuncios de catálogo Advantage+. Cada catálogo de anuncios puede tener muchos conjuntos de anuncios.
curl \
-F "name=test set" \
-F 'filter={"availability":{"eq":"for_sale"}}' \
-F "access_token=" \
https://graph.facebook.com/
El filter
anterior está formado por los siguientes operadores y datos:
Operadores | Tipo de filtro |
---|---|
| Contiene subcadena (no distingue mayúsculas de minúsculas) |
| No contiene subcadena (no distingue mayúsculas de minúsculas) |
| Contiene subcadena (distingue mayúsculas de minúsculas) |
| No contiene subcadena (distingue mayúsculas de minúsculas) |
| Igual a (no distingue mayúsculas de minúsculas) |
| Distinto de (no distingue mayúsculas de minúsculas) |
| Menor que (solo campos numéricos) |
| Menor o igual que (solo campos numéricos) |
| Mayor que (solo campos numéricos) |
| Mayor o igual que (solo campos numéricos) |
Datos | Datos para filtrar |
---|---|
| Disponibilidad de los anuncios. Ejemplo: |
| Tipo de anuncios. Ejemplo: |
| Tipo de propiedad. Ejemplo: |
| Precio de venta |
| Nombre |
| Ciudad |
| País |
| Región o estado |
| Código postal |
| Número de camas |
| Número de baños |
Puedes enviar eventos de conversiones offline y ver cuántos clientes vieron o hicieron clic en los anuncios de Facebook y en los anuncios comerciales antes de realizar la conversión. Usa la API de conversiones offline y agrega los siguientes campos en el Paso 4: Subir eventos offline.
Las teclas de coincidencia comparan una conversión con un usuario.
Clave | Descripción |
---|---|
| Direcciones de correo electrónico Hash |
| Números de teléfono Hash |
| Primer nombre Hash |
| Apellido Hash |
| Identificador de anunciante en Apple o Android Hash |
| Códigos postales Hash |
| Ciudad Hash |
| Estado Hash |
| País Hash |
| Fecha de nacimiento (formato DD) Hash |
| Fecha de nacimiento (formato AAAA) Hash |
| Género Hash |
| Edad Hash |
| Identificador de cliente potencial de los clientes potenciales de Marketplace |
Los datos personalizados comparan una conversión con un distribuidor.
Campo | Descripción |
---|---|
|
|
| Se configura en |
Los detalles del evento describen el evento de conversión offline que tuvo lugar. La frecuencia de subida es diaria, dentro de las 48 horas posteriores al evento.
Campo | Descripción |
---|---|
| Obligatorio Enumeración del tipo de evento:
|
| Obligatorio Hora del evento |
| Obligatorio Valor del alquiler. Configura el valor en |
| Obligatorio Código de divisas |