Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Nextdoor Conversions API Destination


(new)

Beta

This feature is in active development and may change before general availability.

Destination Info
  • Accepts Page, Alias, Group, Identify and Track calls.
  • Refer to it as Nextdoor Conversions API in the Integrations object
  • This integration is partner owned. Please reach out to the partner's support for any issues.
  • This destination is in Beta

Nextdoor Conversion API(link takes you to an external page) allows advertisers to track and send conversion events directly to the platform. This API provides a programmatic way to record and attribute conversions, enabling advertisers to measure the effectiveness of their advertising campaigns.

This destination is maintained by Nextdoor. For any issues with the destination, contact their Support team.


Getting started

getting-started page anchor
  1. From your workspace's Destination catalog page(link takes you to an external page) search for "Nextdoor".
  2. Select Nextdoor Conversions API and click Add Destination.
  3. Select an existing Source to connect to Nextdoor Conversions API.
  4. Go to the Nextdoor Ads Manager(link takes you to an external page), then find and copy the API key, Nextdoor Advertiser ID and Nextdoor Pixel Id values. If these values are not visible in the Ads Manager, you may need to contact your Nextdoor Account Manager to ensure that your Nextdoor account has been whitelisted for the (Ads API) functionality.
  5. Enter the API key, Nextdoor Advertiser ID and Nextdoor Pixel Id values in the Nextdoor Conversions API destination settings in Segment.
  6. In the Mappings tab, configure the Actions to send data to Nextdoor Conversions API.
  7. Enable the Destination and Actions.
  8. See Nextdoor's documentation(link takes you to an external page) for additional instructions.

Property nameTypeRequiredDescription
API Keypassword
required

The Embed API Key for your account. You can find this on your settings pages.


Nextdoor Advertiser IDstring
required

Your Nextdoor Advertiser ID for self serve clients can be found in your NAM account for managed your support team can provide


Nextdoor Pixel Idstring
required

Nextdoor Pixel Id. Used for deduplication when events are sent via CAPI and front end Pixel.


Build your own Mappings. Combine supported triggers with the following Nextdoor Conversions API-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Send Conversion

send-conversion page anchor

Send Conversion Event to Nextdoor

Send Conversion is a Cloud action.

Property nameTypeRequiredDescription
Event NameSTRING
required

The name of the event to track


Event IDSTRING

Optional

A unique ID for the event. This is used to deduplicate events sent by the browser and server.


Event TimeSTRING
required

UCT Timestamp with ISO 8601 format. For example, 2022-11-23T03:30:52Z


Action SourceSTRING
required

Indicates the channel through which conversion happened.


Action Source urlSTRING

Optional

The browser URL where the event happened (required for web events).


Delivery OptimizationBOOLEAN
required

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


Test EventBOOLEAN
required

Flag to indicate if this is a test event.


Customer DataOBJECT
required

Customer profile data used to match with Nextdoor users. At least one of the fields is required.


Custom DataOBJECT

Optional

Custom objects contains fields specific to advertisers that are not already covered in standard fields.


Product ContextOBJECT

Optional

Product details associated with the event.


Mobile App Event ParametersOBJECT

Optional

Data about the source Mobile app. Required for app events

Enriches Segment payloads the Nextdoor Click ID

Nextdoor Browser Plugin is a Web action. The default Trigger is type = "track" or type = "identify" or type = "page" or type = "group" or type = "alias"

This action does not have any fields.


Nextdoor Browser Plugin Action

nextdoor-browser-plugin-action page anchor

When the Nextdoor Conversions API destination receives website data from a Segment JavaScript source, the Nextdoor Browser Plugin automatically grabs the Nextdoor click ID / ndclid from the querystirng in the page URL, and passes it to the Send Conversion Action. Supplying the ndclid boosts attribution accuracy and is strongly recommended for website tracking. The plugin is enabled by default as soon as the destination is created.


You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo(link takes you to an external page).

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to false.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

(information)

Real-time to batch destination sync frequency

Real-time audience syncs to Nextdoor Conversions API may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Property nameTypeRequiredDescription
API Keypassword
required

The Embed API Key for your account. You can find this on your settings pages.


Nextdoor Advertiser IDstring
required

Your Nextdoor Advertiser ID for self serve clients can be found in your NAM account for managed your support team can provide


Nextdoor Pixel Idstring
required

Nextdoor Pixel Id. Used for deduplication when events are sent via CAPI and front end Pixel.