房地產廣告 - 開始使用

步驟 1：建立房地產廣告目錄。

步驟 2：設定商品資訊和價格。

步驟 3：更新選項。

步驟 4：篩選商品資訊目錄中的商品資訊組合。

步驟 5：傳送離線轉換次數（選用）

步驟 6：建立房地產廣告受眾。與用戶發佈的房地產商品資訊不同，對於合作夥伴整合，潛在顧客是透過潛在顧客表單傳送給合作夥伴，而不是透過 Messenger 聊天室傳送。深入瞭解如何擷取商務的潛在顧客。

步驟 7：建立及投放房地產廣告。

步驟 8：取得廣告投放資訊，瞭解 Facebook 用戶如何與您的廣告互動。請參閱廣告洞察報告。

步驟 9：使用偵錯工具來診斷及解決問題。請參閱高效速成+ 目錄廣告偵錯工具。

步驟 1：建立房地產廣告目錄

用於高效速成+ 目錄廣告

您的目錄應包含所要廣告的資產清單。請參閱目錄參考資料。

若要建立用於高效速成+ 目錄廣告的房地產廣告目錄，請將 vertical 設為 home_listings：

curl \
  -F 'name=Home Listing Catalog Name' \
  -F 'vertical=home_listings' \
  -F 'access_token=<ACCESS TOKEN>' \
  https://graph.facebook.com/<API_VERSION>

若要使用目錄 API，您需要行銷 API 存取層級，並透過企業管理平台建立您的第一份目錄，以接受服務條款。

用於商務

若要瞭解如何建立用於商務的目錄，請參閱 Marketplace 平台說明文件的指示。

步驟 2：設定商品資訊和價格

您的商品資訊包含資產的相關資訊，例如商品資訊編號、名稱、供應情況、說明、地址、臥室、衛浴等等。您可以從自己公司上傳或擷取一組商品資訊。商品資訊項目是展示在您的網站或應用程式中的單一資產。

支援的摘要格式

您可以為目錄中的所有資產建立單一摘要，也可以建立多個摘要，其中一個摘要代表位於單一國家／地區的資產、單一房地產代理商或某個仲介人員所服務的資產。

用於高效速成+ 目錄廣告時，您必須以下列其中一種格式提供商品資訊摘要：

用於商務時，您必須以 XML 格式提供商品資訊摘要：

我們的摘要剖析器會自動偵測 UTF8、UTF16 或 UTF32 文字編碼，如果出現非預期的位元組順序，則退回到 LATIN1。

摘要 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>

支援的欄位 - 房地產廣告

下列支援欄位是專為新增至商品目錄的項目而設計。

如需本地化目錄，請參閱房地產廣告的支援欄位。

我們的摘要剖析器會自動偵測 UTF8、UTF16 或 UTF32 文字編碼，如果出現非預期的位元組順序，則退回到 LATIN1。欄位值文字可使用任何語言，但欄位名稱必須完全按照下列方式以英文輸入。

特定國家／地區的必填欄位 - 僅限商務

請參閱 Marketplace 平台說明文件，瞭解用於商務的特定國家／地區必填欄位。

圖像物件參數

地址物件參數

可供應日期價格配置

透過 available_dates_price_config，您可以提供給定日期範圍內每項資產的供應情況和價格。當您在此欄位中包含日期範圍時，Facebook 會將此供應情況納入我們的產品推薦因素中，並嘗試針對用戶在您網站上搜尋的日期，顯示可供應的商品資訊。如果您選擇包含價格，我們也可以在您的廣告創意中顯示特定日期的價格。若要啟用此功能，您也必須在像素事件中將 lease_start_date 和 lease_end_date 傳送給 Facebook。

可供應日期物件參數

以下商品的供應情況及其在 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",
    },
]

產品深層連結

遵循應用程式連結規格在摘要中提供深層連結。摘要中的深層連結資訊會優先於任何 Facebook 資訊，這些資訊是透過我們的網路爬蟲使用應用程式連結中繼資料收集所得。

