不動産広告 - 利用を開始する

商取引のために不動産のリストを公開するには、ビジネスの認証を受ける必要があります。

ステップ1: 不動産・住宅リストカタログを作成します。

ステップ2: リストと価格を設定します

ステップ3: オプションを更新します

ステップ4: リストカタログをリストセットにフィルタリングします

ステップ5: オフラインコンバージョンを送信します(任意)。

ステップ6: 不動産のオーディエンスを作成します。ユーザーが公開する不動産リストとは異なり、リードはパートナー統合のためにMessengerチャットではなくリードフォームでパートナーに送信されます。コマースのリード取得について詳しくはこちら。

ステップ7: ホームリスト用の広告を作成して配信します

ステップ8: 配信情報を入手して、Facebook上のユーザーの広告エンゲージメントを確認します広告インサイトをご覧ください。

ステップ9: デバッグツールを使用して、問題を診断して解決しますAdvantage+カタログ広告のデバッグツールをご覧ください。

ステップ1: 不動産・住宅リスカタログを作成する

Advantage+カタログ広告用

カタログには、宣伝したい物件のリストが含まれている必要があります。カタログリファレンスをご覧ください。

Advantage+カタログ広告用の不動産・住宅リストカタログを作成するには、verticalhome_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: リストと価格を設定する

リストには、リスティングID、名前、取り引き可能かどうか、説明、住所、寝室数、浴室数などの物件情報が含まれます。ビジネスからリストをアップロードまたはフェッチすることができます。リストアイテムは、ウェブサイトまたはアプリに表示される単一の物件です。

サポートされるフィードフォーマット

カタログ内のすべての物件を単一のフィードで表すことも、複数のフィードを作成して、各フィードが1つの国、1つの不動産会社、または1つの仲介業者の物件を表すようにすることもできます。

Advantage+カタログ広告では、以下のいずれかのフォーマットでリストフィードを入力する必要があります。

ファイルフォーマット説明サンプルファイル

XML

通常、自動フィード提供システムによって生成されます。ルート<listings>XMLノードに<listing>ノードのセットが含まれており、その各ノードは1つの物件リスティングを表しています。ファイルの先頭には、有効な<?xml宣言タグが必要です。

ダウンロード

CSV、TSV

最初の行には、選択したフィールドの名前を、値を指定する順序でリストする必要があります。その後の行では、不動産・住宅の対応する値が提供されます。画像のような入れ子または複数値フィールドは、JSONエンコードされた値を使用したり、image[0].urlimage[0].tag[0]image[0].tag[1]といったJSON-path構文を使用してラベルを付けたプレーンテキスト列のセットで表現することができます。

ダウンロード(CSV)

コマースでは、リストフィードにXMLフォーマットで入力する必要があります。

ファイルフォーマット説明

XML

通常、自動フィード提供システムによって生成されます。ルート<listings>XMLノードに<listing>ノードのセットが含まれており、その各ノードは1つの物件リスティングを表しています。ファイルの先頭には、有効な<?xml宣言タグが必要です。

CSV、TSV、JSON

現在、これらのフォーマットはサポートされていません。

フィードパーサーがUTF8UTF16UTF32のテキストエンコードを自動的に検出し、予期しないバイトシーケンスがあると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>

サポートされているフィールド - 不動産・住宅リスト

以下のサポートされているフィールドは、商品カタログに追加するアイテムとして用意されたものです。

カタログのローカライゼーションについては、不動産・住宅リストで利用できるフィールドをご覧ください。

フィードパーサーがUTF8UTF16UTF32のテキストエンコードを自動的に検出し、予期しないバイトシーケンスがあるとLATIN1にフォールバックします。フィールド値のテキストには任意の言語を使用できますが、フィールド名は英語で以下のとおり正確に指定する必要があります。

フィールド名と型説明

home_listing_id

型: 文字列

Advantage+カタログ広告とコマースでは必須

不動産・住宅(アパート/コンドミニアム)リストの一意のID。最も細かいIDです。

例: FB_home_1234

home_listing_group_id

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合、任意。

建物またはアパートの一意のID。グループごとに一意にしてください。

name

型: 文字列

Advantage+カタログ広告とコマースでは必須

