Advantage+ カタログ広告

不動産オーディエンスの構築

マーケティングAPI v15.0のリリースに伴い、特別な広告オーディエンスを今後作成することはできなくなります。詳しくは、特別な広告オーディエンスを参照してください。

不動産オーディエンスは次のように作成します。

ステップ1: 不動産イベント用のユーザーシグナルをセットアップする

ウェブサイトまたはアプリから送信できる事前定義されたイベント名を以下に示します。これらを使用して、キャンペーンのパフォーマンスを測定するとともに、オーディエンスからインテントをキャプチャすることができます。Facebookピクセルのセットアップをご覧ください。

不動産広告には、次に示すウェブサイトピクセルとモバイルアプリからの標準イベントが必要です。

ピクセルイベントアプリイベント必須レベル説明

Search

fb_mobile_search

◉

利用者が物件リスティングを検索した

ViewContent

fb_mobile_content_view

◉

利用者が特定のリスティングを閲覧した

InitiateCheckout

fb_mobile_initiated_ checkout

◉

利用者がリスティングを保存または「いいね！」したか、特別な興味を示した

Purchase

fb_mobile_purchase

◉

利用者がリスティングに関してエージェントに問い合わせをした

  • ◉ 必須: これらのパラメーターがないと広告は機能しません。
  • ◎ 推奨: 厳密には必須ではありませんが、広告でより適切なおすすめを提示できるようになり、ターゲット設定オプションが増えます。できるだけ多く指定してください。
  • ◯ 必須ではない: 必須ではなく、無視してもかまいません。

例えば、FBピクセルまたはアプリイベントを使用してリスティングのSearchイベントを報告するには、次のコードを検索結果ページに配置します。

<!-- Facebook Pixel Code -->
Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "home_listing");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "[\"1234\", \"2345\", \"3456\", \"4567\"]"); // top search results

// we must prefix all travel-specific parameters with fb_
parameters.putString("fb_city", "New York City"); // Required for Search event
parameters.putString("fb_region", "New York"); // region is the state for the US. Required for Search event
parameters.putString("fb_country", "US"); // Required for Search event

logger.logEvent(
  AppEventsConstants.EVENT_NAME_SEARCHED,
  parameters
);
[FBSDKAppEvents logEvent:FBSDKAppEventNameSearched
  parameters:@{
    FBSDKAppEventParameterNameContentType : @"home_listing",
    FBSDKAppEventParameterNameContentID : @"[\"1234\", \"2345\", \"3456\", \"4567\"]", // top search results
		// we must prefix all travel-specific parameters with fb_
		@"fb_city" : @"New York City", //Required for Search event
	  @"fb_region" : @"New York", // region is the state for the US. Required for Search event
	  @"fb_country" : @"US", // Required for Search event
  }
];

起動するイベントを決定したら、各イベントのパラメーターを指定する必要があります。

イベントパラメーター

以下の表は必須パラメーターと推奨パラメーターのリストです。

ピクセルパラメーターモバイルパラメーター必須レベル

content_ids

fb_content_id

◉

content_type

fb_content_type

◯

lease_start_date

◎

lease_end_date

◎

preferred_baths_range

◎

preferred_beds_range

◎

preferred_price_range

◎

currency

fb_currency

◎

property_type

◎

listing_type

◎

availability

◎

city

fb_city

◎

neighborhood

◎

region

fb_region

◎

country

fb_country

◎

パラメーターの詳細

パラメーター名データ型説明

availability

string

値は、available_soon、for_rent、for_sale、off_market、recently_sold、sale_pendingのいずれかにする必要があります。

city

string

利用者が興味を示した都市を指定します。例: 'Menlo Park'

content_ids

stringまたはstring[]

リスティングカタログ内の任意のID。例えば、ViewContentイベントの場合は閲覧されたアイテムのIDを送信し、Searchの場合は結果上位のIDの配列(例: ['1234', '2345', '3456', '4567'])を送信します。

content_type

stringまたはstring[]

例:

  • 'home_listing'
  • ['home_listing', 'product']
  • ['home_listing', 'hotel']

country

string

利用者が興味を示した国。例: 'United States'

currency

string

ISO 4217通貨形式で指定します。例: 'USD'

lease_start_date

string

利用可能な日付(カタログのavailable_dates_price_configを使用)に基づいて物件をおすすめし、ユーザーのランディングエクスペリエンスを向上させることができます(テンプレートタグを使用)。ISO 8601日付形式'YYYY-MM-DD'で指定します。例: 2018-01-01

lease_end_date

string

ISO 8601日付形式'YYYY-MM-DD'で指定します。例: '2018-02-01'

listing_type

string

値は、for_rent_by_agent、for_rent_by_owner、for_sale_by_agent、for_sale_by_owner、foreclosed、new_construction、new_listingのいずれかにする必要があります。

neighborhood

string

利用者が興味を示した近隣エリア。例: 'Menlo Oaks'

