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
- Go to business.nextdoor.com and click Create Account.
- Enter your business details and verify your email address.
- Complete the onboarding wizard to set up your business profile.
Create a Nextdoor Pixel
- In Nextdoor Ads Manager, navigate to Events in the left sidebar.
- Click Create Pixel (or Add New Pixel if you already have existing pixels).
- Name your Pixel (e.g. “My Website Pixel”) and click Create.
- 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
- In Nextdoor Ads Manager, go to Account Settings > API Access.
- Click Generate Token.
- Copy the access token immediately — it may only be shown once.
- 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
| Field | Required | Description |
|---|---|---|
advertiser_id | Yes | Your Nextdoor advertiser ID. Found in Nextdoor Ads Manager under Account Settings. |
pixel_id | Yes | Your Nextdoor tracking pixel ID. Found in Nextdoor Ads Manager under Events. |
access_token | Yes | API access token for server-side event delivery. Generated in Nextdoor Ads Manager under API Access. |
Management UI Setup
- Go to Integrations > Add Integration > Nextdoor.
- Enter your
advertiser_id,pixel_id, andaccess_token. - Select consent categories (typically
advertising). - 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 Event | Nextdoor Event | Notes |
|---|---|---|
page (page view) | PageView | Sent for every page view |
Order Completed | Purchase | Requires value, currency |
Product Added | AddToCart | Includes product details |
Checkout Started | InitiateCheckout | Includes value, currency |
Product Viewed | ViewContent | Includes content identifiers |
Lead Generated | Lead | Lead form submission |
Signed Up | CompleteRegistration | User registration |
| Custom events | Passed through | Sent as custom event name |
Testing Your Integration
Step 1: Send a Test Event
- Trigger a page view or conversion event on your website.
- Check the Signal event debugger in the Management UI to confirm the event was captured and delivered.
Step 2: Verify in Nextdoor Ads Manager
- In Nextdoor Ads Manager, go to Events > your Pixel.
- You should see events arriving within a few minutes.
- Click on individual events to inspect the payload.
Step 3: Validate Attribution
- Create a test campaign targeting a small audience.
- Confirm that conversion events are attributed correctly in the campaign reports.
Troubleshooting
| Problem | Solution |
|---|---|
| Events not appearing in Nextdoor | Verify the advertiser_id, pixel_id, and access_token are correct. Check that the token has not been revoked. |
| Authentication errors | Regenerate the access token in Nextdoor Ads Manager and update the integration config in Signal. |
| Events delayed | Nextdoor may take up to 15 minutes to display server-side events. Allow time before investigating further. |
| Incorrect attribution | Ensure 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.