不動産・住宅リストのタイトル例: Modern Eichler in Green Oaks

availability

型: 文字列

Advantage+カタログ広告とコマースでは必須

不動産・住宅リストの空き状況。使用できる値: for_salefor_rentsale_pendingrecently_soldoff_marketavailable_soon。コマースの場合、サポートされる値は'for_rent'のみです。

address

型: 文字列

Advantage+カタログ広告とコマースでは必須

目的地の場所を正確に特定できる町名・番地。

住所オブジェクトのパラメーターをご覧ください。

例: 1 Hacker Way

address.city

型: 文字列

Advantage+カタログ広告とコマースでは必須

物件の所在地の市区町村。

住所オブジェクトのパラメーターをご覧ください。

例: Menlo Park

address.region

型: 文字列

Advantage+カタログ広告とコマースでは必須

物件が所在する都道府県名です。

住所オブジェクトのパラメーターをご覧ください。

例: Menlo Park

address.country

型: オブジェクト

Advantage+カタログ広告とコマースでは必須

物件の所在地の国。

住所オブジェクトのパラメーターをご覧ください。

例: United States

address.postal_code

型: 文字列

Advantage+カタログ広告とコマースでは必須

物件の所在地の国。

住所オブジェクトのパラメーターをご覧ください。

例: United States

latitude

型: 浮動小数点数

Advantage+カタログ広告とコマースでは必須

リストの緯度。

例: 37.484100

longitude

型: 浮動小数点数

Advantage+カタログ広告とコマースでは必須

リストの経度。

例: -122.148252

neighborhood

型: 文字列

Advantage+カタログ広告の場合、必須。オプションですが、コマースの場合には強くおすすめします

地域の最大数: 20

物件の地域のリスト。複数の地域を指定できます。地域が複数ある場合は、地域ごとにカラムを追加し、各カラム名にJSONパス構文を使用して、地域の数を指定します。

例: neighborhood[0]; neighborhood[1]

price

型: 文字列

Advantage+カタログ広告とコマースでは必須

