IntegrationsAdvertisingNextdoor (deprecated)

Nextdoor Ads

⚠️

Deprecated. It duplicates the Nextdoor Conversions API integration (#1385). Use the Nextdoor Conversions API integration for new integrations. This integration is hidden from new installs; an integration already installed on it keeps its revision and keeps delivering. Nothing is removed.

Datafly Signal sends conversions to the Nextdoor Conversions API server-to-server.

⚠️

This entry and Nextdoor CAPI send the same requests to the same API. Install one, not both.

Why route Nextdoor Ads through Datafly Signal

  • Conversions survive ad blockers and tracking prevention. A browser tag served from an advertising domain is blocked outright for part of your traffic, and Safari’s ITP shortens the cookies it can set. Signal sends the conversion from your own server, so the conversions Nextdoor optimises against are not filtered by the browser.
  • Click identifiers are captured and replayed. Signal captures the click ID first-party when the visitor lands and attaches it to later conversions.
  • One consent decision governs every destination. Nextdoor is gated by the same consent state as the rest of your stack, so a withdrawal applies everywhere at once.
  • No vendor tag on the page. Removing it removes its page weight and its independent access to your visitors.

Prerequisites

Generate an access token

In Nextdoor Ads Manager generate a Conversions API access token. It expires after about a year.

Find your pixel ID

The pixel ID (also called the data source ID) identifies your events and deduplicates them against the Nextdoor pixel.

Configure in Signal

Configuration Fields

FieldRequiredDescription
advertiser_idNoNot sent: Nextdoor deprecated client_id (the NAM advertiser ID) on the Conversions API. Retained for reference.
pixel_idYesYour Nextdoor pixel ID, sent as data_source_id on every event; Nextdoor rejects an event without it and uses it to deduplicate against the pixel.
access_tokenYesConversions API access token generated in Nextdoor Ads Manager, sent as a Bearer token. Tokens expire after about a year.

Management UI Setup

  1. Go to Integrations > Add Integration > Nextdoor Ads.
  2. Choose a preset: Default (default), Retail (ecommerce), Lead Generation / Local Services (leadgen), Insurance (insurance).
  3. Fill in the fields above and click Save.

Request format

POST https://ads.nextdoor.com/v2/api/conversions/track
Authorization: Bearer <access token>

{"event_name": "purchase", "event_id": "evt-1", "event_time_epoch": 1758500000,
 "action_source": "website", "action_source_url": "https://shop.example.com/checkout/done",
 "data_source_id": "<pixel ID>", "partner_id": "datafly",
 "customer": {"email": "<SHA-256>", "phone_number": "<SHA-256>", "first_name": "<SHA-256>",
              "last_name": "<SHA-256>", "external_id": "crm-user-9", "click_id": "<ndclid>",
              "client_ip_address": "203.0.113.9", "client_user_agent": "Mozilla/5.0 ..."},
 "custom": {"order_value": "GBP259.99", "order_id": "ORD-1001",
            "product_context": [{"id": "SKU_1", "quantity": 2, "item_price": 120}]}}

event_name, event_id, event_time_epoch, action_source, data_source_id and customer are required; website events also need action_source_url and customer.client_user_agent, and purchases custom.order_value (ISO currency followed by the amount).

Event Mapping

Signal eventVendor eventPresets
pagepage_viewDefault, Retail, Lead Generation / Local Services, Insurance
view_itemview_contentDefault, Retail
add_to_cartadd_to_cartDefault, Retail
begin_checkoutinitiate_checkoutDefault, Retail
purchasepurchaseDefault, Retail, Insurance
generate_leadleadDefault, Lead Generation / Local Services, Insurance
sign_upsign_upDefault, Lead Generation / Local Services
searchsearchRetail
add_to_wishlistadd_to_wishlistRetail
subscription_startedsubscribeLead Generation / Local Services
get_quoteinitiate_checkoutInsurance
quote_completedleadInsurance

Event names are Nextdoor’s supported conversion events.

Identity

Email, phone, first name and last name are sent only as SHA-256 hashes (trimmed and lowercased; the phone as ten digits without the country code, as Nextdoor documents). IP address and user agent are sent unhashed, as Nextdoor requires. external_id is your user_id. The Nextdoor click ID (ndclid) is sent when captured.

Nextdoor is an advertising destination and requires marketing consent by default.

Troubleshooting

ProblemSolution
401 UnauthorizedThe access token has expired (about a year); generate a new one.
400 Bad RequestCheck the pixel ID setting; data_source_id is required on every event.

Blueprint

The Nextdoor Ads blueprint version is 0.10.0. It was last reviewed against the vendor’s documentation on 2026-09-22.

See also