Nextdoor Ads

Datafly Signal delivers conversion events to Nextdoor server-to-server using the Nextdoor Pixel API. This enables local advertising attribution and neighbourhood-level campaign measurement without loading client-side tags.

Prerequisites

Before configuring Nextdoor Ads in Signal, you need a Nextdoor Business account with an active Pixel and an API access token.

Create a Nextdoor Business Account

  1. Go to business.nextdoor.com and click Create Account.
  2. Enter your business details and verify your email address.
  3. Complete the onboarding wizard to set up your business profile.

Create a Nextdoor Pixel

  1. In Nextdoor Ads Manager, navigate to Events in the left sidebar.
  2. Click Create Pixel (or Add New Pixel if you already have existing pixels).
  3. Name your Pixel (e.g. “My Website Pixel”) and click Create.
  4. Note the Pixel ID — you will need this for Signal configuration.

You do not need to install the Nextdoor client-side pixel snippet. Signal replaces this with server-side delivery.

Generate an API Access Token

  1. In Nextdoor Ads Manager, go to Account Settings > API Access.
  2. Click Generate Token.
  3. Copy the access token immediately — it may only be shown once.
  4. Note your Advertiser ID from the Account Settings page.
⚠️

Store the access token securely. If you lose it, you will need to generate a new one.

Configure in Signal

Now that you have your Advertiser ID, Pixel ID, and access token, configure the integration in Signal.

Configuration Fields

FieldRequiredDescription
advertiser_idYesYour Nextdoor advertiser ID. Found in Nextdoor Ads Manager under Account Settings.
pixel_idYesYour Nextdoor tracking pixel ID. Found in Nextdoor Ads Manager under Events.
access_tokenYesAPI access token for server-side event delivery. Generated in Nextdoor Ads Manager under API Access.

Management UI Setup

  1. Go to Integrations > Add Integration > Nextdoor.
  2. Enter your advertiser_id, pixel_id, and access_token.
  3. Select consent categories (typically advertising).
  4. Click Save.

Management API Setup

curl -X POST http://localhost:8084/v1/admin/integrations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "src_abc123",
    "vendor": "nextdoor",
    "name": "Nextdoor Ads Production",
    "enabled": true,
    "config": {
      "advertiser_id": "nd-adv-12345",
      "pixel_id": "nd-px-67890",
      "access_token": "ndat_abc123..."
    },
    "consent_categories": ["advertising"]
  }'

Event Mapping

Datafly EventNextdoor EventNotes
page (page view)PageViewSent for every page view
Order CompletedPurchaseRequires value, currency
Product AddedAddToCartIncludes product details
Checkout StartedInitiateCheckoutIncludes value, currency
Product ViewedViewContentIncludes content identifiers
Lead GeneratedLeadLead form submission
Signed UpCompleteRegistrationUser registration
Custom eventsPassed throughSent as custom event name

Testing Your Integration

Step 1: Send a Test Event

  1. Trigger a page view or conversion event on your website.
  2. Check the Signal event debugger in the Management UI to confirm the event was captured and delivered.

Step 2: Verify in Nextdoor Ads Manager

  1. In Nextdoor Ads Manager, go to Events > your Pixel.
  2. You should see events arriving within a few minutes.
  3. Click on individual events to inspect the payload.

Step 3: Validate Attribution

  1. Create a test campaign targeting a small audience.
  2. Confirm that conversion events are attributed correctly in the campaign reports.

Troubleshooting

ProblemSolution
Events not appearing in NextdoorVerify the advertiser_id, pixel_id, and access_token are correct. Check that the token has not been revoked.
Authentication errorsRegenerate the access token in Nextdoor Ads Manager and update the integration config in Signal.
Events delayedNextdoor may take up to 15 minutes to display server-side events. Allow time before investigating further.
Incorrect attributionEnsure you are sending user identity signals (IP address, user agent) which Signal forwards automatically.

Visit Nextdoor Business documentation for full API documentation and credential setup instructions.