如果您已經具備應用程式連結的深層連結資訊，則無須指定此資料。Facebook 使用應用程式連結的資訊來顯示正確的深層連結。若要在廣告中顯示深層連結，請參閱高效速成+ 目錄廣告：廣告範本。

步驟 3：更新選項

高效速成+ 目錄廣告

用於高效速成+ 目錄廣告時，您可以透過下列方式直接上傳，以重新整理目錄中的房地產廣告資訊。請參閱直接上傳摘要參考資料

範例 — 您可以手動執行一次性上傳：

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

商務

用於商務時，您可以藉由設定定期（排程）摘要上傳和更新摘要的方式來重新整理目錄中的房地產廣告資訊。在 Marketplace 中，我們強烈建議使用「設定排程」選項。

設定目錄資料摘要上傳排程

1. 前往商務管理工具。
2. 點擊資料來源。
3. 點擊新增資料來源。
4. 點擊使用資料摘要，再點擊繼續。
5. 點擊設定排程。
   
6. 選擇您希望 Facebook 檢查資料摘要以進行更新的頻率：每日、每小時和每週。如果您選擇頻率為每小時或每週，也可以指定排程上傳重複的時間。
7. 輸入摘要的直接網址。您可以使用 HTTP、HTTPS、FTP 或 SFTP 等網址。注意：網址應直接指向您的資料摘要檔案；否則可能會上傳失敗。
8. （選用）輸入資料摘要供應商的用戶名稱和密碼。這與您用來存取 Facebook 廣告帳號的用戶名稱和密碼不同。
9. 輸入資料摘要的名稱。
10. 選擇資料摘要的貨幣類型。若未在資料摘要檔案中指定貨幣類型，則會將此貨幣類型用於您的資料摘要。
11. 點擊繼續。
12. 檢查您的資料摘要檔案是否有任何錯誤。如果檔案中缺少任何必要直欄，或有 Facebook 無法辨識的直欄，您可以在這裡對應至適當的直欄。在這裡對應的任何直欄都會儲存，供未來進行資料摘要上傳。
13. 點擊繼續。

多語言摘要上傳

商務支援多語言體驗。將次要語言摘要新增至目錄時，您可以使用該單一目錄中的第二語言建立另一個摘要。相關廣告受眾看到您的商品資訊時，次要摘要上的資訊會覆寫您的預設語言。

此功能僅適用於特定國家／地區的合作夥伴。請聯絡您的 Facebook 代表，瞭解您所在市場的可能性。

1. 使用預設語言和國家／地區的資料摘要來建立目錄。
2. 建立 XML 檔案，其中只包含商品資訊編號（home_listing_id）以及需要本地語言覆寫的其他欄位，例如名稱、說明或其他欄位。若要覆寫資訊，home_listing_id 必須與原始目錄資料摘要中的編號相符。
3. 從商務管理工具新增其他資訊摘要。
   
   從商務管理工具新增其他摘要 [新增房地產廣告資訊] - [新增語言資訊]
   
   
   
4. 確認同一目錄中的 2 個資料來源。
   

步驟 4：篩選商品資訊目錄中的商品資訊組合

這是您在高效速成+ 目錄廣告中宣傳之目錄中的商品群組。每個商品資訊目錄可以有多個商品資訊組合。

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

上述 filter 由以下運算子和資料組成：

步驟 5：傳送離線轉換次數

您可以傳送離線轉換事件，查看有多少顧客在轉換前觀看或點擊 Facebook 廣告和商務商品資訊；請使用離線轉換 API，並在步驟 4：上傳離線事件中新增以下欄位。

配對索引鍵

配對索引鍵會將轉換資料與用戶做比較。

自訂資料

自訂資料會將轉換資料與經銷商做比較。

事件詳情

事件詳情會說明已發生的離線轉換事件。上傳頻率為每日，在事件發生 48 小時內。