Anúncios de imóveis – Introdução

Etapa 1: criar um catálogo de classificados de imóveis.

Etapa 2: configurar os classificados e definir preços.

Etapa 3: escolher opções de atualização.

Etapa 4: filtrar o catálogo no conjunto de cadastros.

Etapa 5: enviar conversões offline (opcional).

Etapa 6: criar um público para os imóveis. Diferentemente do que acontece com os anúncios de imóveis publicados pelos usuários, para integrações de parceiros, os cadastros são enviados por meio de um formulário, e não via bate-papo do Messenger. Saiba mais sobre como recuperar cadastros para comércio.

Etapa 7: criar e veicular anúncios para seus classificados de imóveis.

Etapa 8: obter informações de veiculação para ver como as pessoas no Facebook interagem com seus anúncios. Consulte a referência sobre insights de anúncios.

Etapa 9: usar ferramentas de depuração para diagnosticar e resolver problemas. Consulte Ferramentas de depuração dos Anúncios de Catálogo Advantage+.

Etapa 1: criar um catálogo de classificados de imóveis

Anúncios de catálogo Advantage+

Seu catálogo deve conter uma lista de imóveis que você deseja anunciar. Consulte a referência sobre catálogo.

Se você quiser criar um catálogo de classificados de imóveis para anúncios de catálogo Advantage+, defina vertical como 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 a API de catálogo, você precisa ter o nível de acesso adequado à API de Marketing e aceitar os Termos de Serviço criando seu primeiro catálogo por meio do Gerenciador de Negócios.

Comércio

Veja instruções sobre como criar um catálogo para comércio na documentação a respeito da plataforma Marketplace.

Etapa 2: configurar os classificados e definir preços

Os classificados contêm informações sobre as propriedades, como ID do imóvel anunciado, nome, disponibilidade, descrição, endereço, número de quartos, quantidade de banheiros e assim por diante. Sua empresa pode carregar ou buscar um conjunto de classificados de imóveis. Um item do classificado é um imóvel único exibido no seu site ou app.

Formatos de feed compatíveis

Você pode ter um feed único para todos os imóveis do catálogo ou vários feeds nos quais cada feed representa os imóveis de um país, de uma imobiliária ou de um corretor.

Para anúncios de catálogo Advantage+, é preciso fornecer o feed de classificados em um destes formatos:

Para comércio, é preciso fornecer o feed de classificados em formato XML:

Nosso analisador de feeds detecta automaticamente as codificações de texto UTF8, UTF16 ou UTF32 e usa LATIN1 quando há uma sequência de bytes inesperada.

Exemplo de feed em XML

<?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>

Campos compatíveis – Classificados de imóveis

Os campos compatíveis a seguir foram criados para itens que você adiciona ao seu catálogo de produtos.

Para catálogos localizados, consulte os campos compatíveis com classificados de imóveis.

Nosso analisador de feeds detecta automaticamente as codificações de texto UTF8, UTF16 ou UTF32 e usa LATIN1 quando há uma sequência de bytes inesperada. Embora o texto referente aos valores dos campos possa ser inserido em qualquer idioma, os nomes dos campos precisam ser fornecidos exatamente conforme descrito abaixo, em inglês.

Campos obrigatórios específicos do país – Somente para comércio

Acesse a documentação da plataforma Marketplace e confira os campos obrigatórios específicos do país para comércio.

Parâmetros do objeto Image

Parâmetros do objeto Address

Configuração de preços e datas disponíveis

Com available_dates_price_config, você pode fornecer a disponibilidade e os preços de cada imóvel para um intervalo de datas específico. Quando você inclui um período neste campo, o Facebook considera essa disponibilidade nas nossas recomendações de produtos e tenta mostrar classificados disponíveis para as datas pesquisadas no seu site. Como alternativa, se você incluir preços, também poderemos mostrar valores específicos para datas no criativo do seu anúncio. Para habilitar esse recurso, será preciso enviar ao Facebook lease_start_date e lease_end_date nos seus eventos de pixel.

Parâmetros do objeto Available Dates

Confira abaixo um exemplo que mostra a disponibilidade de um classificado e como ele aparece em 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",
    },
]

Deep links de produtos

Forneça deep links no feed seguindo a especificação de App Links. As informações de deep link no feed têm prioridade sobre as que o Facebook coleta com metadados de App Links no nosso rastreador da web.

Não será necessário especificar esses dados se você já tiver informações de deep link do App Links. O Facebook usa as informações do App Links para exibir o deep link certo. Para exibir deep links nos seus anúncios, consulte a documentação sobre os modelos de anúncios de catálogo Advantage+.