物件の販売価格または賃貸価格。価格を料金として設定し、後ろに[3桁のISO通貨コード](https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70">)を追加します。料金と通貨の間にはスペースを挿入してください。

例: 13,999 USD

image

型: オブジェクト

Advantage+カタログ広告とコマースでは必須

最大画像:20

最大サイズ: 4 MB

広告で使用されている画像のURL。

  • カルーセル広告フォーマットでアスペクト比が正方形(1:1)の場合、画像サイズは600x600ピクセルにする必要があります。
  • シングル画像広告の場合、画像サイズは1200x630以上にする必要があります。
  • コマースでは、最初の写真はコマースフィードにカバー画像として表示されます。

例: image[0].urlimage[0].tag[0]

画像オブジェクトパラメーターをご覧ください。

url

型: 文字列

Advantage+カタログ広告とコマースでは必須

物件リストページへのリンク。有効なURLである必要があります。

画像オブジェクトパラメーターをご覧ください。

例: http://www.realestate.com

description

型: 文字列

Advantage+カタログ広告の場合は任意。コマースの場合は必須

最大文字数: 5000

物件の説明。

例: Beautiful 3BD home available in Belmont

num_beds

型: 浮動小数点数

Advantage+カタログ広告の場合は任意。コマースの場合は必須

寝室の総数。スタジオの場合は0を使用できます

例: 2

num_baths

型: 浮動小数点数

Advantage+カタログ広告の場合は任意

浴室の総数。コマースの場合は、最低でも1にしてください。

num_rooms

型: 浮動小数点数

Advantage+カタログ広告には適用されない。コマースの場合は必須。

物件の部屋の合計数。

property_type

型: 文字列

Advantage+カタログ広告の場合は任意

物件の種類。Advantage+カタログ広告に使用できる値: apartmentcondohouselandmanufacturedothertownhouse。コマースに使用できるサポート値: apartmentbuilder_floorcondohousehouse_in_condominiumhouse_in_villaloftpenthousestudiotownhouseother

listing_type

型: 文字列

Advantage+カタログ広告の場合は任意

物件リストの種類。Advantage+カタログ広告に使用できる値: for_rent_by_agentfor_rent_by_ownerfor_sale_by_agentfor_sale_by_ownerforeclosednew_constructionnew_listing。コマースに使用できる値: for_rent_by_agent, for_rent_by_owner

area_size

型: 整数

Advantage+カタログ広告には適用されない。コマースの場合は必須。

フロアプランのリストのエリアまたはスペース。

area_unit

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合は必須。

床面積の値の単位(平方フィートまたは平方メートル)。使用できる値: sq_ftsq_m

ac_type

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合、任意。

エアコンの種類。使用できる値: centralothernone

furnish_type

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合、任意。

この物件で利用可能な家具の種類。使用できる値: furnishedsemi-furnishedunfurnished

heating_type

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合、任意。

物件に設置された暖房の種類。使用できる値: centralgaselectricradiatorothernone

laundry_type

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合、任意。

使用できる洗濯の種類。使用できる値: in_unitin_buildingothernone

num_units

型: 整数

Advantage+カタログ広告とコマースの場合、任意

賃貸可能なユニット(アパート、コンドミニアム)の総数

例: 0

parking_type

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合、任意。

物件の利用可能な駐車場の種類。使用できる値: garagestreetoff-streetothernone

partner_verification

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合、任意。

パートナー企業がリストを確認したかどうか。使用できる値: verifiednone

year_built

型: 文字列

物件が建てられた年(YYYYのフォーマットで年を4桁で記入)。

例: 1994年。

pet_policy

型: 文字列

Advantage+カタログ広告には適用されない。コマースの場合、任意。

この物件で許可されているペットを示します: catdogallnone

available_dates_price_config

型: オブジェクト

リストが利用可能になる日付と価格のリスト。価を入力すると、Facebookで利用可能な日付に基づくリストを提案し、関連価格を広告でダイナミックに表示することができます。

利用可能日のオブジェクトパラメーター

applink

型: オブジェクト

リストへのアプリリンク。

status

型: 文字列

カタログのアイテムがアクティブなのかアーカイブ済みなのかを制御します。アクティブなアイテムだけが、広告、ショップ、その他のチャネルで表示されます。使用できる値: activearchived。アイテムは、デフォルトではactiveになっています。詳しくは、アイテムのアーカイブをご覧ください。


例: active


: Shopifyなど一部のパートナープラットフォームでは、stagingというステータスを使用して、アイテムをカタログに同期することがあります。これは、archivedと同じ動作です。

以前、このフィールドはvisibilityと呼ばれていました。このフィールド名もまだ使えますが、新しい名前の使用をおすすめします。

国別の必須フィールド — コマースのみ

コマースの国別の必須フィールドについては、Marketplaceプラットフォームのドキュメントをご覧ください

画像オブジェクトのパラメーター


フィールド名と型説明

url

型: 文字列

Advantage+カタログ広告とコマースでは必須

画像のソースURL。下記の画像仕様に従ってください。

  • すべての画像は、JPG、GIF、PNGのいずれかのフォーマットでなければなりません。

  • カルーセル広告とコレクション広告: 画像は正方形(1:1)の形式で表示されます。最小画像サイズは500×500ピクセルです。最高の画質で表示するには、1024 x 1024ピクセルをおすすめします。

  • シングル画像広告: 画像は1.91:1のアスペクト比で表示されます。最小画像サイズは500×500ピクセルです。最適な画質となるように1,200x628ピクセルを推奨します。

tag

型: 文字列

Advantage+カタログ広告とコマースの場合、任意

画像の内容を示すために画像に付加されるタグ。1枚の画像に複数のタグを付けることもできます。

例: Fitness CenterSwimming Pool

INSTAGRAM_STANDARD_PREFERRED - 広告主はこれを使用して、フィード内の特定の画像をInstagramで使用されるデフォルトの画像としてタグ付けすることができます。このタグでは大文字/小文字が区別されます。

住所オブジェクトのパラメーター


フィールド名と型説明

addr1

型: 文字列

必須

ホテルの番地です。

例: 675 El Camino Real

city

型: 文字列

必須

ホテルが所在する市区町村です。

例: Palo Alto

region

型: 文字列

必須

ホテルが所在する都道府県名です。

例: California

country

型: 文字列

必須

ホテルが所在する国です。

例: United States

postal_code

型: 文字列

物件の所在地の郵便番号。必須(郵便番号制度のない国を除く)。

例: 94125NW1 3FG


利用可能になる日 価格設定

available_dates_price_configで、指定された期間の各物件の空き状況と価格を入力することができます。このフィールドに期間を含めると、Facebookはこの空き状況を当社の商品のおすすめに掲載し、サイトで検索された日付の利用可能なリストを表示します。任意で価格を含める場合、広告クリエイティブに日付指定の価格を表示することもできます。この機能を有効にするには、ピクセルイベントにFacebookのlease_start_datelease_end_dateを送信する必要があります。

利用可能な日付オブジェクトのパラメーター


フィールド名と型説明

start_date

型: 文字列

end_dateが入力されている場合、任意

ISO-8601形式の利用可能な期間の開始。開始日を含む。start_dateのみを入力した場合、end_dateのデフォルトはその日の1年後です。

例: YYYY-MM-DD (2018-01-01)。

end_date

型: 文字列

start_dateを入力した場合、任意

ISO-8601形式の利用可能な期間の終了。終了日は除外。end_dateのみを入力した場合、start_dateのデフォルトは現在の日付です。

例: YYYY-MM-DD (2018-02-01)。

rate

型: 文字列

この期間中の出品の整数価格。

例: 10000 (出品が$100.00 USDだった場合)

currency

型: 文字列

rateを入力した場合、必須。

ISO-4217通貨コード。

例: USDGBPなど

interval

型: 文字列

指定された金額に保たれる期間。

使用できる値: nightlyweeklymonthlysale

これは、リストの空き状況と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",
    },
]

