Articles on: Dynamic Number Insertion (DNI)

DNI script 101: how to install and configure it

Setting up Dynamic Number Insertion (DNI) involves configuring your account first, then publishing the script to your website. Complete the steps below in order.


The 5-step setup process


Before your script can go live, you must complete the account configuration workflow.


Step 1. Acquire your tracking number


  • Go to Tracking > Numbers.
  • Click + Add.
  • Choose the source you want to track.
  • Pick a number type (Local or Toll-Free).
  • Select a number from the list.



Tip: Choose a number that matches your real business area code to maintain brand consistency.


Detailed Guide: How to add your first tracking number


Step 2. Name your tracking number


  • Give your number a descriptive name.
  • You can set this during setup or later by clicking the edit (pencil) icon next to any number in Tracking > Numbers.


Step 3. Add a destination number


  • Go to Tracking > Destinations.
  • Click + Add.
  • Enter the phone number where calls should be forwarded.
  • This is where your business receives the call.


Detailed Guide: How to add a destination number


Step 4. Set up a call flow


  • Go to Tracking > Call Flows.
  • Create a new call flow using the Simple Call Flow template.
  • Select your Destination Number and save.
  • Then go back to Tracking > Numbers.
  • Assign the call flow to your tracking number.


Detailed Guide: How to set up call flows


Step 5. Test your setup


  • Dial the tracking number from your mobile phone and confirm it rings at your destination.
  • Then, check Activity > Calls to verify the test call appears in your logs.



Publishing the DNI Script


Once your account is configured (all five steps above are complete), you're ready to go live.


Step 6. Open the script page


Go to Tracking > Tracking Code in Nimbata.


Step 7. Configure your swap targets


This is the most critical step.

You need to tell Nimbata which phone number on your website to replace.

  • Auto-detection: Nimbata can scan your page automatically.
  • Span tag (recommended for accuracy): Wrap your website number in a span tag: <span class="nimbata">123-456-7890</span>



You can also toggle additional options here, such as Single Page Application (SPA) support or adjusting the cookie duration.


Detailed Guide: How to set up span tag


Step 8. Publish the script


Click Save & Publish, then add the script to your site using one of these methods:


Google Tag Manager: Paste the script into a Custom HTML tag.

See How to activate the DNI script via Google Tag Manager


WordPress: Install the Nimbata Plugin.

See How to activate the DNI script via WordPress


Manual HTML: Paste the script just before the </body> tag on every page.

See How to activate the DNI script via HTML




Verifying the Installation


  • Live test: Visit your site; if you're tracking all channels, the number should swap immediately.
  • Google Ads test: Visit www.yoursite.com/?gclid=test to force a swap for paid search numbers.
  • Built-in checker: Use Nimbata's website URL checker, located just below the DNI script in Tracking > Tracking Code.


🎉 Numbers swapping correctly? You're live. Next, consider setting up swap groups if you want to track multiple numbers or channels independently.

Detailed Guide: How to set up swap groups

Troubleshooting: Why are numbers not swapping on my website?



Updated on: 30/03/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!