preferred_baths_range

[int(最小), int(最大)]

選択された浴室数の範囲・例: [1, 2]

preferred_beds_range

[int(最小), int(最大)]

選択された寝室数の範囲。例: [1, 2]

preferred_price_range

[float(最小), float(最大)]

価格の範囲。例: [1000.99, 2000.99]

property_type

string

値は、apartment、condo、house、land、manufactured、other、townhouseのいずれかにする必要があります。

region

string

利用者が興味を示した州、地区、または地域。例: 'California'

ステップ2: シグナルをリスティングカタログに関連付ける

イベントソースを各リスティングカタログに関連付けます。ビジネスマネージャのカタログページをご覧ください。イベントを送信するピクセルとアプリをAPIで選択するには、次のようにHTTP POSTを送信します。

curl \
  -F '0=

次のパラメーターを指定します。

フィールド名データ型説明

external_event_sources (必須)

int[]

カタログと関連付けるピクセルおよびアプリIDのリスト。

ステップ3: 不動産イベントソースグループを作成して共有する

オーディエンスを作成するには、ビジネスの管理者がイベントソースグループを作成する必要があります。これにより、リスティングの興味シグナルを送信するすべてのソースをグループ化します。次のようにHTTP POSTを送信します。

curl \
  -F 'name=My Real Estate Company Events' \
  -F 'event_sources=['

次に、このイベントソースグループを、これらのイベントソースによって生成されたオーディエンスに広告を配信するすべての広告アカウントと共有します。次のようにHTTP POSTを送信します:

curl \
  -F 'accounts=['

ステップ4: オーディエンスを作成する

この時点で、ピクセルまたはアプリイベントからのシグナルのセットアップと、イベントソースグループおよび不動産カタログとの関連付けは完了しています。リスティングに興味がある利用者をターゲットとして設定するために、利用者のダイナミックオーディエンスを作成します。インテントシグナルに基づいて、利用者をオーディエンスに包含するかまたは除外します。また、ウェブサイトカスタムオーディエンスの場合と同様に、追加のルールベースのフィルターを適用してオーディエンスをカスタマイズできます。カスタムオーディエンスをご覧ください。

新規オーディエンスをセットアップするには、/act_<AD_ACCOUNT_ID>/customaudiencesにHTTP POSTを送信します。

必須パラメーター

フィールド名データ型説明

name

string

オーディエンス名。

subtype

enum {CLAIM}

カスタムオーディエンスのタイプ。CLAIMに設定する必要があります。

claim_objective

enum {HOME_LISTING}

オーディエンスの目的。HOME_LISTINGに設定する必要があります。

event_source_group

id

オーディエンスを構築するイベントソースグループ。

inclusions

object[]

JSONオブジェクトの配列。利用者をこのオーディエンスに包含する条件となる各インテントシグナルをリストします。

inclusions: event (必須)

enum { Search, ViewContent, InitiateCheckout, Purchase }

シグナルのイベント名。オーディエンスへの包含条件として使用します。例: {'event': 'Search', …}

inclusions: retention (必須)

object

イベントの受信以降の時間の最小値と最大値。包含条件としてイベントを考慮するかどうかを指定します。例: {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}リテンションは4時間以上にする必要があります。

inclusions: count

JSON演算子

イベントが起動された回数。等価演算子と数値比較演算子の両方を使用できます。例: {…'count': {'lte': 3}, …}

任意のパラメーター

フィールド名データ型説明

content_type

enum {HOME_LISTING}

このオーディエンスの構築に使用するシグナルのタイプ。

description

string

オーディエンスの説明。

exclusions

object[]

このオーディエンスから利用者を除外する各インテントシグナルをリストしたJSONオブジェクト配列。

exclusions: event (必須)

enum { Search, ViewContent, InitiateCheckout, Purchase }

除外条件として使用するシグナルのイベント名。例: {'event': 'Search', …}

exclusions: retention (必須)

object

イベント受信後の経過時間の最小値と最大値。除外条件としてイベントを考慮するかどうかを指定します。例: {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}リテンションは4時間以上にする必要があります。

rule

object

ウェブサイトカスタムオーディエンスからのオーディエンスルール。inclusionsとexclusionsが処理される前に、これらのルールによりイベントストリームをフィルターします。

利用可能な特定のフィールドのリストを参照してください。これらは、オーディエンスルール用の標準のJSON演算子とともに使用できます。

rule: home_listing_set_id (必須)

object

リスティングセットID。例: {'eq': '1234'}}

例えば、過去14日間に閲覧または購入した利用者をターゲットとして設定するオーディエンスを作成するには、次のようにします。

curl \
  -F 'name=Viewed or Purchased Last 14 days' \
  -F 'subtype=CLAIM' \
  -F 'claim_objective=HOME_LISTING' \
  -F 'content_type=HOME_LISTING' \
  -F 'event_source_group=