v1

latestOpenAPI 3.1.02026-07-24590188.7 KB

conversions/track

post/v2/api/conversions/track

Request body

event_namestring required

Conversion event name. Supported values above.

event_idstring required

Any string or hashed ID that can identify a unique event. This is required to deduplicate events from CAPI and pixel tracking. It should be any deterministic ID that can be used for conversion api and pixel tracking.

event_timestring

Timestamp that the event took place. Timestamp with ISO 8601 format. For example, 2022-11-23T03:30:52Z. Time here is in UTC. Require one of the event_time or event_time_epoch.

event_timezonestring

Optional timezone indicating where the conversion event took place.

action_sourcestring required

Indicates the channel through which conversion happened. Supported values above.

client_idstring

NAM Advertiser ID (aka ad account id) *ask Nextdoor account team if you don't have it.

action_source_urlstring

The action_source_url is required for website events. The browser URL where the event happened. The URL must begin with http:// or https:// and should match the verified domain.

delivery_optimizationboolean

True indicates data can be used for optimization. False indicates the data will only be used for attribution

test_eventstring

Flag to indicate if this is a test event. If its not present we’ll default to False.

partner_idstring

Free text field to enter the name of integration vendor (tealium, gtm, or zapier) or agency partner. Used for reference, tracking and troubleshooting; not intended for attribution purposes.

event_time_epochinteger required

For backward compatibility, require one of the event_time or event_time_epoch. Number of seconds since 1970-01-01. No millis.

data_source_idstring required

Also known as the pixel_ID; used to dedupe events from CAPI and pixel. It's softly required for multiple pixel implementations.

restricted_data_usageinteger

Default is null. If an advertiser explicitly passes true or 1, Nextdoor will only use the event for reporting purposes.

restricted_data_usage_countryinteger

Associates a country with this data processing option. Default is null. The currently accepted value is 1 for the United States of America.

restricted_data_usage_stateinteger

Associates a state with this data processing option. Default is null. See above for accepted values.

Response

200