Quảng cáo danh mục Advantage+

Tạo đối tượng bất động sản

Kể từ bản phát hành API Marketing v15.0, bạn sẽ không thể tạo Đối tượng quảng cáo đặc biệt được nữa. Hãy xem phần Đối tượng quảng cáo đặc biệt để biết thêm thông tin.

Tạo đối tượng bất động sản:

Bước 1: Thiết lập tín hiệu người dùng cho các sự kiện bất động sản

Đây là những tên sự kiện được xác định trước mà bạn có thể gửi từ trang web hoặc ứng dụng để cho phép bạn vừa đo lường hiệu quả của chiến dịch vừa ghi lại ý định của đối tượng. Hãy xem phần Thiết lập Facebook Pixel.

Quảng cáo bất động sản yêu cầu những sự kiện tiêu chuẩn sau từ pixel trang web và ứng dụng di động của bạn:

Sự kiện pixelSự kiện trong ứng dụngCấp độ yêu cầuMô tả

Search

fb_mobile_search

◉

Ai đó đã tìm kiếm bài niêm yết nhà

ViewContent

fb_mobile_content_view

◉

Ai đó đã xem một bài niêm yết cụ thể

InitiateCheckout

fb_mobile_initiated_ checkout

◉

Ai đó đã lưu, thích hoặc đặc biệt quan tâm đến một bài niêm yết

Purchase

fb_mobile_purchase

◉

Ai đó đã liên hệ với đại lý về một bài niêm yết

  • ◉ Bắt buộc: Quảng cáo sẽ không hoạt động nếu không có những thông số này.
  • ◎ Khuyến nghị: Không hoàn toàn bắt buộc nhưng hỗ trợ các đề xuất tốt hơn và nhiều tùy chọn nhắm mục tiêu hơn cho quảng cáo của bạn. Hãy cung cấp càng nhiều càng tốt.
  • ◯ Không bắt buộc: Không bắt buộc và có thể bỏ qua.

Ví dụ: để báo cáo một sự kiện Tìm kiếm cho một bài niêm yết bằng Facebook pixel hoặc Sự kiện trong ứng dụng, hãy đặt mã sau vào trang kết quả tìm kiếm của bạn:

<!-- 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
  }
];

Sau khi xác định sự kiện nào sẽ được kích hoạt, bạn phải cung cấp thông số của từng sự kiện.

Thông số sự kiện

Bảng dưới đây liệt kê các thông số bắt buộc và đề xuất.

Thông số pixelThông số dành cho thiết bị di độngCấp độ yêu cầu

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

◎

Chi tiết thông số

Tên thông sốLoại dữ liệuMô tả

availability

string

Giá trị phải là available_soon, for_rent, for_sale, off_market, recently_sold hoặc sale_pending.

city

string

Cung cấp thành phố cần quan tâm của người dùng, ví dụ: 'Menlo Park'

content_ids

string hoặc string[]

Bất kỳ ID nào trong danh mục niêm yết của bạn. Ví dụ: đối với sự kiện ViewContent, hãy gửi ID của mục đã xem hoặc đối với Search, hãy gửi mảng ID cho kết quả liên quan nhất: ['1234', '2345', '3456', '4567']

content_type

string hoặc string[]

ví dụ:

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

country

string

Nhắm mục tiêu quốc gia cần quan tâm, chẳng hạn như 'United States'

currency

string

Được chỉ định bằng định dạng đơn vị tiền tệ theo ISO 4217: USD

lease_start_date

string

Cho phép chúng tôi đề xuất các tài sản dựa trên ngày áp dụng (sử dụng available_dates_price_config trong danh mục) và cải thiện trải nghiệm trang đích của người dùng (sử dụng thẻ mẫu). Được chỉ định bằng định dạng ngày ISO 8601: 'YYYY-MM-DD' (ví dụ: 2018-01-01).

lease_end_date

string

Được chỉ định bằng định dạng ngày ISO 8601: 'YYYY-MM-DD' (ví dụ: '2018-02-01').

listing_type

string

Giá trị phải là for_rent_by_agent, for_rent_by_owner, for_sale_by_agent, for_sale_by_owner, foreclosed, new_construction hoặc new_listing.

neighborhood

string

Khu vực cần quan tâm: 'Menlo Oaks'

preferred_baths_range

[int(tối thiểu), int(tối đa)]

Số phòng tắm được chọn làm phạm vi: [1, 2]

preferred_beds_range

[int(tối thiểu), int(tối đa)]

Số phòng ngủ được chọn làm phạm vi: [1, 2]

preferred_price_range

[float(tối thiểu), float(tối đa)]

Mức giá: [1000.99, 2000.99]

property_type

string

Phải là apartment, condo, house, land, manufactured, other hoặc townhouse.

region

string

Tiểu bang, quận hoặc khu vực cần quan tâm: 'California'

Bước 2: Liên kết tín hiệu với danh mục niêm yết

Hãy liên kết nguồn sự kiện với từng danh mục niêm yết. Hãy xem phần Trang danh mục của Trình quản lý kinh doanh. Để chọn pixel và ứng dụng qua API sẽ gửi sự kiện, hãy thực hiện yêu cầu HTTP POST:

curl \
  -F '0=

Hãy chỉ định các thông số sau:

Tên trườngLoại dữ liệuMô tả

external_event_sources (bắt buộc)

int[]

Danh sách pixel và ID ứng dụng để liên kết với danh mục.

Bước 3: Tạo và chia sẻ nhóm nguồn sự kiện bất động sản

Để tạo đối tượng, quản trị viên doanh nghiệp của bạn phải tạo một nhóm nguồn sự kiện. Nhóm này bao gồm tất cả các nguồn gửi tín hiệu quan tâm đến bài niêm yết. Thực hiện yêu cầu HTTP POST:

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

Sau đó, chia sẻ nhóm nguồn sự kiện này với bất kỳ tài khoản quảng cáo nào sẽ chạy quảng cáo cho đối tượng được tạo bởi những nguồn sự kiện này. Thực hiện yêu cầu HTTP POST:

curl \
  -F 'accounts=['

Bước 4: Tạo đối tượng

Tại thời điểm này, bạn có các tín hiệu từ pixel hoặc sự kiện trong ứng dụng được thiết lập và liên kết với nhóm nguồn sự kiện cũng như danh mục bất động sản của bạn. Để nhắm mục tiêu những người quan tâm đến bài niêm yết của bạn, hãy tạo đối tượng động gồm những người đó. Hãy bao gồm hoặc loại trừ mọi người khỏi đối tượng này dựa trên tín hiệu ý định. Bạn cũng có thể áp dụng thêm các bộ lọc dựa trên quy tắc để tùy chỉnh đối tượng như bạn làm với Đối tượng tùy chỉnh từ trang web. Hãy xem phần Đối tượng tùy chỉnh.

Để thiết lập đối tượng mới, hãy thực hiện yêu cầu HTTP POST đến /act_<AD_ACCOUNT_ID>/customaudiences.

Các thông số bắt buộc

Tên trườngLoại dữ liệuMô tả

name

string

Tên đối tượng.

subtype

enum {CLAIM}

Loại đối tượng tùy chỉnh. Phải được đặt thành CLAIM.

claim_objective

enum {HOME_LISTING}

Mục tiêu của đối tượng. Phải được đặt thành HOME_LISTING.

event_source_group

id

Nhóm nguồn sự kiện để tạo đối tượng.

inclusions

object[]

Mảng đối tượng JSON. Liệt kê từng tín hiệu ý định khiến một người đủ điều kiện để thuộc đối tượng này.

sự kiện bao gồm: event (bắt buộc)

enum { Search, ViewContent, InitiateCheckout, Purchase }

Tên sự kiện của một tín hiệu. Dùng cho sự kiện bao gồm trong đối tượng: {'event': 'Search', …}.

sự kiện bao gồm: retention (bắt buộc)

object

Khoảng thời gian tối thiểu và tối đa kể từ khi nhận được sự kiện. Xác định xem sự kiện có được cân nhắc là sự kiện bao gồm hay không. Ví dụ: {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}. Khoảng thời gian giữ lại tối thiểu phải là 4 giờ.

sự kiện bao gồm: count

các toán tửJSON

Số lần kích hoạt sự kiện. Bạn có thể sử dụng cả đẳng thức và các toán tử so sánh dạng số, chẳng hạn như {…"count": {"lte": 3}, …}.

Thông số không bắt buộc

Tên trườngLoại dữ liệuMô tả

content_type

enum {HOME_LISTING}

Loại tín hiệu được dùng để tạo đối tượng này.

description

string

Mô tả đối tượng.

exclusions

object[]

Mảng đối tượng JSON liệt kê từng tín hiệu ý định để loại trừ một người nào đó khỏi đối tượng này.

sự kiện loại trừ: event (bắt buộc)

enum { Search, ViewContent, InitiateCheckout, Purchase }

Tên sự kiện của một tín hiệu được dùng để loại trừ: {'event': 'Search', …}.

sự kiện loại trừ: retention (bắt buộc)

object

Khoảng thời gian tối thiểu và tối đa kể từ khi nhận được sự kiện. Xác định xem sự kiện có được xem xét để loại trừ hay không, ví dụ: {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}. Khoảng thời gian giữ lại tối thiểu phải là 4 giờ.

rule

object

Quy tắc đối tượng từ Đối tượng tùy chỉnh trên trang web. Hãy lọc luồng sự kiện theo những quy tắc này trước khi xử lý bất kỳ inclusions và exclusions nào.

Hãy xem danh sách các trường cụ thể hiện có. Bạn có thể sử dụng những trường này với bất kỳ JSONToán tử cho quy tắc đối tượng tiêu chuẩn nào.

quy tắc: home_listing_set_id (bắt buộc)

object

ID nhóm bài niêm yết: {'eq': '1234'}}

Chẳng hạn, để tạo một đối tượng nhắm mục tiêu đến những người đã xem hoặc đã mua trong 14 ngày qua:

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=