製品ディープリンク

App Linksの仕様に従って、フィードでディープリンクを指定します。フィードのディープリンク情報は、FacebookがウェブクローラーでApp Linksメタデータを使用して収集する情報よりも優先されます。

App Linksからのディープリンク情報がすでにある場合、このデータを指定する必要はありません。Facebookは、App Linksからの情報を使用して正しいディープリンクを表示します。広告にディープリンクを表示するには、Advantage+カタログ広告、広告テンプレートをご覧ください。

ステップ3: オプションを更新する

Advantage+カタログ広告

Advantage+カタログ広告では、カタログ内の物件リスティング情報は、以下の方法でダイレクトにアップロードすることによって更新できます。ダイレクトアップロードフィードのリファレンス

— 次のようにして1回限りのアップロードを手動で実行できます。

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

コマース

コマースでは、定期のフィードアップロード(スケジュール)を設定し、フィードを更新することにより、カタログ内の不動産・住宅リストの情報を更新することができます。Marketplaceでは、スケジュールを設定するオプションを使用することを強くおすすめします。

カタログデータフィードアップロードのスケジュールを設定する

  1. コマースマネージャに移動します。
  2. [データソース]をクリックします。
  3. [データソースを追加]をクリックします。
  4. [データフィードを使用]をクリックし、[次へ]をクリックします。
  5. [スケジュールを設定する]をクリックします。
  6. Facebookでデータフィードの更新をチェックする頻度(毎日毎時毎週)を選択します。頻度に[毎時]または[毎週]を選択した場合、定期的なアップロードのスケジュールも指定できます。
  7. フィードへのダイレクトURLを入力します。HTTP、HTTPS、FTP、またはSFTPを使用するURLを使用できます。注: URLはデータフィードファイルに直接リンクしている必要があります。直接リンクしていない場合は、アップロードが失敗する可能性があります。
  8. (任意)データフィードのプロバイダーのユーザーネームとパスワードを入力します。これはFacebook広告アカウントへのアクセスに使用しているユーザーネームおよびパスワードとは異なります。
  9. データフィードの名前を入力します。
  10. データフィードの通貨タイプを選択します。通貨タイプは、データフィードファイルで通貨が指定されていない場合に、データフィードで適用されます。
  11. [次へ]をクリックします。
  12. エラーがないかデータフィードファイルを確認します。ファイルに必須事項の列がない場合や、Facebookが認識できない列がある場合は、こちらで適切な列をマッピングできます。ここでマッピングされた列はすべて、今後のデータフィードのアップロード用に保存されます。
  13. [次へ]をクリックします。

