DNI Script 101: How to install and configure it
Setting up Dynamic Number Insertion (DNI) involves a specific sequence of steps to ensure your tracking numbers are correctly acquired, named, and routed to your business.
The 5-step setup process
Before your script can go live, you must complete the account configuration workflow.
Step 1. Acquire your Tracking Number
How to do it: Navigate to Tracking > Numbers in your Nimbata dashboard.
- Select Channel: Choose the source you want to track (e.g., Google Ads, Organic, or Social Media).
- Pick Number Type: Select Local for a community feel or Toll-Free for a national presence.
- Search and Match: Use the search bar to find numbers by area code. Pro Tip: Select a number that matches your real business area code to maintain brand consistency.
- Detailed Guide: How to add your first Tracking Number
Step 2. Assign a friendly name
How to do it: While acquiring the number or by visiting Tracking > Numbers and clicking the "edit" (pencil) icon next to your number.
- Identification: Enter a descriptive name like "Google Business Profile" or "Winter Promo".
- Internal Labeling: This name is strictly for your internal reporting and helps you distinguish between numbers in your dashboard.
Step 3. Define your routing (Destination Number)
How to do it: Go to Tracking > Destinations.
- Add Destination: Click + Add, select your country, and enter the actual phone number where you want to receive calls.
- Detailed Guide: How to add a Destination Number
Step 4. Configure the Call Flow
How to do it: Navigate to Tracking > Call Flows.
- Template Setup: Use the Simple Call Flow template for a quick start. Simply select your destination number and hit save.
- Assigning: Once created, return to Tracking > Numbers and assign your new call flow to your tracking numbers so calls connect correctly.
- Detailed Guide: How to set up Call Flows
Step 5. Test your connection
How to do it: You can verify the link between your tracking number and destination in two ways.
- Manual Dial: Dial the tracking number from your mobile phone. Ensure it rings at your business destination.
- Dashboard Check: Check Activity > Calls to see if your test call appears in the real-time logs.
Publishing the DNI Script
Once your account shows all "green" for the five steps above, you are ready to go live.
Step 1. Visit to the script page
Head over to Tracking > Tracking Code inside Nimbata.
Step 2. Configure your script
Toggle options like Single Page Application (SPA) support if you have a modern web app, or adjust cookie duration to control how long a number stays tied to a visitor session.
Step 2.5. Set your Swap Targets
This is the most critical technical step. You must tell Nimbata which number on your site to replace.
- Auto-Detection: Nimbata can scan your page for phone numbers.
- Span Tags: For 100% accuracy, wrap your website number in a span tag:
<span class="nimbata">123-456-7890</span>.
Step 3. Publish your Script
Click the Save & Publish button. Then:
- Google Tag Manager: Best for marketers (Paste the script into a Custom HTML tag).
- WordPress: Use the Nimbata Plugin for a no-code installation.
- Manual HTML: Paste the code as the last item before the
</body>tag on every page.
Verifying the Installation
- Live Test: Visit your site. If you track all channels, the number should swap immediately.
- Google Ads Test: Visit
www.yoursite.com/?gclid=testto force the swap for paid search numbers. - Troubleshooting: If it fails, check that the tracking number is assigned to a call flow and your swap targets are correctly defined.
- Website URL Check: Use Nimbata's native website URL checker located right below your DNI script inside Tracking > Tracking Code.
Updated on: 13/03/2026
Thank you!