Property Search
Also known as: property_search, Listing Search, Real Estate Search, Home Search, Inventory Search, Search Submitted, Search Executed, Listings Search
Records each accepted execution of a property inventory search initiated by a user through keyword, location, map, or filter-based discovery controls. It measures property demand criteria, available result volume, zero-result outcomes, and the context in which users search for listings.
Event Serialization
alwaysBusiness Use Case
The Product and Marketplace teams compare zero-result rate and search-to-inquiry conversion by city, property type, price band, and filter depth. If high-demand searches in a city repeatedly return no inventory, executives can prioritize listing acquisition in that market, while Product can revise overly restrictive defaults or improve location matching where inventory exists but search engagement remains weak.
Business Criticality
High
Journey / Navigation Area
Discovery
Owning Function
Product
Calculation Notes
1️⃣ Emit event only on accepted search requests; exclude page opens, edits, autocomplete, and pagination. 2️⃣ Emit separate events for explicit submissions, filter applications, sort changes, saved-search executions, and map movements; use search_trigger for distinction. 3️⃣ Deduplicate retries with event_id; maintain unique search_id for requests and results. 4️⃣ Set results_count to total eligible inventory before pagination; use zero_results_flag for successful zero-result responses only. 5️⃣ Calculate session analysis with a 30-minute inactivity timeout unless otherwise specified. 6️⃣ Exclude bots, monitoring, test traffic, malformed requests, and blocked searches from reporting. 7️⃣ Normalize values against taxonomies; sanitize free-text fields and prohibit sensitive information.
Platform Events
| Platform | Event |
|---|---|
| Google Analytics 4 | search |
| Adobe | search |
Data Mappings
W3 Data Layer
{
"event": [
{
"eventInfo": {
"eventId": "ps_8f7c2a41",
"eventName": "search",
"eventAction": "search",
"eventTimestamp": "2025-03-08T14:30:00.000Z"
},
"attributes": {
"city": "Austin",
"radius": 25,
"region": "TX",
"country": "US",
"filters": "price:300000-900000|bedrooms:2-4|bathrooms:2-4|property_type:house,condo|listing_type:sale|amenities:pool,garage",
"sort_by": "relevance",
"currency": "USD",
"event_id": "ps_8f7c2a41",
"language": "en-US",
"latitude": 30.2672,
"page_url": "https://www.example.com/properties/search",
"platform": "web",
"amenities": "pool|garage",
"longitude": -97.7431,
"page_name": "Property Search Results",
"page_size": 24,
"price_max": 900000,
"price_min": 300000,
"search_id": "srch_52d910ab",
"event_name": "search",
"session_id": "sess_19ac047e",
"sort_order": "descending",
"location_id": "loc_austin_tx",
"page_number": 1,
"postal_code": "78701",
"radius_unit": "mi",
"search_term": "waterfront",
"search_type": "property_inventory",
"user_status": "anonymous",
"bedrooms_max": 4,
"bedrooms_min": 2,
"site_section": "property-search",
"zero_results": false,
"bathrooms_max": 4,
"bathrooms_min": 2,
"filters_count": 6,
"listing_types": "sale",
"page_referrer": "https://www.example.com/",
"results_count": 24,
"search_method": "keyword",
"search_status": "accepted",
"total_results": 128,
"location_query": "Austin, TX",
"property_types": "house|condo",
"event_timestamp": "2025-03-08T14:30:00.000Z",
"map_bounds_east": -97.5684,
"map_bounds_west": -97.9384,
"map_bounds_north": 30.5169,
"map_bounds_south": 30.0987
}
}
]
}GA4 Data Layer
{
"city": "Austin",
"event": "search",
"radius": 25,
"region": "TX",
"country": "US",
"filters": "price:300000-900000|bedrooms:2-4|bathrooms:2-4|property_type:house,condo|listing_type:sale|amenities:pool,garage",
"sort_by": "relevance",
"currency": "USD",
"event_id": "ps_8f7c2a41",
"language": "en-US",
"latitude": 30.2672,
"page_url": "https://www.example.com/properties/search",
"platform": "web",
"amenities": "pool|garage",
"longitude": -97.7431,
"page_name": "Property Search Results",
"page_size": 24,
"price_max": 900000,
"price_min": 300000,
"search_id": "srch_52d910ab",
"session_id": "sess_19ac047e",
"sort_order": "descending",
"location_id": "loc_austin_tx",
"page_number": 1,
"postal_code": "78701",
"radius_unit": "mi",
"search_term": "waterfront",
"search_type": "property_inventory",
"user_status": "anonymous",
"bedrooms_max": 4,
"bedrooms_min": 2,
"site_section": "property-search",
"zero_results": false,
"bathrooms_max": 4,
"bathrooms_min": 2,
"filters_count": 6,
"listing_types": "sale",
"page_referrer": "https://www.example.com/",
"results_count": 24,
"search_method": "keyword",
"search_status": "accepted",
"total_results": 128,
"location_query": "Austin, TX",
"property_types": "house|condo",
"event_timestamp": "2025-03-08T14:30:00.000Z",
"map_bounds_east": -97.5684,
"map_bounds_west": -97.9384,
"map_bounds_north": 30.5169,
"map_bounds_south": 30.0987
}Adobe Client Data Layer
{
"event": "search",
"search": {
"city": "Austin",
"radius": 25,
"region": "TX",
"country": "US",
"filters": "price:300000-900000|bedrooms:2-4|bathrooms:2-4|property_type:house,condo|listing_type:sale|amenities:pool,garage",
"sort_by": "relevance",
"currency": "USD",
"event_id": "ps_8f7c2a41",
"language": "en-US",
"latitude": 30.2672,
"page_url": "https://www.example.com/properties/search",
"platform": "web",
"amenities": "pool|garage",
"longitude": -97.7431,
"page_name": "Property Search Results",
"page_size": 24,
"price_max": 900000,
"price_min": 300000,
"search_id": "srch_52d910ab",
"event_name": "search",
"session_id": "sess_19ac047e",
"sort_order": "descending",
"location_id": "loc_austin_tx",
"page_number": 1,
"postal_code": "78701",
"radius_unit": "mi",
"search_term": "waterfront",
"search_type": "property_inventory",
"user_status": "anonymous",
"bedrooms_max": 4,
"bedrooms_min": 2,
"site_section": "property-search",
"zero_results": false,
"bathrooms_max": 4,
"bathrooms_min": 2,
"filters_count": 6,
"listing_types": "sale",
"page_referrer": "https://www.example.com/",
"results_count": 24,
"search_method": "keyword",
"search_status": "accepted",
"total_results": 128,
"location_query": "Austin, TX",
"property_types": "house|condo",
"event_timestamp": "2025-03-08T14:30:00.000Z",
"map_bounds_east": -97.5684,
"map_bounds_west": -97.9384,
"map_bounds_north": 30.5169,
"map_bounds_south": 30.0987
},
"eventInfo": {
"eventId": "ps_8f7c2a41",
"eventName": "search",
"eventTimestamp": "2025-03-08T14:30:00.000Z"
}
}XDM Mapping
{
"web": {
"webReferrer": {
"URL": "https://www.example.com/"
},
"webInteraction": {
"name": "search",
"type": "other"
},
"webPageDetails": {
"URL": "https://www.example.com/properties/search",
"name": "Property Search Results",
"siteSection": "property-search"
}
},
"commerce": {
"searches": {
"value": 1
}
},
"eventType": "commerce.searches",
"timestamp": "2025-03-08T14:30:00.000Z",
"_experience": {
"analytics": {
"search": {
"city": "Austin",
"radius": 25,
"region": "TX",
"country": "US",
"filters": "price:300000-900000|bedrooms:2-4|bathrooms:2-4|property_type:house,condo|listing_type:sale|amenities:pool,garage",
"sort_by": "relevance",
"currency": "USD",
"event_id": "ps_8f7c2a41",
"language": "en-US",
"latitude": 30.2672,
"page_url": "https://www.example.com/properties/search",
"platform": "web",
"amenities": "pool|garage",
"longitude": -97.7431,
"page_name": "Property Search Results",
"page_size": 24,
"price_max": 900000,
"price_min": 300000,
"search_id": "srch_52d910ab",
"event_name": "search",
"session_id": "sess_19ac047e",
"sort_order": "descending",
"location_id": "loc_austin_tx",
"page_number": 1,
"postal_code": "78701",
"radius_unit": "mi",
"search_term": "waterfront",
"search_type": "property_inventory",
"user_status": "anonymous",
"bedrooms_max": 4,
"bedrooms_min": 2,
"site_section": "property-search",
"zero_results": false,
"bathrooms_max": 4,
"bathrooms_min": 2,
"filters_count": 6,
"listing_types": "sale",
"page_referrer": "https://www.example.com/",
"results_count": 24,
"search_method": "keyword",
"search_status": "accepted",
"total_results": 128,
"location_query": "Austin, TX",
"property_types": "house|condo",
"event_timestamp": "2025-03-08T14:30:00.000Z",
"map_bounds_east": -97.5684,
"map_bounds_west": -97.9384,
"map_bounds_north": 30.5169,
"map_bounds_south": 30.0987
}
}
},
"eventMergeId": "ps_8f7c2a41",
"placeContext": {
"geo": {
"city": "Austin",
"latitude": 30.2672,
"longitude": -97.7431,
"postalCode": "78701",
"countryCode": "US",
"stateProvince": "TX"
}
}
}Parameters
{
"city": "string - normalized city or municipality searched",
"region": "string - normalized state, province, county, or equivalent first-level administrative area searched",
"currency": "string - ISO 4217 currency code associated with submitted price filters",
"event_id": "string - globally unique identifier used to detect duplicate event delivery",
"keywords": "array[string] - normalized non-location search terms or feature phrases applied to the inventory query",
"max_area": "number - inclusive maximum floor area requested in the stated area unit",
"min_area": "number - inclusive minimum floor area requested in the stated area unit",
"platform": "string - channel on which the search occurred, such as web, iOS, Android, or partner portal",
"amenities": "array[string] - normalized amenity filters, such as parking, pool, elevator, balcony, or pet_friendly",
"area_unit": "string - unit used for area filters, such as square_meter or square_foot",
"max_price": "number - inclusive maximum property price or rent requested; null when unrestricted",
"min_price": "number - inclusive minimum property price or rent requested; null when unrestricted",
"radius_km": "number - search radius in kilometers when a radius-based geographic constraint is used",
"search_id": "string - unique identifier linking the search execution to returned results and downstream listing interactions",
"error_code": "string - stable application or service error code when search_status is not success; null for successful searches",
"map_bounds": "string - ordered southwest and northeast coordinates defining the visible map search boundary",
"session_id": "string - identifier for the active digital session",
"sort_order": "string - result ordering applied, such as relevance, newest, price_ascending, price_descending, or distance",
"app_version": "string - application or website release version generating the event",
"search_mode": "string - search interaction mode, such as list, map, natural_language, address, or nearby",
"country_code": "string - ISO 3166-1 alpha-2 code for the searched country",
"filter_count": "integer - count of active user-selectable filters excluding default market, inventory, and access controls",
"max_bedrooms": "integer - maximum number of bedrooms requested; null when unrestricted",
"min_bedrooms": "integer - minimum number of bedrooms requested; null when unrestricted",
"neighborhood": "string - normalized neighborhood, district, or local market area searched",
"search_query": "string - normalized and sanitized search text with email addresses, phone numbers, and other direct identifiers removed",
"location_type": "string - geographic level represented by the location query, such as country, region, city, postal_area, neighborhood, address, or map_area",
"min_bathrooms": "number - minimum number of bathrooms requested; null when unrestricted",
"property_type": "string - normalized primary property category, such as residential, commercial, land, or industrial",
"results_count": "integer - total number of eligible listings reported by the search service before pagination",
"search_status": "string - processing outcome of the search request, such as success, validation_error, timeout, or service_error",
"listing_status": "string - requested listing lifecycle status, such as active, coming_soon, under_offer, sold, or rented",
"location_query": "string - normalized place, address, development, landmark, or administrative area supplied as the search location",
"map_zoom_level": "number - map zoom level at the time the search was executed",
"search_trigger": "string - user or system action that executed the search, such as submit, filter_apply, map_move, sort_change, or saved_search_open",
"event_timestamp": "string - UTC timestamp in ISO 8601 format when the search request was accepted",
"filters_applied": "array[string] - canonical names of active search filters without duplicating their submitted values",
"open_house_only": "boolean - indicates whether the search was restricted to listings with a scheduled open house",
"property_subtype": "string - normalized detailed property category, such as apartment, detached_house, townhouse, office, or warehouse",
"response_time_ms": "integer - elapsed milliseconds from search request submission to receipt of the search response",
"transaction_type": "string - intended real estate transaction, such as sale, rent, lease, auction, or new_development",
"anonymous_user_id": "string - pseudonymous, non-PII visitor identifier used for cross-session analysis where consent permits",
"listed_since_days": "integer - maximum listing age in whole days requested by the user; null when unrestricted",
"zero_results_flag": "boolean - true when a successful search returns a results_count of zero",
"postal_code_prefix": "string - approved partial postal code used for area analysis without retaining a precise household address",
"search_entry_point": "string - product surface where the search began, such as home page, search page, map, saved search, or agent profile",
"map_center_latitude": "number - latitude of the searched map center rather than the user's physical location",
"map_center_longitude": "number - longitude of the searched map center rather than the user's physical location",
"experiment_assignments": "array[string] - active search-related experiment and variant identifiers applicable when the event occurred"
}Source Data
Digital Analytics and Property Search API
Dependencies
[ "digital_session", "anonymous_visitor", "property_taxonomy", "location_taxonomy", "listing_inventory_response", "search_result_click", "listing_view", "property_inquiry" ]
Report Attributes
Event Date Platform Search Entry Point Search Trigger Search Status Search Mode Transaction Type Property Type Property Subtype Country Region City Neighborhood Location Type Price Band Bedroom Demand Band Area Band Filter Depth Result Volume Band Zero-Result Flag Sort Order Response Time Band Experiment Variant
Segment Eligibility
true
Governance
Dimensions
Related Dimensions
Derived Entities
Derived Metrics
Governance & Metadata
GitHub
catalog/events/property-search.yml