부동산 타겟 빌드

마케팅 API v15.0 릴리스부터 더 이상 특별 광고 타겟을 만들 수 없습니다. 자세한 내용은 특별 광고 타겟을 참조하세요.

부동산 타겟을 만드는 방법:

1단계: 부동산 이벤트에 대해 사용자 신호 설정
2단계: 사용자 신호를 카탈로그에 연결
3단계: 부동산 이벤트 소스 그룹 만들기
4단계: 부동산 타겟 만들기

1단계: 부동산 이벤트에 대해 사용자 신호 설정

웹사이트나 앱에서 전송할 수 있는 사전 지정된 이벤트 이름이며, 이를 통해 캠페인 성과를 측정할 수 있을 뿐만 아니라 타겟으로부터 인텐트를 수집할 수 있습니다. Facebook 픽셀 설정을 참조하세요.

부동산 광고는 아래와 같이 웹사이트 픽셀과 모바일 앱의 표준 이벤트가 필요합니다.

픽셀 이벤트	앱 이벤트	요구 사항 수준	설명
`Search`	`fb_mobile_search`	◉	사용자가 매물 품목을 검색한 경우
`ViewContent`	`fb_mobile_content_view`	◉	사용자가 특정 품목을 본 경우
`InitiateCheckout`	`fb_mobile_initiated_ checkout`	◉	사용자가 품목을 저장하거나 '좋아요'를 눌렀거나 특별한 관심을 표했을 경우
`Purchase`	`fb_mobile_purchase`	◉	사용자가 품목에 대해 에이전트에 연락한 경우

◉ 필수: 해당 매개변수 없이 광고가 작동하지 않습니다.
◎ 권장: 필수는 아니지만 광고 추천이나 타게팅 옵션이 개선됩니다. 최대한 많이 제공합니다.
◯ 선택: 필수가 아니며 무시할 수 있습니다.

예를 들어 FB 픽셀이나 앱 이벤트를 사용하여 품목에 대한 검색 이벤트를 보고하려면 아래의 코드를 검색 결과 페이지에 넣습니다.

<!-- 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` 이벤트는 상위 결과 `['1234', '2345', '3456', '4567']`에 대한 ID 배열을 전송합니다.
`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`	Facebook에서 데이터 가용성에 따라 (카탈로그의 `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=