En el caso del comercio, para publicar anuncios de bienes inmuebles, tu empresa debe estar verificada.
Paso 1: Crear un catálogo de anuncios de viviendas.
Paso 2: Configurar los anuncios y los precios.
Paso 3: Actualizar las opciones.
Paso 4: Filtrar el catálogo de anuncios al conjunto de anuncios.
Paso 5: Enviar las conversiones offline (opcional).
Paso 6: Crear la audiencia de los bienes inmuebles. A diferencia de lo que sucede con los anuncios de bienes inmuebles que publican los usuarios, en el caso de las integración con socios, los clientes potenciales se envían a los socios mediante el formulario de clientes potenciales, en lugar de mediante el chat de Messenger. Obtén más información sobre cómo recuperar clientes potenciales para el comercio.
Paso 7: Crear y entregar los anuncios de viviendas.
Paso 8: Obtener información de entrega para ver cómo interactúan los usuarios de Facebook con los anuncios. Consulta Insights de anuncios.
Paso 9: Utilizar herramientas de depuración para diagnosticar y resolver problemas. Consulta Herramientas de depuración de los anuncios de catálogo de Advantage+.
El catálogo debe contener una lista de las propiedades que quieres publicitar. Consulta la referencia del catálogo.
Para crear un catálogo de anuncios de viviendas para los anuncios de catálogo de Advantage+, establece 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 el nivel de acceso a la API de marketing y debes aceptar las Condiciones del servicio; para ello, crea tu primer catálogo mediante Business Manager.
Si necesitas instrucciones sobre cómo crear un catálogo para el comercio, consulta la documentación de la plataforma de Marketplace.
Los anuncios contienen información de propiedades, como el identificador del anuncio, el nombre, la disponibilidad, la descripción, la dirección, el número de habitaciones y baños, etc. Puedes tener un conjunto de anuncios subidos o recuperados de tu empresa. Un producto de un anuncio es una propiedad única presentada en tu sitio web o aplicación.
Puedes tener una sola lista para todas las propiedades del catálogo o bien contar con varias, donde una representa las propiedades de un único país, para una única agencia inmobiliaria o para un agente.
En el caso de los anuncios de catálogo de Advantage+, debes proporcionar la lista de anuncios en uno de los siguientes formatos:
Formato de archivo | Descripción | Archivo de muestra |
---|---|---|
XML | Se suele generar mediante sistemas de proveedores de listas automatizados. Un nodo XML | |
CSV, TSV | La primera fila debe enumerar los nombres de campos elegidos en el mismo orden en que se proporcionarán los valores. Las filas siguientes proporcionarán los valores correspondientes de cada anuncio de vivienda. Los campos anidados o con varios valores, como “image”, se pueden representar con valores cifrados mediante JSON o un conjunto de columnas “aplanadas” de texto sin formato etiquetadas con sintaxis de ruta JSON (por ejemplo, | Descargar (CSV) |
En el caso del comercio, debes proporcionar la lista de anuncios en formato XML:
Formato de archivo | Descripción |
---|---|
XML | Se suele generar mediante sistemas de proveedores de listas automatizados. 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 recurrirá 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 admitidos se han diseñado para los artículos que añades al catálogo de productos.
En el caso de catálogos localizados, consulta los campos admitidos para anuncios de viviendas.
Nuestro analizador de listas detecta automáticamente las codificaciones de texto UTF8
, UTF16
o UTF32
, y recurrirá a LATIN1
si aparecen secuencias de bytes inesperadas. Aunque el texto de los valores de los campos se puede proporcionar en cualquier idioma, los nombres de los campos deben indicarse en inglés y exactamente como se muestra a continuación.
Nombre y tipo del campo | Descripción |
---|---|
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Identificador único del anuncio de vivienda (apartamento o bloque), lo más detallado posible. Ejemplo: |
Tipo: cadena | No aplicable a los anuncios de catálogo de Advantage+. Opcional en el caso del comercio. Identificador único del edificio o apartamento. Debe ser único por grupo. |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Título del anuncio de vivienda. Ejemplo: |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Disponibilidad actual del anuncio de vivienda. Los valores admitidos son |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Dirección postal de la propiedad, que debe poder resolverse en su ubicación. Consulta Parámetros del objeto “address”. Ejemplo: |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Ciudad en la que se encuentra la propiedad. Consulta Parámetros del objeto “address”. Ejemplo: |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Estado, condado, región o provincia de la propiedad. Consulta Parámetros del objeto “address”. Ejemplo: |
Tipo: objeto | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. País en el que se encuentra la propiedad. Consulta Parámetros del objeto “address”. Ejemplo: |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. País en el que se encuentra la propiedad. Consulta Parámetros del objeto “address”. Ejemplo: |
Tipo: flotante | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Latitud del anuncio. Ejemplo: |
Tipo: flotante | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Longitud del anuncio. Ejemplo: |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+. Opcional, pero muy recomendado, en el caso del comercio. Número máximo de comunidades permitidas: 20 Comunidad del anuncio de la propiedad. Puede tener varias comunidades. Si tienes más de una comunidad, añade columnas adicionales para cada tipo y utiliza la sintaxis de la ruta JSON en cada nombre de columna para indicar el número de comunidades. Ejemplo: |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Precio de venta o alquiler de la propiedad. Asigna al precio el mismo formato que al coste, seguido del [código de divisa ISO de tres dígitos](https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70">, con un espacio entre ambos. Ejemplo: |
Tipo: objeto | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Número máximo de imágenes: 20 Tamaño máximo: 4 MB URL de la imagen utilizada en el anuncio.
Ejemplo: Consulta Parámetros del objeto “image”. |
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. Enlace a la página del anuncio de la propiedad. Debe ser una URL válida. Consulta Parámetros del objeto “image”.
|
Tipo: cadena | Opcional en el caso de los anuncios de catálogo de Advantage+. Obligatorio en el caso del comercio. Máximo de caracteres: 5000 Descripción de la propiedad. Ejemplo: |
Tipo: flotante | Opcional en el caso de los anuncios de catálogo de Advantage+. Obligatorio en el caso del comercio. Número total de habitaciones. Puede ser Ejemplo: |
Tipo: flotante | Opcional en el caso de los anuncios de catálogo de Advantage+. Número total de baños. En el caso del comercio, debe ser |
Tipo: flotante | No aplicable en el caso de los anuncios de catálogo de Advantage+. Obligatorio en el caso del comercio. Número total de habitaciones de la propiedad. |
Tipo: cadena | Opcional en el caso de los anuncios de catálogo de Advantage+. Tipo de propiedad. Los valores admitidos para los anuncios de catálogo de Advantage+ son |
Tipo: cadena | Opcional en el caso de los anuncios de catálogo de Advantage+. Tipo de anuncio de propiedad. Los valores admitidos para los anuncios de catálogo de Advantage+ son |
Tipo: entero | No aplicable en el caso de los anuncios de catálogo de Advantage+. Obligatorio en el caso del comercio. Área o espacio del anuncio del plano de la planta. |
Tipo: cadena | No aplicable en el caso de los anuncios de catálogo de Advantage+. Obligatorio en el caso del comercio. Unidades (pies cuadrados o metros cuadrados) del valor de área de la planta. Los valores admitidos son |
Tipo: cadena | No aplicable en el caso de los anuncios de catálogo de Advantage+. Opcional en el caso del comercio. Tipo de aire acondicionado. Los valores admitidos son |
Tipo: cadena | No aplicable en el caso de los anuncios de catálogo de Advantage+. Opcional en el caso del comercio. Tipo de mobiliario disponible en la propiedad. Los valores admitidos son |
Tipo: cadena | No aplicable en el caso de los anuncios de catálogo de Advantage+. Opcional en el caso del comercio. Tipo de calefacción instalado en la propiedad. Los valores admitidos son |
Tipo: cadena | No aplicable en el caso de los anuncios de catálogo de Advantage+. Opcional en el caso del comercio. Tipo de lavandería disponible. Los valores admitidos son |
Tipo: entero | Opcional en el caso de los anuncios de catálogo de Advantage+ y el comercio. Número total de unidades (apartamentos o bloques) disponibles para alquilar. Ejemplo: |
Tipo: cadena | No aplicable en el caso de los anuncios de catálogo de Advantage+. Opcional en el caso del comercio. Tipo de aparcamiento disponible en la propiedad. Los valores admitidos son |
Tipo: cadena | No aplicable en el caso de los anuncios de catálogo de Advantage+. Opcional en el caso del comercio. Indica si la empresa asociada ha verificado el anuncio. Los valores admitidos son |
Tipo: cadena | Año en que se construyó la propiedad, en formato AAAA (año de cuatro dígitos). Ejemplo: 1994 |
Tipo: cadena | No aplicable en el caso de los anuncios de catálogo de Advantage+. Opcional en el caso del comercio. Indica las mascotas permitidas en la propiedad: |
Tipo: objeto | Lista de fechas y precios de disponibilidad de un anuncio. Si proporcionas valores, Facebook puede recomendar anuncios en función de la fecha de disponibilidad y mostrar de forma dinámica el precio asociado en el anuncio. |
Tipo: objeto | Enlace de la aplicación al anuncio. |
Tipo: cadena | Controla si un artículo está activo o archivado en el catálogo. Solo los artículos activos aparecen en los anuncios, las tiendas y otros canales. Valores admitidos: Ejemplo: Nota: Es posible que algunas plataformas de socios, como Shopify, sincronicen los artículos con tu catálogo con un estado denominado provisional, que se comporta igual que Anteriormente, este campo se llamaba |
Nombre y tipo del campo | Descripción |
---|---|
Tipo: cadena | Obligatorio en el caso de los anuncios de catálogo de Advantage+ y el comercio. URL de origen de la imagen. Sigue estas especificaciones de imagen:
|
Tipo: cadena | Opcional en el caso de los anuncios de catálogo de Advantage+ y el comercio. Etiqueta anexada a la imagen que indica qué contiene la imagen. Puede haber varias etiquetas asociadas con una imagen. Ejemplos:
|
Nombre y tipo del campo | Descripción |
---|---|
Tipo: cadena | Obligatorio. Dirección postal del hotel. Ejemplo: |
Tipo: cadena | Obligatorio. Ciudad en la que se encuentra 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 disponga de ningún sistema de códigos postales. Ejemplos: |
Con available_dates_price_config
, puedes indicar la disponibilidad y los precios de cada propiedad para un intervalo de fechas específico. Al incluir intervalos de fechas en este campo, Facebook tiene en cuenta esta disponibilidad en las recomendaciones de productos e intenta mostrar los anuncios que están disponibles para las fechas que el usuario ha buscado en el sitio. De forma opcional, si incluyes los precios, también podemos mostrar los precios específicos de las fechas en el contenido del anuncio. Para activar esta función, también debes enviar a Facebook lease_start_date
y lease_end_date
en los eventos de píxel.
Nombre y tipo del campo | Descripción |
---|---|
Tipo: cadena | Opcional si se proporciona Inicio del intervalo de fechas disponibles en formato ISO-8601 (fecha de inicio incluida). Si solo proporcionas Ejemplo: |
Tipo: cadena | Opcional si se proporciona Fin del intervalo de fechas disponibles en formato ISO-8601 (fecha de fin no incluida). Si solo proporcionas Ejemplo: |
Tipo: cadena | Precio entero del anuncio durante este intervalo de tiempo. Ejemplo: |
Tipo: cadena | Obligatorio si proporcionas Código de divisa ISO-4217. Ejemplo: |
Tipo: cadena | Duración de la estancia para la tarifa especificada. Los valores permitidos son |
Este es un ejemplo de la disponibilidad de un anuncio y cómo se muestra 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", }, ]
Proporcionar enlaces profundos en una sección de noticias de acuerdo con la especificación de App Links. La información de enlaces profundos de la sección de noticias tiene prioridad frente a cualquier información que Facebook recopile con metadatos de App Links con el rastreador web.
Si ya tienes información sobre enlaces profundos de App Links, no es necesario que especifiques estos datos. Facebook usa la información de App Links para mostrar el enlace profundo correcto. Para mostrar enlaces profundos en tus anuncios, consulta Anuncios de catálogo de Advantage+, Plantilla de anuncio.
En el caso de los anuncios de catálogo de Advantage+, puedes actualizar la información de los anuncios de viviendas del catálogo de las siguientes maneras mediante la subida directa. Consulta la referencia de las listas de subida directa.
Ejemplo: puedes realizar manualmente una subida única:
curl \
-F "url=http://www.example.com/sample_feed.xml" \
-F "access_token=
En el caso del comercio, puedes actualizar la información de los anuncios de viviendas en el catálogo mediante la configuración de una subida de listas recurrente (programada) y la actualización de la lista. En Marketplace, te recomendamos encarecidamente utilizar la opción Definir programación.
El comercio admite una experiencia de varios idiomas. Cuando añades una lista en un idioma secundario a un catálogo, puedes crear otra lista con el segundo idioma a partir de ese único catálogo. La información de las listas secundarias anula el idioma predeterminado cuando la audiencia pertinente ve tus anuncios.
Esta función es aplicable solo en el caso de los socios de países específicos. Ponte en contacto con tu representante de Facebook para consultar las posibilidades de tu mercado.
Es un grupo de artículo de un catálogo que anuncias en los anuncios de catálogo de 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 campo filter
anterior está formado por los operadores y datos siguientes:
Operadores | Tipo de filtro |
---|---|
| Contiene la subcadena (no distingue entre mayúsculas y minúsculas). |
| No contiene la subcadena (no distingue entre mayúsculas y minúsculas). |
| Contiene la subcadena (distingue entre mayúsculas y minúsculas). |
| No contiene la subcadena (distingue entre mayúsculas y minúsculas). |
| Es igual a (no distingue entre mayúsculas y minúsculas). |
| No es igual a (no distingue entre mayúsculas y 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 que se van a filtrar |
---|---|
| Disponibilidad del anuncio. Ejemplo: |
| Tipo de anuncio. |
| Tipo de propiedad. Ejemplo: |
| Precio del anuncio. |
| 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 consultar cuántos clientes vieron los anuncios de Facebook y de comercio, o hicieron clic en ellos, antes de convertirse; utiliza la API de conversiones offline y añade los campos siguientes en el Paso 4. Subir eventos offline.
Las claves de coincidencia comparan una conversión con un usuario.
Clave | Descripción |
---|---|
| Direcciones de correo electrónico. Aplicar algoritmos hash |
| Números de teléfono. Aplicar algoritmos hash |
| Nombre. Aplicar algoritmos hash |
| Apellidos. Aplicar algoritmos hash |
| Identificador de publicidad de Apple o Android. Aplicar algoritmos hash |
| Códigos postales. Aplicar algoritmos hash |
| Ciudad. Aplicar algoritmos hash |
| Estado. Aplicar algoritmos hash |
| País. Aplicar algoritmos hash |
| Fecha de nacimiento (formato DD). Aplicar algoritmos hash |
| Fecha de nacimiento (formato AAAA). Aplicar algoritmos hash |
| Género. Aplicar algoritmos hash |
| Edad. Aplicar algoritmos hash |
| Identificador de los clientes potenciales de Marketplace. |
Los datos personalizados comparan una conversión con un vendedor.
Campo | Descripción |
---|---|
|
|
| Se establece 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 de tipos de eventos:
|
| Obligatorio. Hora del evento. |
| Obligatorio. Valor del alquiler. Se establece en |
| Obligatorio. Código de divisa. |