多言語フィードアップロード

コマースでは多言語のエクスペリエンスをサポートしています。カタログにセカンダリ言語フィードを追加すると、1つのカタログからセカンダリ言語を使用して別のフィードを作成することができます。関連性のあるオーディエンスが出品を閲覧する際に、デフォルトの言語がセカンダリフィードに関する情報で上書きされます。

この機能は、特定の国のパートナーにのみ適用されます。市場で使用できるかどうかを知るには、Facebook担当者にお問い合わせください

  1. デフォルトの言語と国のデータフィードを作成します。
  2. リストID(home_listing_id)と名前、説明、または追加フィールドといったローカル言語の上書きが必要なフィールドのみでXMLファイルを作成します。情報を上書きするには、home_listing_idが元のカタログデータフィードのものと一致している必要があります。
  3. コマースマネージャから追加情報フィードを追加します。

    コマースマネージャの追加フィード [不動産・住宅リストの情報を追加] - [言語情報を追加]


  4. 同じカタログ内の2つのデータソースを確認します。

ステップ4: リスティングカタログのフィルター処理によるリスティングセットへの絞り込み

これは、Advantage+カタログ広告で宣伝するカタログ内のアイテムのグループです。各リスティングカタログには、多数のリスティングセットを含めることができます。

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

上記のfilterは、次に挙げる演算子やデータで構成されます。

演算子フィルターのタイプ

i_contains

サブストリングを含む(大文字/小文字の区別なし)

i_not_contains

サブストリングを含まない(大文字/小文字の区別なし)

contains

サブストリングを含む(大文字/小文字の区別あり)

not_contains

サブストリングを含まない(大文字/小文字の区別あり)

eq

等しい(大文字/小文字の区別なし)

neq

等しくない(大文字/小文字の区別なし)

lt

より小さい(数値フィールドのみ)

lte

以下(数値フィールドのみ)

gt

より大きい(数値フィールドのみ)

gte

以上(数値フィールドのみ)

データフィルター処理するデータ

availability

リスティングの空き状況。例: for_sale

listing_type

リスティングのタイプ。例: for_sale_by_agent

property_type

物件のタイプ。例: house

price

リスティングの価格

name

名前

city

市区町村

country

region

地域または州

postal_code

郵便番号

num_beds

ベッド数

num_baths

バスルーム数

ステップ5: オフラインコンバージョンを送信する

オフラインコンバージョンイベントを送信し、コンバージョン前にFacebook広告やコマースのリスティングを閲覧またはクリックした顧客数を確認することができます。するオフラインコンバージョンAPIを使用し、ステップ4に以下のフィールドを追加してください。オフラインイベントをアップロードします

一致キー

一致キーはユーザーとのコンバージョンを比較します。

キー説明

email

メールアドレス

ハッシュ

phone

電話番号

ハッシュ

fn

ハッシュ

ln

ハッシュ

madid

AppleまたはAndroidの広告ID

ハッシュ

zip

郵便番号

ハッシュ

ct

市区町村

ハッシュ

st

都道府県

ハッシュ

country

ハッシュ

dob

生年月日(DD形式)

ハッシュ

doby

生年月日(YYYY形式)

ハッシュ

gen

ジェンダー

ハッシュ

age

年齢

ハッシュ

lead_id

MarketplaceのリードID

カスタムデータ

カスタムデータはディーラーとのコンバージョンを比較します。

フィールド説明

content_ids

home_listing_id(カタログアップロードより)

content_type

APARTMENTに設定

イベントの詳細

イベントの詳細には、発生したオフラインのコンバージョンイベントについて記載されます。アップロード頻度は毎日、イベントから48時間以内です。

フィールド説明

event_name

必須

イベントタイプの列挙型。

ViewContent

Search

AddToCart

AddToWishlist

Lead = 電話があったり、他の有資格者リードがあった

CompleteRegistration = 予約の設定

InitiateCheckout = 代理店訪問

AddPaymentInfo = 物件閲覧

Purchase = リース契約済み

Other

event_time

必須

イベントの時間

value

必須

家賃の値。非リリースイベントの場合は0に設定します。

currency

必須

通貨コード