Etapa 3: escolher opções de atualização

Anúncios de catálogo Advantage+

Para anúncios de catálogo Advantage+, você pode atualizar as informações do classificado de imóvel no catálogo das seguintes maneiras com carregamento direto. Consulte a referência sobre feed de carregamento direto.

Exemplo: você pode fazer um carregamento único manualmente:

curl \
  -F "url=http://www.example.com/sample_feed.xml" \
  -F "access_token=

Comércio

Para comércio, você pode atualizar as informações do classificado de imóvel no catálogo configurando um carregamento de feed recorrente (programado) e atualizando seu feed. No Marketplace, é altamente recomendável usar a opção Set a Schedule.

Configurar uma programação para carregar o feed de dados do catálogo

1. Acesse o Gerenciador de Comércio.
2. Clique em Data Sources.
3. Clique em Add Data Source.
4. Clique em Use Data Feeds e em Next.
5. Clique em Set a schedule.
   
6. Escolha com que frequência você quer que o Facebook verifique se há atualizações no seu feed de dados: Daily, Hourly e Weekly. Se você escolher Hourly ou Weekly, também será possível especificar quando o carregamento programado deve se repetir.
7. Digite a URL direta para o feed. Você pode incluir URLs que usam HTTP, HTTPS, FTP ou SFTP. Observação: a URL deve apontar diretamente para o arquivo do feed de dados; caso contrário, o carregamento pode falhar.
8. (Opcional) Digite o nome de usuário e a senha do provedor do feed de dados. Isso é diferente do nome de usuário e da senha que você usa para acessar sua conta de anúncios do Facebook.
9. Insira um nome para o feed de dados.
10. Escolha o tipo de moeda para o feed de dados. O tipo de moeda será usado caso você não tenha especificado essa informação no arquivo de feed de dados.
11. Clique em Next.
12. Revise seu arquivo de feed de dados para identificar possíveis erros. Se houver colunas obrigatórias em branco no seu arquivo ou colunas que o Facebook não reconhece, será possível mapear as opções apropriadas aqui. Todas as colunas mapeadas aqui são salvas para futuros carregamentos do feeds de dados.
13. Clique em Next.

Carregar um feed em vários idiomas

Para comércio, oferecemos compatibilidade com uma experiência multilíngue. Ao adicionar um feed de idioma secundário a um catálogo, você pode criar outro feed com o segundo idioma desse catálogo único. As informações nos feeds secundários substituem o idioma padrão quando o público relevante vê seus classificados.

Esse recurso é aplicável apenas a países parceiros específicos. Entre em contato com seu representante do Facebook para conferir a disponibilidade no seu mercado.

1. Crie um catálogo com um feed de dados para seu país e idioma padrão.
2. Crie um arquivo XML apenas com o ID do classificado (home_listing_id) e outros campos que precisam ser traduzidos para o idioma local, como nome, descrição ou campos adicionais. Para substituir as informações, o home_listing_id deve corresponder aos IDs no feed de dados do catálogo original.
3. Inclua o feed de informações adicionais do Gerenciador de Comércio.
   
   Inclua o feed adicional do Gerenciador de Comércio em Add Home Listing Information e Add Language Information.
   
   
   
4. Confirme as 2 fontes de dados dentro do mesmo catálogo.
   

Etapa 4: filtrar o catálogo no conjunto de classificados

Este é um grupo de itens em um catálogo que você divulga nos seus anúncios de catálogo Advantage+. Cada catálogo de classificados pode ter diversos conjuntos de classificados.

curl \
  -F "name=test set" \
  -F 'filter={"availability":{"eq":"for_sale"}}' \
  -F "access_token=" \
  https://graph.facebook.com/

O filter acima é formado pelos seguintes operadores e dados:

Etapa 5: enviar conversões offline

É possível enviar eventos de conversão offline e ver quantos clientes visualizaram ou clicaram em anúncios do Facebook e classificados comerciais antes da conversão. Para isso, use a API de Conversões Offline e adicione os campos a seguir na etapa 4. Carregamento de eventos offline.

Chaves de correspondência

As chaves de correspondência comparam uma conversão a um usuário.

Dados personalizados

Os dados personalizados comparam uma conversão a um revendedor.

Detalhes do evento

Os detalhes do evento descrevem o evento de conversão offline que ocorreu. A frequência de carregamento é diária, em até 48 horas após o evento.