API Reference

New Advertisers

Purpose: Guide advertisers setting up a Nextdoor pixel for the first time.

Pixel Implementation For Net-New Advertisers

Who is this guide for?

This applies to advertisers who are net-new to Nextdoor as of May 2025; creating and implementing a pixel for the first time.

How to create and implement the universal pixel

An advertiser can implement the universal pixel & new event types standards, by installing the new base code snippet on their website(s) - either by directly / manually installing it OR installing it in a tag management system (e.g. Google Tag Manager, Tealium). This documentation provides custom guidance for both implementation method paths:

  1. Direct / Manual
  2. Tag Management System

For questions, advertisers should contact their Account Manager (AM).

Nextdoor AMs should collaborate with Solutions Engineers (SolEngs) to resolve any migration issues.

Direct / manual implementation

Custom coded ; without a tag manager

  1. Create your pixel code in the Nextdoor Ads Manager (NAM)
    1. Log in to your Nextdoor Ads Manager (NAM); go to Assets > Pixels
    2. Click “Create Pixel”
  2. Grab the pixel code snippet
    1. Click on the three (3) dots to the right of the pixel ID, and click on “Install code”
    2. In “Step 1: Set up base code”, copy the code snippet and paste it somewhere safe like a text editor (we’ll install it on your website in a few steps) . Click “Next” to go to Step 2, where you’ll set up your conversion events and their respective tracking/firing logic.
    3. In “Step 2: Set up conversion-event”, make sure to configure ALL of YOUR desired conversion events and their associated URL tracking logic.
    4. Click on “Submit”’; you should see a “Summary of Conversion Event Configuration”. Make sure the logic in the table looks correct for each conversion event.
  3. Installing your pixel code
    1. Install the Nextdoor base pixel code you just copied from a prior step, within your website's HTML. This is typically in the section of your site's pages.
    2. Note: You'll need to ensure it's placed on all pages you want to track; especially those where the conversion events happen.
  4. Save your changes to each page where you updated the pixel code.
  5. Test your changes.
    1. Navigate to your website and perform actions that should trigger your Nextdoor pixel events.
    2. Use your browser's developer tools (usually accessed by pressing F12) to inspect network requests and ensure your base pixel is firing and your conversion events are firing with the new event names.
  6. Confirm proper pixel setup and data flows with your Nextdoor team.

Tag Management System Implementation

The Nextdoor universal pixel is compatible with popular tag managers like:

Tag management systems provide significant advantages by streamlining development, speeding up implementation, centralizing tracking, and simplifying pixel troubleshooting. They also improve tracking accuracy through precise control over pixel firing using triggers and variables. However, effective use requires proficiency in the tag management system.

Google Tag Manager (GTM) Implementation

  1. Obtain your Nextdoor Pixel Code:
    1. Log in to your Nextdoor Ads Manager account.
    2. Navigate to the "Pixel" section (under “Assets”).
    3. Create your unique Nextdoor Universal Pixel code by clicking on “Create Pixel”. This will be a code snippet that needs to be installed on your website. Copy this code and keep it hand
  2. Add the Nextdoor Pixel Template to Google Tag Manager:
    1. Go to your Google Tag Manager workspace.
    2. Click on "Templates" in the left-hand menu.
    3. In the "Tag Templates" section, click "Search Gallery."
    4. Search for "Nextdoor Pixel" and add the template to your workspace.
  3. Create a New Tag in GTM:
    1. Click on "Tags" in the left-hand menu.
    2. Click "New" to create a new tag.
    3. Give your tag a descriptive name, like "Nextdoor Universal Pixel - All Pages".
  4. Configure the Tag:
    1. Click on "Tag Configuration."
    2. Choose the "Nextdoor Pixel" template you added earlier.
    3. Paste your Nextdoor Pixel code (obtained in step 1) into the appropriate field in the template.
  5. Set a Trigger:
    1. Click on "Triggering."
    2. Choose a trigger that determines when the pixel should fire. For most new installations, you'll want the pixel to fire on all pages. Select the "All Pages" trigger.
  6. Save the Tag:
    1. Click "Save" to save your tag configuration.
  7. Preview your Changes:
    1. Click the "Preview" button in the top right corner of your GTM workspace.
    2. Navigate to your website.
    3. Check the GTM Preview pane at the bottom of your screen to ensure the "Nextdoor Universal Pixel - All Pages" tag is firing correctly.
  8. Publish your Changes:
    1. Once you've confirmed everything is working, click the "Submit" button in the top right corner of your GTM workspace.
    2. Add a descriptive name to your version (e.g., "Added Nextdoor Universal Pixel") and click "Publish."