NinaData Monetizer -- Installation

Canonical URL: https://docs.ninadata.ai/install/

What NinaData sends you

Before installing, you receive from NinaData:

Your publisherId and siteId.
The list of domains authorized for that pair.
The agreed test URL for first verification.
The rollback contact.

Ads only render on the exact domains NinaData has authorized for your (publisherId, siteId) pair. On any other domain the runtime is silent -- no ads, no telemetry.

Where to paste the snippet

Paste both <script> blocks below into the page <head>, in the order shown. If you use a tag manager, the two blocks must be injected into <head> in that same order (the config block first, then the runtime script).

The snippet

<script>
  window.NINA_MONETIZER_CONFIG = {
    mode:         "monetizer",
    publisherId:  "CUSTOMER_PUBLISHER_ID",
    siteId:       "CUSTOMER_SITE_ID",
    diagnostics:  false,
    quietConsole: true,
    telemetry: {
      enabled:         true,
      endpoint:        "https://collector.ninadata.ai/api/monetizer-event",
      sampleRate:      1,
      maxBatchEvents:  10,
      flushIntervalMs: 500
    },
    consent: {
      enabled:   true,
      mode:      "observe",
      timeoutMs: 1000
    }
  };
</script>
<script async src="https://cdn.ninadata.ai/monetization.js"></script>

Replace CUSTOMER_PUBLISHER_ID and CUSTOMER_SITE_ID with the exact strings NinaData provided.

What NOT to change

Do not change the runtime URL.
Do not change the collector endpoint.
Do not add extra fields to NINA_MONETIZER_CONFIG.
Do not add bidder or ad-server configuration to the snippet.
Do not paste the snippet on any domain that is not on your authorized list.

If NinaData asks you to change any of these values, they will confirm it in writing.

How to verify

Install on the agreed test URL first. Then, in a fresh private / incognito browser window, open DevTools and confirm:

The runtime script returned 200 OK.
The collector endpoint received at least one POST and returned 204 No Content.
No NinaData-related errors appear in the console.

Visible ads may appear when the page is eligible and demand returns a bid. Absence of an ad on a given page load is not automatically a failure.

Send NinaData

The exact test URL (scheme + host + path).
The timestamp of your verification (date + time + timezone).
The browser and device used (for example Chrome 121 / Windows 11 desktop).

NinaData confirms healthy install on their side before you extend the install beyond the test URL. See the rollout checklist.

Rollback

Remove the <script> block that sets window.NINA_MONETIZER_CONFIG.
Remove the <script async> block that loads https://cdn.ninadata.ai/monetization.js.
If either block was injected through a tag manager, clear the tag manager or template cache.
Tell NinaData when the rollback took effect.

After the next page load, no NinaData runtime code runs, no telemetry is sent, and no placements are created.