Beginning with the release of Marketing API v15.0, you will no longer be able to create Special Ad Audiences. See Special Ad Audiences for more information.
Create a real estate audience:
These are predefined event names you can send from your website or app that allow you to both measure the performance of your campaigns and to capture intent from your audiences. See Facebook Pixel Setup.
Real Estate ads requires these standard events from your website pixel and mobile app:
Pixel Event | App Event | Requirement Level | Description |
---|---|---|---|
|
| ◉ | Someone searched home listings |
|
| ◉ | Someone viewed of a specific listing |
|
| ◉ | Someone saved, liked or showed special interest in a listing |
|
| ◉ | Someone contacted an agent about a listing |
For example, to report a Search event for a listing using FB pixel or App events, place this code on your search-results page:
<!-- Facebook Pixel Code -->
<script>
!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;
n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,
document,'script','https://connect.facebook.net/en_US/fbevents.js');
// Insert Your Facebook Pixel ID below.
fbq('init', '<FB_PIXEL_ID>');
fbq('track', 'Search', {
content_type: 'home_listing',
content_ids: ['1234', '2345', '3456', '4567'], // Top search results
city: 'New York City', //Required for Search event
region: 'New York', // region is the state for the US. Required for Search event
country: 'US', //Required for Search event
} );
</script>
<!-- End Facebook Pixel Code -->
Once you determine which events should fire, you should provide each event's parameters.
The table below lists required and recommended parameters.
Pixel Parameter | Mobile Parameter | Requirement Level |
---|---|---|
|
| ◉ |
|
| ◯ |
| ◎ | |
| ◎ | |
| ◎ | |
| ◎ | |
| ◎ | |
|
| ◎ |
| ◎ | |
| ◎ | |
| ◎ | |
|
| ◎ |
| ◎ | |
|
| ◎ |
|
| ◎ |
Parameter Name | Data Type | Description |
---|---|---|
|
| Value must be |
|
| Provide the user's city of the interest, e.g. |
|
| Any IDs in your listing catalog. For example, for |
|
| e.g.
|
|
| Target country of the interest, such as |
|
| Specified using ISO 4217 currency format: |
|
| Allows us to recommend properties based off their date availability (using |
|
| Specified using ISO 8601 date format: |
|
| Value must be |
|
| Neighborhood of interest: |
|
| Number of bathrooms chosen as range: |
|
| Number of bedrooms chosen as range: |
|
| Price range: |
|
| Must be |
|
| State, district, or region of interest: |
Associate your event sources with each of your listing catalogs. See Business Manager's Catalog Page To select the pixel and app via API which send events, make a HTTP POST
:
curl \
-F '0=<PIXEL_ID>' \
-F '1=<APP_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/external_event_sources
Specify these parameters:
Field Name | Data Type | Description |
---|---|---|
|
| List of Pixel and App IDs to associate with the catalog. |
To build an audience, an admin for your business must create an event source group. This groups all of your sources that send listing interest signals. Making an HTTP POST
:
curl \
-F 'name=My Real Estate Company Events' \
-F 'event_sources=['<PIXEL_ID>','<APP_ID>']' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/event_source_groups
Then share this event source group to any ad accounts that will run ads to audiences generated by these event sources. Making an HTTP POST
:
curl \
-F 'accounts=['<ACCOUNT_ID_WITHOUT_ACT>']' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<EVENT_SOURCE_GROUP_ID>/shared_accounts
At this point you have signals from pixels or app events set-up and associated with an event source group and your real estate catalog. To target people interested in your listings, create a dynamic audience of people. Include orexclude people from the audience based on the intent signals. You can also apply additional rule-based filters to customize your audience as you do with Website Custom Audiences. See Custom Audiences.
To set-up a new audience, make an HTTP POST
to /act_<AD_ACCOUNT_ID>/customaudiences
.
Field Name | Data Type | Description |
---|---|---|
|
| Audience name. |
|
| Type of custom audience.
Must be set to |
|
| Objective of audience.
Must be set to |
|
| Event source group to build audience. |
|
| Array of JSON objects. Lists each intent signal that makes someone eligible for this audience. |
inclusions: |
| Event name of a signal. Used for inclusion in audience: |
inclusions: |
| Minimum and maximum amount of time since event received. Determine if event considered for inclusion. Example: |
inclusions: |
| Number of times event fired. You can use both equality and numeric comparison operators such as |
Field Name | Data Type | Description |
---|---|---|
|
| Type of signals used to build this audience. |
|
| Description of audience. |
|
| Array of JSON objects listing each intent signal that excludes someone from this audience. |
exclusions: |
| Event name of a signal used for exclusion: |
exclusions: |
| Minimum and maximum amount of time since event received. Determines if event considered for exclusion, for example, |
|
| Audience Rule from Website Custom Audiences. Filter event stream by these rules before any See a list of specific fields available. You can use these with any of standard |
rule: |
| Listing set ID: |
For example, to create an audience that targets people who viewed or purchased in the last 14 days:
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=<EVENT_SOURCE_GROUP_ID>' \
-F 'rule={"home_listing_set_id":{"eq":"<HOME_LISTING_SET_ID>"}}' \
-F 'inclusions=[
{
"event": "ViewContent",
"count": {"gt":0},
"retention": {"min_seconds":0,"max_seconds":1209600}
},
{
"event": "Purchase",
"count": {"gt":0},
"retention": {"min_seconds":0,"max_seconds":1209600}
}
]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/customaudiences