商取引のために不動産のリストを公開するには、ビジネスの認証を受ける必要があります。
ステップ1: 不動産・住宅リストカタログを作成します。
ステップ2: リストと価格を設定します。
ステップ3: オプションを更新します。
ステップ4: リストカタログをリストセットにフィルタリングします。
ステップ5: オフラインコンバージョンを送信します(任意)。
ステップ6: 不動産のオーディエンスを作成します。ユーザーが公開する不動産リストとは異なり、リードはパートナー統合のためにMessengerチャットではなくリードフォームでパートナーに送信されます。コマースのリード取得について詳しくはこちら。
ステップ7: ホームリスト用の広告を作成して配信します。
ステップ8: 配信情報を入手して、Facebook上のユーザーの広告エンゲージメントを確認します。広告インサイトをご覧ください。
ステップ9: デバッグツールを使用して、問題を診断して解決します。Advantage+カタログ広告のデバッグツールをご覧ください。
カタログには、宣伝したい物件のリストが含まれている必要があります。カタログリファレンスをご覧ください。
Advantage+カタログ広告用の不動産・住宅リストカタログを作成するには、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プラットフォームのドキュメントをご覧ください。
リストには、リスティングID、名前、取り引き可能かどうか、説明、住所、寝室数、浴室数などの物件情報が含まれます。ビジネスからリストをアップロードまたはフェッチすることができます。リストアイテムは、ウェブサイトまたはアプリに表示される単一の物件です。
カタログ内のすべての物件を単一のフィードで表すことも、複数のフィードを作成して、各フィードが1つの国、1つの不動産会社、または1つの仲介業者の物件を表すようにすることもできます。
Advantage+カタログ広告では、以下のいずれかのフォーマットでリストフィードを入力する必要があります。
ファイルフォーマット | 説明 | サンプルファイル |
---|---|---|
XML | 通常、自動フィード提供システムによって生成されます。ルート | |
CSV、TSV | 最初の行には、選択したフィールドの名前を、値を指定する順序でリストする必要があります。その後の行では、不動産・住宅の対応する値が提供されます。画像のような入れ子または複数値フィールドは、JSONエンコードされた値を使用したり、 | ダウンロード(CSV) |
コマースでは、リストフィードにXMLフォーマットで入力する必要があります。
ファイルフォーマット | 説明 |
---|---|
XML | 通常、自動フィード提供システムによって生成されます。ルート |
CSV、TSV、JSON | 現在、これらのフォーマットはサポートされていません。 |
フィードパーサーがUTF8
、UTF16
、UTF32
のテキストエンコードを自動的に検出し、予期しないバイトシーケンスがあるとLATIN1
にフォールバックします。
<?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
にフォールバックします。フィールド値のテキストには任意の言語を使用できますが、フィールド名は英語で以下のとおり正確に指定する必要があります。
フィールド名と型 | 説明 |
---|---|
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 不動産・住宅(アパート/コンドミニアム)リストの一意のID。最も細かいIDです。 例: |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合、任意。 建物またはアパートの一意のID。グループごとに一意にしてください。 |
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 不動産・住宅リストのタイトル例: |
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 不動産・住宅リストの空き状況。使用できる値: |
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 目的地の場所を正確に特定できる町名・番地。 住所オブジェクトのパラメーターをご覧ください。 例: |
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 物件の所在地の市区町村。 住所オブジェクトのパラメーターをご覧ください。 例: |
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 物件が所在する都道府県名です。 住所オブジェクトのパラメーターをご覧ください。 例: |
型: オブジェクト | Advantage+カタログ広告とコマースでは必須。 物件の所在地の国。 住所オブジェクトのパラメーターをご覧ください。 例: |
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 物件の所在地の国。 住所オブジェクトのパラメーターをご覧ください。 例: |
型: 浮動小数点数 | Advantage+カタログ広告とコマースでは必須。 リストの緯度。 例: |
型: 浮動小数点数 | Advantage+カタログ広告とコマースでは必須。 リストの経度。 例: |
型: 文字列 | Advantage+カタログ広告の場合、必須。オプションですが、コマースの場合には強くおすすめします。 地域の最大数: 20 物件の地域のリスト。複数の地域を指定できます。地域が複数ある場合は、地域ごとにカラムを追加し、各カラム名にJSONパス構文を使用して、地域の数を指定します。 例: |
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 物件の販売価格または賃貸価格。価格を料金として設定し、後ろに[3桁のISO通貨コード](https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70">)を追加します。料金と通貨の間にはスペースを挿入してください。 例: |
型: オブジェクト | Advantage+カタログ広告とコマースでは必須。 最大画像:20 最大サイズ: 4 MB 広告で使用されている画像のURL。
例: 画像オブジェクトパラメーターをご覧ください。 |
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 物件リストページへのリンク。有効なURLである必要があります。 画像オブジェクトパラメーターをご覧ください。 例: |
型: 文字列 | Advantage+カタログ広告の場合は任意。コマースの場合は必須。 最大文字数: 5000 物件の説明。 例: |
型: 浮動小数点数 | Advantage+カタログ広告の場合は任意。コマースの場合は必須。 寝室の総数。スタジオの場合は 例: |
型: 浮動小数点数 | Advantage+カタログ広告の場合は任意。 浴室の総数。コマースの場合は、最低でも |
型: 浮動小数点数 | Advantage+カタログ広告には適用されない。コマースの場合は必須。 物件の部屋の合計数。 |
型: 文字列 | Advantage+カタログ広告の場合は任意。 物件の種類。Advantage+カタログ広告に使用できる値: |
型: 文字列 | Advantage+カタログ広告の場合は任意。 物件リストの種類。Advantage+カタログ広告に使用できる値: |
型: 整数 | Advantage+カタログ広告には適用されない。コマースの場合は必須。 フロアプランのリストのエリアまたはスペース。 |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合は必須。 床面積の値の単位(平方フィートまたは平方メートル)。使用できる値: |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合、任意。 エアコンの種類。使用できる値: |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合、任意。 この物件で利用可能な家具の種類。使用できる値: |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合、任意。 物件に設置された暖房の種類。使用できる値: |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合、任意。 使用できる洗濯の種類。使用できる値: |
型: 整数 | Advantage+カタログ広告とコマースの場合、任意。 賃貸可能なユニット(アパート、コンドミニアム)の総数 例: |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合、任意。 物件の利用可能な駐車場の種類。使用できる値: |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合、任意。 パートナー企業がリストを確認したかどうか。使用できる値: |
型: 文字列 | 物件が建てられた年(YYYYのフォーマットで年を4桁で記入)。 例: 1994年。 |
型: 文字列 | Advantage+カタログ広告には適用されない。コマースの場合、任意。 この物件で許可されているペットを示します: |
型: オブジェクト | リストが利用可能になる日付と価格のリスト。価を入力すると、Facebookで利用可能な日付に基づくリストを提案し、関連価格を広告でダイナミックに表示することができます。 |
型: オブジェクト | リストへのアプリリンク。 |
型: 文字列 | カタログのアイテムがアクティブなのかアーカイブ済みなのかを制御します。アクティブなアイテムだけが、広告、ショップ、その他のチャネルで表示されます。使用できる値: 例: 注: Shopifyなど一部のパートナープラットフォームでは、stagingというステータスを使用して、アイテムをカタログに同期することがあります。これは、 以前、このフィールドは |
コマースの国別の必須フィールドについては、Marketplaceプラットフォームのドキュメントをご覧ください。
フィールド名と型 | 説明 |
---|---|
型: 文字列 | Advantage+カタログ広告とコマースでは必須。 画像のソースURL。下記の画像仕様に従ってください。
|
型: 文字列 | Advantage+カタログ広告とコマースの場合、任意。 画像の内容を示すために画像に付加されるタグ。1枚の画像に複数のタグを付けることもできます。 例:
|
フィールド名と型 | 説明 |
---|---|
型: 文字列 | 必須。 ホテルの番地です。 例: |
型: 文字列 | 必須。 ホテルが所在する市区町村です。 例: |
型: 文字列 | 必須。 ホテルが所在する都道府県名です。 例: |
型: 文字列 | 必須。 ホテルが所在する国です。 例: |
型: 文字列 | 物件の所在地の郵便番号。必須(郵便番号制度のない国を除く)。 例: |
available_dates_price_config
で、指定された期間の各物件の空き状況と価格を入力することができます。このフィールドに期間を含めると、Facebookはこの空き状況を当社の商品のおすすめに掲載し、サイトで検索された日付の利用可能なリストを表示します。任意で価格を含める場合、広告クリエイティブに日付指定の価格を表示することもできます。この機能を有効にするには、ピクセルイベントにFacebookのlease_start_date
とlease_end_date
を送信する必要があります。
フィールド名と型 | 説明 |
---|---|
型: 文字列 |
ISO-8601形式の利用可能な期間の開始。開始日を含む。 例: |
型: 文字列 |
ISO-8601形式の利用可能な期間の終了。終了日は除外。 例: |
型: 文字列 | この期間中の出品の整数価格。 例: |
型: 文字列 |
ISO-4217通貨コード。 例: |
型: 文字列 | 指定された金額に保たれる期間。 使用できる値: |
これは、リストの空き状況と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+カタログ広告、広告テンプレートをご覧ください。
Advantage+カタログ広告では、カタログ内の物件リスティング情報は、以下の方法でダイレクトにアップロードすることによって更新できます。ダイレクトアップロードフィードのリファレンス
例 — 次のようにして1回限りのアップロードを手動で実行できます。
curl \
-F "url=http://www.example.com/sample_feed.xml" \
-F "access_token=
コマースでは、定期のフィードアップロード(スケジュール)を設定し、フィードを更新することにより、カタログ内の不動産・住宅リストの情報を更新することができます。Marketplaceでは、スケジュールを設定するオプションを使用することを強くおすすめします。
コマースでは多言語のエクスペリエンスをサポートしています。カタログにセカンダリ言語フィードを追加すると、1つのカタログからセカンダリ言語を使用して別のフィードを作成することができます。関連性のあるオーディエンスが出品を閲覧する際に、デフォルトの言語がセカンダリフィードに関する情報で上書きされます。
この機能は、特定の国のパートナーにのみ適用されます。市場で使用できるかどうかを知るには、Facebook担当者にお問い合わせください。
これは、Advantage+カタログ広告で宣伝するカタログ内のアイテムのグループです。各リスティングカタログには、多数のリスティングセットを含めることができます。
curl \
-F "name=test set" \
-F 'filter={"availability":{"eq":"for_sale"}}' \
-F "access_token=" \
https://graph.facebook.com/
上記のfilter
は、次に挙げる演算子やデータで構成されます。
演算子 | フィルターのタイプ |
---|---|
| サブストリングを含む(大文字/小文字の区別なし) |
| サブストリングを含まない(大文字/小文字の区別なし) |
| サブストリングを含む(大文字/小文字の区別あり) |
| サブストリングを含まない(大文字/小文字の区別あり) |
| 等しい(大文字/小文字の区別なし) |
| 等しくない(大文字/小文字の区別なし) |
| より小さい(数値フィールドのみ) |
| 以下(数値フィールドのみ) |
| より大きい(数値フィールドのみ) |
| 以上(数値フィールドのみ) |
データ | フィルター処理するデータ |
---|---|
| リスティングの空き状況。例: |
| リスティングのタイプ。例: |
| 物件のタイプ。例: |
| リスティングの価格 |
| 名前 |
| 市区町村 |
| 国 |
| 地域または州 |
| 郵便番号 |
| ベッド数 |
| バスルーム数 |
オフラインコンバージョンイベントを送信し、コンバージョン前にFacebook広告やコマースのリスティングを閲覧またはクリックした顧客数を確認することができます。するオフラインコンバージョンAPIを使用し、ステップ4に以下のフィールドを追加してください。オフラインイベントをアップロードします。
一致キーはユーザーとのコンバージョンを比較します。
キー | 説明 |
---|---|
| メールアドレス ハッシュ |
| 電話番号 ハッシュ |
| 名 ハッシュ |
| 姓 ハッシュ |
| AppleまたはAndroidの広告ID ハッシュ |
| 郵便番号 ハッシュ |
| 市区町村 ハッシュ |
| 都道府県 ハッシュ |
| 国 ハッシュ |
| 生年月日(DD形式) ハッシュ |
| 生年月日(YYYY形式) ハッシュ |
| ジェンダー ハッシュ |
| 年齢 ハッシュ |
| MarketplaceのリードID |
カスタムデータはディーラーとのコンバージョンを比較します。
フィールド | 説明 |
---|---|
|
|
|
|
イベントの詳細には、発生したオフラインのコンバージョンイベントについて記載されます。アップロード頻度は毎日、イベントから48時間以内です。
フィールド | 説明 |
---|---|
| 必須 イベントタイプの列挙型。
|
| 必須 イベントの時間 |
| 必須 家賃の値。非リリースイベントの場合は |
| 必須 通貨コード |