4 API-integration 3180d0bf65fa99d80a503269aa30eff9590de9fa API Integration Orbis<>Nitro f t \N # API Interation Orbis<>Nitro\n\nAPIs to pass events from Nitro to Orbis.\n**Orbis Production Host:** https://app.orbisdata.ai\n\n## Learn API - Submit Event\nEndpoint to submit a learning event for tracking.\n\n### Endpoint\n```\nPOST {{host}}/rest/v1/learn/event\n```\n\n### Request Body\n**JSON Parameters**\n- **org_token** (string, required): Your organization's unique token.\n- **eventName** (string, required): Name of the event being tracked.\n- **eventVal** (string or JSON, required): Value associated with the event. Can be a simple string or a JSON object.\n- **eventCategory** (string, optional, default: "EXTERNAL"): Category of the event. Use "EXTERNAL" for events originating outside the system.\n- **u** (string, optional): Canonical URL related to the event.\n- **lang** (string, optional, default: "en"): Language of the event data.\n\n**Example Request**\n\n```json\n{\n "org_token": "{{your_org_token}}",\n "eventName": "{{eventname}}",\n "eventVal": {\n "key1": "value1",\n "key2": "value2"\n },\n "eventCategory": "EXTERNAL",\n "u": "{{canonicalUrl}}",\n "lang": "en"\n}\n\n}\n```\n\n### Notes\n- The eventValue field can either be a simple string or a JSON object, providing flexibility in the type of data associated with the event.\n- The eventCategory field is optional and defaults to "EXTERNAL" if not specified.\n- The u field is optional and can be used to provide a canonical URL related to the event. This should be a valid URL.\n- The lang field is optional and defaults to "en" if not specified.\n\n\n### Response\n- If the submission is successful, the API will respond with the following success message:\n```json\nResponse: 200 OK \n{\n "status": "success"\n}\n}\n```\n\n- If the organization is not found, the API will respond with the following error:\n```json\nResponse: 400 BAD REQUEST\n{\n "status": "failed",\n "code": 5104,\n "reason": "Please provide the correct token in the URL."\n}\n```\nThe API will respond with the appropriate status code and a JSON object containing any relevant information or error messages.\n\n\n## User and Organization Registration API\nEndpoint to register a new user and Organization.\n\n### Endpoint\n```\nPOST {{host}}/api/v1/register?token=182416ce389f64a5ffc090dd14bc8da40b4ced86\n```\n\n### Request Body\n**JSON Parameters**\n- **email** (string, required): User's email address.\n- **password** (string, required): User's chosen password.\n- **first_name** (string, required): User's first name.\n- **domain** (string, required): User's domain.\n- **entity** (string, required): User's entity information.\n\n#### Example Request\n```json\n{\n "email": "a3@b.com",\n "password": "1234",\n "first_name": "AT",\n "domain": "domain3.com",\n "entity": "x.getnitro.co"\n}\n```\n\n#### Responses\n**Error Responses**\n- If the user already exists, the API will respond with a 400 BAD REQUEST and the following error message:\n```\nResponse: 400 BAD REQUEST\n\n{\n "status": "error",\n "message": "a3@b.com already registered! Please sign in to continue."\n}\n```\n\n- If the organization already exists, the API will respond with a 400 BAD REQUEST and the following error message:\n```\nResponse: 400 BAD REQUEST\n{\n "status": "error",\n "message": "Org already exists"\n}\n```\n\n**Success Response**\n- If the registration is successful, the API will respond with the following success message:\n```\nResponse: 200 OK \n{\n "status": "success",\n "message": "Registration successful"\n}\n```\nThe API will respond with the appropriate status code and a JSON object containing relevant information or error messages.\n\n
APIs to pass events from Nitro to Orbis.
\nOrbis Production Host: https://app.orbisdata.ai
Endpoint to submit a learning event for tracking.
\nPOST {{host}}/rest/v1/learn/event\n\nJSON Parameters
\nExample Request
\n{\n "org_token": "{{your_org_token}}",\n "eventName": "{{eventname}}",\n "eventVal": {\n "key1": "value1",\n "key2": "value2"\n },\n "eventCategory": "EXTERNAL",\n "u": "{{canonicalUrl}}",\n "lang": "en"\n}\n\n}\n\nResponse: 200 OK \n{\n "status": "success"\n}\n}\n\nResponse: 400 BAD REQUEST\n{\n "status": "failed",\n "code": 5104,\n "reason": "Please provide the correct token in the URL."\n}\n\nThe API will respond with the appropriate status code and a JSON object containing any relevant information or error messages.
\nEndpoint to register a new user and Organization.
\nPOST {{host}}/api/v1/register?token=182416ce389f64a5ffc090dd14bc8da40b4ced86\n\nJSON Parameters
\n{\n "email": "a3@b.com",\n "password": "1234",\n "first_name": "AT",\n "domain": "domain3.com",\n "entity": "x.getnitro.co"\n}\n\nError Responses
\nResponse: 400 BAD REQUEST\n\n{\n "status": "error",\n "message": "a3@b.com already registered! Please sign in to continue."\n}\n\nResponse: 400 BAD REQUEST\n{\n "status": "error",\n "message": "Org already exists"\n}\n\nSuccess Response
\nResponse: 200 OK \n{\n "status": "success",\n "message": "Registration successful"\n}\n\nThe API will respond with the appropriate status code and a JSON object containing relevant information or error messages.
\n [{"title":"API Interation Orbis<>Nitro","anchor":"#api-interation-orbisnitro","children":[{"title":"Learn API - Submit Event","anchor":"#learn-api-submit-event","children":[{"title":"Endpoint","anchor":"#endpoint","children":[]},{"title":"Request Body","anchor":"#request-body","children":[]},{"title":"Notes","anchor":"#notes","children":[]},{"title":"Response","anchor":"#response","children":[]}]},{"title":"User and Organization Registration API","anchor":"#user-and-organization-registration-api","children":[{"title":"Endpoint","anchor":"#endpoint-1","children":[]},{"title":"Request Body","anchor":"#request-body-1","children":[{"title":"Example Request","anchor":"#example-request","children":[]},{"title":"Responses","anchor":"#responses","children":[]}]}]}]}] markdown 2024-01-25T11:37:12.145Z 2024-01-30T11:14:01.733Z markdown en 3 3 {"js":"","css":""} 5 Webhook-Export 4af597301e8d7b1eafd1ba102ac8dd40ec5e5bb8 Exporting via Webhooks f t \N Goto: Integrations Tab\n\n### Step 1\n\nRegister a webhook, and specify the URL and timeout that Nitro server should wait before giving up on the request (in seconds).\nYou can optionally specify a basic autorization that will be passed along in the headers.\n\n.png)\n\n\n## Export on Matched Contact\nYour webhooks will start to recieve the following POST requests for at the time of every matched contact.\n\n```SHELL\nPOST https://webhook-address.com/endpoint\nContent-Type: application/json\nAuthorization: BearerGoto: Integrations Tab
\nRegister a webhook, and specify the URL and timeout that Nitro server should wait before giving up on the request (in seconds).
\nYou can optionally specify a basic autorization that will be passed along in the headers.
.png)
Your webhooks will start to recieve the following POST requests for at the time of every matched contact.
\nPOST https://webhook-address.com/endpoint\nContent-Type: application/json\nAuthorization: Bearer <specified-token>\nUser-Agent: Mozilla/5.0 (compatible; NitroCommerce/2.1; +https://nitrocommerce.ai)\n\n{\n "medium": "matched",\n "contact": "+918505850022"\n "type": "PHONE/EMAIL",\n "date": "2024-02-12",\n "org_id": "your-org-id",\n \n "last_addtocart": "<product_url>",\n "last_view": ["<product_url_1>", "<product_url_1>", "<product_url_1>"]\n}\n\nWhere:
\ncontact: email or phone of the contact detected.\ntype: string from one of {PHONE,EMAIL}\ndate: yyyy-mm-dd formatted date\norg_id: your organisation ID at Nitro.\n\n(The above 4 fields are always sent)
\nAlong with these, the following fileds will be sent, depending on what data Nitro has (depending on deep integration).
\nlast_addtocart: Product URL of the last product that user has added to cart.\nlast_view: Product URLs of last 3 viewed products by the user.\n\nAnother trigger that you can use to capture data is via export on event stream. This data will be sent to specifed endpoint when any activity happens by the user at your webapp.
\nPOST https://webhook-address.com/endpoint\nContent-Type: application/json\nAuthorization: Bearer <specified-token>\nUser-Agent: Mozilla/5.0 (compatible; NitroCommerce/2.1; +https://nitrocommerce.ai)\n\n{\n "medium": "event",\n "contact": "+918505850022"\n "type": "PHONE/EMAIL",\n "date": "2024-02-12",\n "org_id": "your-org-id",\n \n "event": "addtocart/view/buy"\n}\n\n [{"title":"Export on Matched Contact","anchor":"#export-on-matched-contact","children":[]},{"title":"Export trigger on Event","anchor":"#export-trigger-on-event","children":[]}] markdown 2024-02-16T12:57:27.911Z 2024-02-19T12:01:21.313Z markdown en 1 1 {"js":"","css":""}
6 exporting-data 9c472154cff0b77415f64439f7902fdf5a05b8ec Exporting Data f t \N There as multiple integrations available to export data.\n\n* [Webhook-Export](/Webhook-Export)\n* [Javascript-Export-hooks](/javascript-events) There as multiple integrations available to export data.
\n\n [] markdown 2024-02-16T13:01:20.127Z 2024-05-31T08:26:16.175Z markdown en 1 1 {"js":"","css":""} 13 wordpress-plugin 0071b22519fd44ff986a0cb311c335134fd158fd Nitro Wordpress Plugin f t \N # Nitrox WordPress Plugin Installation Guide\n\n## Table of Contents\n1. [Introduction](#introduction)\n2. [Requirements](#requirements)\n3. [Installation](#installation)\n4. [Configuration](#configuration)\n5. [Usage](#usage)\n6. [Event Tracking](#event-tracking)\n7. [Custom Event Tracking](#custom-event-tracking)\n\n## Introduction\nThe Nitrox WordPress plugin is designed to track user activities on your WooCommerce store and send these events to the Nitrox SaaS application. The plugin captures events like product views, add to cart, checkout, purchase, and more, providing valuable insights into user behavior.\n\n## Requirements\n- WordPress 5.0 or higher\n- WooCommerce 3.0 or higher\n- PHP 7.0 or higher\n- Nitrox SaaS account\n\n## Installation\n### Manual Installation\n1. **Download the Plugin**\n - Download the latest version of the Nitrox plugin from the [Nitrox](https://cdn.nitrocommerce.ai/plugins/nitrox-woocommerce.zip).\n\n2. **Upload the Plugin to WordPress**\n - Go to your WordPress admin dashboard.\n - Navigate to `Plugins` > `Add New`.\n - Click on the `Upload Plugin` button.\n - Choose the downloaded plugin file (`nitrox.zip`) and click `Install Now`.\n\n3. **Activate the Plugin**\n - After the installation, click on `Activate Plugin` to enable Nitrox.\n\n### Installation via FTP\n1. **Download the Plugin**\n - Download the latest version of the Nitrox plugin from the [Nitrox](https://cdn.nitrocommerce.ai/plugins/nitrox-woocommerce.zip).\n\n2. **Upload the Plugin via FTP**\n - Unzip the `nitrox.zip` file.\n - Connect to your server via FTP.\n - Navigate to the `/wp-content/plugins/` directory.\n - Upload the unzipped `nitrox` folder to this directory.\n\n3. **Activate the Plugin**\n - Go to your WordPress admin dashboard.\n - Navigate to `Plugins` and find `Nitrox` in the list.\n - Click `Activate` to enable the plugin.\n\n## Configuration\n1. **Access the Settings**\n - Go to `Settings` > `Nitrox` in your WordPress admin dashboard.\n\n2. **Enter the Org Token**\n - Enter your organization token provided by Nitrox in the `Org Token` field.\n\n3. **Save Changes**\n - Click `Save Changes` to store your settings.\n\n## Usage\n### Event Tracking\nThe Nitrox plugin automatically tracks the following events on your WooCommerce store:\n- **Product View:** When a user views a product page.\n- **Update Cart:** When a user adds a product to their cart..\n- **Checkout:** When a user initiates the checkout process.\n- **Buy:** When a user completes a purchase.\n- **Category View:** When a user views a product category page.\n- **Removed From Cart:** When a user removes a product from their cart.\n- **User Registration:** When a user registers on your site.\n- **User Login:** When a user logs in to your site.\n\n\n### Custom Event Tracking\nYou can also track custom events using the global JavaScript methods provided by the plugin. These methods can be called from anywhere within your site to track specific user interactions.\n\n#### Example:\n```javascript\n\nThe Nitrox WordPress plugin is designed to track user activities on your WooCommerce store and send these events to the Nitrox SaaS application. The plugin captures events like product views, add to cart, checkout, purchase, and more, providing valuable insights into user behavior.
\nDownload the Plugin
\nUpload the Plugin to WordPress
\nPlugins > Add New.Upload Plugin button.nitrox.zip) and click Install Now.Activate the Plugin
\nActivate Plugin to enable Nitrox.Download the Plugin
\nUpload the Plugin via FTP
\nnitrox.zip file./wp-content/plugins/ directory.nitrox folder to this directory.Activate the Plugin
\nPlugins and find Nitrox in the list.Activate to enable the plugin.Access the Settings
\nSettings > Nitrox in your WordPress admin dashboard.Enter the Org Token
\nOrg Token field.Save Changes
\nSave Changes to store your settings.The Nitrox plugin automatically tracks the following events on your WooCommerce store:
\nYou can also track custom events using the global JavaScript methods provided by the plugin. These methods can be called from anywhere within your site to track specific user interactions.
\n<script>\n // Track a custom event\n nitro.track('custom_event_name', {\n property1: 'value1',\n property2: 'value2'\n });\n</script>\n\n [{"title":"Nitrox WordPress Plugin Installation Guide","anchor":"#nitrox-wordpress-plugin-installation-guide","children":[{"title":"Table of Contents","anchor":"#table-of-contents","children":[]},{"title":"Introduction","anchor":"#introduction","children":[]},{"title":"Requirements","anchor":"#requirements","children":[]},{"title":"Installation","anchor":"#installation","children":[{"title":"Manual Installation","anchor":"#manual-installation","children":[]},{"title":"Installation via FTP","anchor":"#installation-via-ftp","children":[]}]},{"title":"Configuration","anchor":"#configuration","children":[]},{"title":"Usage","anchor":"#usage","children":[{"title":"Event Tracking","anchor":"#event-tracking","children":[]},{"title":"Custom Event Tracking","anchor":"#custom-event-tracking","children":[{"title":"Example:","anchor":"#example","children":[]}]}]}]}] markdown 2024-08-06T18:39:55.635Z 2024-09-11T10:08:58.356Z markdown en 3 8 {"js":"","css":""}
7 SSO-APIs c9620f8a5fc18b79f8fbaaced53bc2beb0e78fec SSO APIs f t \N == SSO APIs\n\nRegister your app\nPath : v1/register_app?name=app_name&auth_url=https://yourappurl\n\nBegin authentication\nPath /v1/sso/begin?client_id=f38355a4-e60e-48f6-8d78-660ae2de8cbe&next=http://172.17.0.1:5173&sign=2eae9291-678a-4bc9-924f-e9075c9d6734\n\nQuery params : client_id\n\t next\n\t\t sign\n\nGet long lived token by short lived token\nv1/get_bearer_token?slt=3764baea-6eaa-4360-86e0-8f0d4b4baf15&client_id=f38355a4-e60e-48f6-8d78-660ae2de8cbe\n Register your app\nPath : v1/register_app?name=app_name&auth_url=https://yourappurl
\nBegin authentication\nPath /v1/sso/begin?client_id=f38355a4-e60e-48f6-8d78-660ae2de8cbe&next=http://172.17.0.1:5173&sign=2eae9291-678a-4bc9-924f-e9075c9d6734
\nQuery params : client_id\n\t next\n\t\t sign
\nGet long lived token by short lived token\nv1/get_bearer_token?slt=3764baea-6eaa-4360-86e0-8f0d4b4baf15&client_id=f38355a4-e60e-48f6-8d78-660ae2de8cbe
\nWhen Nitro Identifies a user, it calls a method (if defined) as follows in the head section of your page.
\nwindow.nitroSettings = {\n "events": {\n "onIdentify": function (phone, email, name) {\n }\n }\n // Any more settings\n}\n\nNitro will call this function, whenever an identification happens.
\n [{"title":"Capturing Data from Javascript SDK","anchor":"#capturing-data-from-javascript-sdk","children":[]}] markdown 2024-05-31T08:26:13.213Z 2024-05-31T08:26:15.249Z markdown en 1 1 {"js":"","css":""} 9 pop-up-modal bc00d309f0c7347485aea9b1b0bdda034146b5ee Nitro Popup Modal f t \N # Popup Modal\n\nIf you want to fire the popup manually, set the timeout of the popup to be -1 (not zero) from the UI and use this call:\n\n```\nnitro.loadPrefillCaputure()\n```\n\nThe popup can be toggled from the UI, however if you want to have events of the popup, you can set/define the following in the HEAD section of your page:\n\n```\nwindow.nitroSettings = {\n "prefillCapture": {\n "onClose": function () {},\n "onShow": function () {},\n "onFill": function (data) {\n \t\t/* where data is seralized for that was there in the popup */\n },\n }\n}\n```\n\nIf you want to fire the popup manually, set the timeout of the popup to be -1 (not zero) from the UI and use this call:
\nnitro.loadPrefillCaputure()\n\nThe popup can be toggled from the UI, however if you want to have events of the popup, you can set/define the following in the HEAD section of your page:
\nwindow.nitroSettings = {\n "prefillCapture": {\n "onClose": function () {},\n "onShow": function () {},\n "onFill": function (data) {\n \t\t/* where data is seralized for that was there in the popup */\n },\n }\n}\n\n [{"title":"Popup Modal","anchor":"#popup-modal","children":[]}] markdown 2024-05-31T08:22:09.465Z 2024-05-31T08:24:43.294Z markdown en 1 1 {"js":"","css":""}
11 nitro-api 8156ad131261172c3095623e1c2bab85fce492dc Nitro API Reference f t \N # Nitro Integration API Document\n\n\n### Scope:\nThis document covers the scope of registering a User with Nitro Commerce and getting their Organisation information, to be further used by your platform user.\n\n### Steps:\nYou need to call the login API in order to get the bearer token. This token will be used to create the User with the Nitro Commerce.\n\nCall the Register API with the required headers and data to register a Client(User) with the Nitro Commerce.\n\nWith every User, an Organisation is auto generated and assigned to that particular user. The same Organisation is also assigned to your Platform User, which can be viewed from the Dropdown provided in the top right corner of the Nitro Commerce Dashboard.\n\nYour Platform User will be able to see the list of Organisations created by them and access those Organisations.\n\n### Login API:\n```\nMethod: POST\nURL: https://svc.nitrocommerce.ai/v1/rest/This document covers the scope of registering a User with Nitro Commerce and getting their Organisation information, to be further used by your platform user.
\nYou need to call the login API in order to get the bearer token. This token will be used to create the User with the Nitro Commerce.
\nCall the Register API with the required headers and data to register a Client(User) with the Nitro Commerce.
\nWith every User, an Organisation is auto generated and assigned to that particular user. The same Organisation is also assigned to your Platform User, which can be viewed from the Dropdown provided in the top right corner of the Nitro Commerce Dashboard.
\nYour Platform User will be able to see the list of Organisations created by them and access those Organisations.
\nMethod: POST\nURL: https://svc.nitrocommerce.ai/v1/rest/<your_platform_name>/users/login\nData: { "email": "<PLATFORM_ACCOUNT_EMAIL>", "password": "<PLATFORM_ACCOUNT_PASSWORD>" }\nHeaders: \n- Content-Type: application/json\n\n\ncurl --location 'https://svc.nitrocommerce.ai/v1/rest/<your_platform_name>/users/login' \\\n-H 'Content-Type: application/json' \\\n--data-raw '{ "email": "<PLATFORM_ACCOUNT_EMAIL>", "password": "<PLATFORM_ACCOUNT_PASSWORD>" }'\n\n{\n "bearer_token": "<PLATFORM_ACCOUNT_USER_BEARER_TOKEN>",\n "user": {\n "id": 3,\n "name": "<PLATFORM_ACCOUNT_USER_NAME>",\n "email": "<PLATFORM_ACCOUNT_EMAIL>",\n "username": "<PLATFORM_ACCOUNT_EMAIL>",\n "is_active": true,\n "phone": "<PLATFORM_ACCOUNT_USER_PHONE>",\n "is_email_verified": false,\n "is_phone_verified": false,\n "is_superuser": false\n },\n "code": 2001,\n "message": "OK"\n}\n\n{\n "code": 4011,\n "message": "Invalid login credentials."\n}\n\nMethod: POST\nURL: https://svc.nitrocommerce.ai/v1/rest/<your_platform_name>/users/register\nData: { "email": "<USER_EMAIL>", "name": "<NAME>", "phone": "<USER_PHONE>", "domain": "<ORGANISATION_DOMAIN>", "organisation_name": "<NAME_OF_ORGANISATION>" }\nHeaders: \n- Content-Type: application/json\n- Authorization: Bearer <platform_account_user_bearer_token>\n\ncurl --location 'https://svc.nitrocommerce.ai/v1/rest/<your_platform_name>/users/register' \\\n-H 'Content-Type: application/json' \\\n-H 'Authorization: Bearer <platform_account_user_bearer_token>' \\\n--data-raw '{\n "email": "<USER_EMAIL>", "name": "<NAME>", "phone": "<USER_PHONE>, "domain": "<ORGANISATION_DOMAIN>", "organisation_name": "<NAME_OF_ORGANISATION>""\n}'\n\n{\n "user": {\n "id": 3,\n "name": "<USER_NAME>",\n "email": "<USER_EMAIL>",\n "username": "<USER_EMAIL>",\n "is_active": true,\n "phone": "<USER_PHONE>",\n "is_email_verified": false,\n "is_phone_verified": false,\n "is_superuser": false\n },\n "organisation": {\n "id": <ORGANISATION_ID>,\n "token": "<ORGANISATION_TOKEN>",\n "name": "",\n "domain": "<ORGANISATION_DOMAIN>",\n "currency": "",\n "country_code": "",\n "is_active": true,\n "logo": "",\n "wid": null,\n "created_at": "2024-07-10T09:56:21.863123+00:00",\n "modified_at": "2024-07-10T09:56:21.862801+00:00",\n "referer": null,\n "features_enabled": ""\n },\n "code": 2011,\n "message": "Created"\n}\n\nUser:
\n\n{\n "code": 4009,\n "message": "Email Already exists"\n}\n\nOrganisation:
\n{\n "code": 40010,\n "message": "Organisation Exists. Cannot assign existing Organisations."\n}\n\nMethod: POST\nURL: https://svc.nitrocommerce.ai/v1/rest/<your_platform_name>/integration\nData: {"org_id":<organisation_id>,"active":true,"type":"WEBHOOK","data":{"endpoint":"https://somewebhook.com","authToken":"abXXefg","httpTimeout":"3","do_events":true,"do_contacts":true}}\nHeaders: \n- Content-Type: application/json\n- Authorization: Bearer <platform_account_user_bearer_token>\n\ncurl 'https://svc.nitrocommerce.ai/v1/rest/integration' \\\n-X 'POST' \\\n-H 'Authorization: Bearer <platform_account_user_bearer_token>' \\\n-H 'Content-Type: application/json' \\\n--data-raw '{"org_id":<organisation_id>,"active":true,"type":"WEBHOOK","data":{"endpoint":"https://somewebhook.com","authToken":"abXXefg","httpTimeout":"3","do_events":true,"do_contacts":true}}'\n\nMethod: PUT\nURL: https://svc.nitrocommerce.ai/v1/rest/<your_platform_name>/integration\nData: {"org_id":<organisation_id>,"active":true/false,"type":"WEBHOOK","data":{"endpoint":"https://somewebhook.com","authToken":"abXXefg","httpTimeout":"3","do_events":true,"do_contacts":true},"id":<WEBHOOK_ID>}\n\nHeaders: \n- Content-Type: application/json\n- Authorization: Bearer <platform_account_user_bearer_token>\n\n\ncurl 'https://svc.nitrocommerce.ai/v1/rest/integration' \\\n -X 'PUT' \\\n -H 'Authorization: Bearer <platform_account_user_bearer_token>' \\\n -H 'Content-Type: application/json' \\\n --data-raw '{"org_id":<organisation_id>,"active":true/false,"type":"WEBHOOK","data":{"endpoint":"https://somewebhook.com","authToken":"abXXefg","httpTimeout":"3","do_events":true,"do_contacts":true},"id":<WEBHOOK_ID>}'\n\n [{"title":"Nitro Integration API Document","anchor":"#nitro-integration-api-document","children":[]}] markdown 2024-07-16T10:06:23.492Z 2024-07-16T10:55:20.427Z markdown en 3 3 {"js":"","css":""}
12 android-sdk 23b2db2ae1ffd682acdb47b91b31d1905f733610 Nitro Android SDK f f \N # Nitrox SDK Documentation Guide\n\n## Overview\nNitrox SDK is designed to help you track various user events in your Android application. This guide will walk you through the initialization process and how to use the SDK to track specific events.\n\n## 1. Initialization\n\n### Add Nitrox SDK to your project\nAdd dependency in build.gradle (app level):\n```gradle\nimplementation 'Nitrox SDK is designed to help you track various user events in your Android application. This guide will walk you through the initialization process and how to use the SDK to track specific events.
\nAdd dependency in build.gradle (app level):
\nimplementation '<ADD_REPOSITORY PATH>'\n\nCreate a class that extends NitroxApplication and initialize the Nitrox SDK in the onCreate method.
package com.example.nitroxsdkpocapp;\n\nimport com.nitrox.sdk.Nitrox;\nimport com.nitrox.sdk.base.NitroxApplication;\n\npublic class MyExtendedApplication extends NitroxApplication {\n\n @Override\n public void onCreate() {\n super.onCreate(); // Always call this method first before writing any other logic.\n Nitrox.initialize("<ORG_TOKEN>", this);\n new android.os.Handler(android.os.Looper.getMainLooper()).postDelayed(new Runnable() {\n @Override\n public void run() {\n NitroDeviceMapper nitroDeviceMapper = new NitroDeviceMapper();\n nitroDeviceMapper.push();\n }\n }, 100);\n }\n}\n\n<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="....>\n <application android:name=".MyExtendedApplication"...>\n <activity android:name= ......></activity>\n </application>\n</manifest>\n\nCongratulations! You have successfully integrated Nitrox SDK in your app. Let us guide you through usage of this SDK.
\nTo identify users, such as during registration, login, or when they provide personal details during checkout, use the IdentifyMapper as follows:
\nIdentifyMapper identifyMapper = new IdentifyMapper();\nidentifyMapper.setFullName("<FULL_NAME>");\nidentifyMapper.setEmail("<EMAIL>");\nidentifyMapper.setPhone("<PHONE>");\nidentifyMapper.push();\n\nReplace <FULL_NAME>, <EMAIL>, and <PHONE> with the user's details.
Track when a user views a page:
\nNitroEventMapper nitroEventMapper = new NitroEventMapper();\nnitroEventMapper.setEventName("view");\n\nJSONObject eventData = new JSONObject();\ntry {\n eventData.put("page", "https://someurl.com"); // replace with your deeplink\n} catch (JSONException e) {\n e.printStackTrace();\n}\n\nnitroEventMapper.setEventValue(eventData);\nnitroEventMapper.push();\n\nTrack when a user adds items to the cart:
\nNitroEventMapper nitroEventMapper = new NitroEventMapper();\nnitroEventMapper.setEventName("addtocart");\n\nJSONObject eventData = new JSONObject();\ntry {\n eventData.put("cart_url", "https://someurl.com");\n eventData.put("product_id", 123456);\n JSONArray lineItems = new JSONArray();\n JSONObject lineItem = new JSONObject();\n lineItem.put("quantity", 1);\n lineItem.put("title", "Black Box");\n lineItem.put("line_price", 24.00);\n lineItem.put("id", "987654"); // Variant ID\n lineItem.put("product_id", "1234567");\n lineItem.put("image_url", "variant or product image url");\n lineItems.put(lineItem);\n eventData.put("line_items", lineItems);\n eventData.put("cart_value", 24.00);\n} catch (JSONException e) {\n e.printStackTrace();\n}\n\nnitroEventMapper.setEventValue(eventData);\nnitroEventMapper.push();\n\nTrack when a user proceeds to checkout:
\nNitroEventMapper nitroEventMapper = new NitroEventMapper();\nnitroEventMapper.setEventName("checkout");\n\nJSONObject eventData = new JSONObject();\ntry {\n eventData.put("checkout", "<checkout_url>");\n JSONArray items = new JSONArray();\n JSONObject item = new JSONObject();\n item.put("product_id", 12345);\n item.put("price", "12/-");\n item.put("product_url", "https://someurl.com/product_id");\n items.put(item);\n eventData.put("items", items);\n eventData.put("cart_value", <total_checkout_amount>);\n} catch (JSONException e) {\n e.printStackTrace();\n}\n\nnitroEventMapper.setEventValue(eventData);\nnitroEventMapper.push();\n\nTrack when a user completes a purchase:
\nNitroEventMapper nitroEventMapper = new NitroEventMapper();\nnitroEventMapper.setEventName("buy");\n\nJSONObject eventData = new JSONObject();\ntry {\n eventData.put("checkout_url", "https://someurl.com");\n JSONArray items = new JSONArray();\n JSONObject item = new JSONObject();\n item.put("product_id", 12345);\n item.put("price", "12/-");\n item.put("product_url", "https://someurl.com/product_id");\n items.put(item);\n eventData.put("items", items);\n} catch (JSONException e) {\n e.printStackTrace();\n}\n\nnitroEventMapper.setEventValue(eventData);\nnitroEventMapper.push();\n\nTrack when a user views a product:
\nNitroEventMapper nitroEventMapper = new NitroEventMapper();\nnitroEventMapper.setEventName("product_view");\n\nJSONObject eventData = new JSONObject();\ntry {\n eventData.put("product_id", 12345);\n eventData.put("price", "12/-");\n eventData.put("product_url", "https://someurl.com/product_id");\n} catch (JSONException e) {\n e.printStackTrace();\n}\n\nnitroEventMapper.setEventValue(eventData);\nnitroEventMapper.push();\n\nTrack when a user views a category:
\nNitroEventMapper nitroEventMapper = new NitroEventMapper();\nnitroEventMapper.setEventName("category_view");\n\nJSONObject eventData = new JSONObject();\ntry {\n eventData.put("category", "fashion");\n} catch (JSONException e) {\n e.printStackTrace();\n}\n\nnitroEventMapper.setEventValue(eventData);\nnitroEventMapper.push();\n\n [{"title":"Nitrox SDK Documentation Guide","anchor":"#nitrox-sdk-documentation-guide","children":[{"title":"Overview","anchor":"#overview","children":[]},{"title":"1. Initialization","anchor":"#h-1-initialization","children":[{"title":"Add Nitrox SDK to your project","anchor":"#add-nitrox-sdk-to-your-project","children":[]},{"title":"Extend NitroxApplication","anchor":"#extend-nitroxapplication","children":[]},{"title":"Update Manifest","anchor":"#update-manifest","children":[]}]},{"title":"2. Identifying Users","anchor":"#h-2-identifying-users","children":[{"title":"User Identification Events","anchor":"#user-identification-events","children":[]}]},{"title":"3. Tracking Events","anchor":"#h-3-tracking-events","children":[{"title":"3.1 View Event","anchor":"#h-31-view-event","children":[]},{"title":"3.2 Add to Cart Event","anchor":"#h-32-add-to-cart-event","children":[]},{"title":"3.3 Checkout Event","anchor":"#h-33-checkout-event","children":[]},{"title":"3.4 Buy Event","anchor":"#h-34-buy-event","children":[]},{"title":"3.5 Product View Event","anchor":"#h-35-product-view-event","children":[]},{"title":"3.6 Category View Event","anchor":"#h-36-category-view-event","children":[]}]}]}] markdown 2024-08-05T12:56:49.274Z 2024-08-06T18:31:46.576Z markdown en 8 8 {"js":"","css":""}
16 quick-start-guide fcd1c9361d3d6a4f98c69d10c992f901361df942 Quick Start Guide This document contains detailed information on how to get started with NitroX f t \N \n
Overview:
\nOur Quick Start Guide is designed to help you set up and begin using our platform effectively. This guide will walk you through the essential steps to integrate NitroX with your website, configure key features, and start optimizing your e-commerce strategy.
\nYou will accomplish this in three steps through the NitroX dashboard:
\nFollow these instructions to make the most out of NitroX and start turning your website traffic into valuable insights and conversions.
\n1. a) If you own a Shopify Website: Install the ‘SuperAcquire’ App via the Shopify App Store
\n
1. b) If you own a non-Shopify Website: Create an account
\n
2. Integrate with your Website: For non-Shopify
\n

3. Configure Key Features
\n

\n


\n





4. Start Monitoring and Optimizing
\nCongratulations on getting started with NitroX! If you encounter any issues or need additional support, please refer to our help center or contact our support team. With NitroX, you’re equipped to turn your website traffic into actionable insights and successful conversions. Happy optimizing!
\n
\n
\n
\n
Overview:
\nOur Quick Start Guide is designed to help you set up and begin using our platform effectively. This guide will walk you through the essential steps to integrate NitroX with your website, configure key features, and start optimizing your e-commerce strategy.
\nYou will accomplish this in three steps through the NitroX dashboard:
\nFollow these instructions to make the most out of NitroX and start turning your website traffic into valuable insights and conversions.
\n1. a) If you own a Shopify Website: Install the ‘SuperAcquire’ App via the Shopify App Store
\n
1. b) If you own a non-Shopify Website: Create an account
\n
2. Integrate with your Website: For non-Shopify
\n

3. Configure Key Features
\n

\n


\n





4. Start Monitoring and Optimizing
\nCongratulations on getting started with NitroX! If you encounter any issues or need additional support, please refer to our help center or contact our support team. With NitroX, you’re equipped to turn your website traffic into actionable insights and successful conversions. Happy optimizing!
\n
\n
\n [{"title":"NitroX - Quick Start Guide","anchor":"#nitrox-quick-start-guide","children":[]}] html 2024-09-02T13:49:45.352Z 2024-09-09T09:37:40.575Z ckeditor en 10 10 {"js":"","css":""} 17 consent-management 287bfd88e36ea981a654c6e8b9fbe2fc6b324061 Consent Management This document consists detailed description of the Consent Management Feature f t \N
\n
Overview:
\nThe Consent Management feature in NitroX is designed to streamline and optimize the process of obtaining and managing user consent for data collection on your e-commerce website. This feature simplifies user interactions, ensures compliance with data protection regulations, and enhances the overall efficiency of your data management practices. Enabling this feature has proven to improve overall identification rate by approximately 30%. It also allows more personalised engagement, especially in the Middle-of-the-Funnel.
\n
Key Functions:
\nTypes of Consent Management:
\n1. Prefilled Templates:
\nThese are discount or non-discount based consent management templates. They consist of 2 steps: a) Phone number pre-fill and submission and b) Success Message consisting of a “Welcome” msg and/or “Coupon code” details
\n
2. Auto Login Templates:
\nThese are OTP-based consent management templates which not only pre-fill identified user phone number, but also verify the same upon submission via a One-Time Password. The OTP is generated, sent & validated by Nitro system hence it is hassle-free for you.
\nThese templates don't just manage user consent, they also auto-login the user to your website. This helps in logged website tracking as well as targeted recommendations and product bundling
\n
How does Auto Login work?
\n


Once OTP is successfully verified, user will be auto logged in to your website.
\n
\n
Benefits:
\nConclusion:
\nThe Consent Management feature of NitroX is essential for e-commerce businesses looking to efficiently handle user consent while maintaining compliance with privacy regulations, ultimately supporting better data practices and improved customer interactions.
\n\n
\n
Overview:
\nThe Consent Management feature in NitroX is designed to streamline and optimize the process of obtaining and managing user consent for data collection on your e-commerce website. This feature simplifies user interactions, ensures compliance with data protection regulations, and enhances the overall efficiency of your data management practices. Enabling this feature has proven to improve overall identification rate by approximately 30%. It also allows more personalised engagement, especially in the Middle-of-the-Funnel.
\n
Key Functions:
\nTypes of Consent Management:
\n1. Prefilled Templates:
\nThese are discount or non-discount based consent management templates. They consist of 2 steps: a) Phone number pre-fill and submission and b) Success Message consisting of a “Welcome” msg and/or “Coupon code” details
\n
2. Auto Login Templates:
\nThese are OTP-based consent management templates which not only pre-fill identified user phone number, but also verify the same upon submission via a One-Time Password. The OTP is generated, sent & validated by Nitro system hence it is hassle-free for you.
\nThese templates don't just manage user consent, they also auto-login the user to your website. This helps in logged website tracking as well as targeted recommendations and product bundling
\n
How does Auto Login work?
\n


Once OTP is successfully verified, user will be auto logged in to your website.
\n
\n
Benefits:
\nConclusion:
\nThe Consent Management feature of NitroX is essential for e-commerce businesses looking to efficiently handle user consent while maintaining compliance with privacy regulations, ultimately supporting better data practices and improved customer interactions.
\n\n [{"title":"NitroX - Consent Management","anchor":"#nitrox-consent-management","children":[]}] html 2024-09-09T10:04:55.765Z 2024-09-09T11:17:47.519Z ckeditor en 10 10 {"js":"","css":""} 2 integration-guide 9aea3e2a86ff0f3e51532038c83266ed0b2653e8 Nitro Js API Integration guide f t \N ## **Nitro JavaScript API Integration Documentation**\n\nThis guide provides information on how to use Nitro's JavaScript API to identify visitors and track various events on your website.\n\n\n\n### Table of Contents\n\n1. Visitor Identification\n2. Events Tracking\n2.1. View Event\n2.2. Update Cart Event\n2.3. Checkout Event\n2.4. Buy Event\n2.5. Product View Event\n2.6. Category View Event\n2.7. Custom Events\n2.8. High Intent Users\n\n\n\n### 1.\tVisitor Identification \nUse **nitro.identify** method to identify visitors by providing their email, phone, and name.\n```js\nnitro.identify("
This guide provides information on how to use Nitro's JavaScript API to identify visitors and track various events on your website.
\nUse nitro.identify method to identify visitors by providing their email, phone, and name.
\nnitro.identify("<visitor_email>", "<visitor_phone>", "<visitor_name>");\n\n\nDifferent events can be tracked with the help of methods enlisted below:
\nUse nitro.view method to track page views.
\n// Example view event data\nview_data = {\n page: "https://someurl.com"\n}\n\n// Track view event\nnitro.view(view_data);\n\n\nUse nitro.updatecart method to track when items are added to the cart. line_items should contain item/items added to cart.
\n// Example add to cart event data\ncart_data = {"line_items": line_items, "cart_value": cart_value}\ncart_data = {\n cart_url: "https://someurl.com",\n product_id: 123456,\n line_items: [{\n "quantity": 1,\n "title": "Black Box",\n "line_price", 24.00,\n "id": "987654" (Variant Id),\n "product_id": "1234567",\n "image_url": "variant or product image url"\n },\n {\n "quantity": 1,\n "title": "Pink Box",\n "line_price", 20.00,\n "id": "987654" (Variant Id),\n "product_id": "1234568",\n "image_url": "variant or product image url"\n }],\n \tcart_value: 44.00\n}\n\n// Track add to cart event\nnitro.updatecart(cart_data);\n\n\nUse nitro.removefromcart method to track when items are removed from the cart. line_items should contain item/items removed from cart
\n// Example remove from cart event data\ncart_data = {"line_items": line_items, "cart_value": cart_value}\ncart_data = {\n cart_url: "https://someurl.com",\n product_id: 123456,\n line_items: [{\n "quantity": 1,\n "title": "Black Box",\n "line_price", 24.00,\n "id": "987654" (Variant Id),\n "product_id": "1234567",\n "image_url": "variant or product image url"\n }],\n \tcart_value: 20.00\n}\n\n// Track add to cart event\nnitro.removefromcart(cart_data);\n\n\nUse nitro.checkout method to track checkout events.
\n// Example checkout event data\ncheckout_data = {\n checkout: "<checkout_url>",\n items: [\n {\n product_id: 12345,\n price: 12.00,\n product_url: "https://someurl.com/product_id"\n },\n {\n product_id: 12346,\n price: 18.00,\n product_url: "https://someurl.com/product_id"\n }\n ],\n cart_value: <total_checkout_amount>,\n}\n\n// Track checkout event\nnitro.checkout(checkout_data);\n\n\nUse nitro.buy method to track purchase events.
\n// Example buy event data\nbuy_data = {\n checkout_url: "https://someurl.com",\n \torder_id: "1231312312312",\n items: [\n {\n product_id: 12345,\n price: 12.00,\n product_url: "https://someurl.com/product_id"\n },\n {\n product_id: 12346,\n price: 12.00,\n product_url: "https://someurl.com/product_id"\n }\n ]\n}\n\n// Track buy event\nnitro.buy(buy_data);\n\n\nUse nitro.productView method to track product view events.
\n// Example product view event data\nproduct_data = {\n product_id: 12345,\n price: "12.00",\n product_url: "https://someurl.com/product_id"\n}\n\n// Track product view event\nnitro.productView(product_data);\n\n\nUse nitro.categoryView method to track category view events.
\n// Example category view event data\ncategory_data = {\n category: "fashion"\n}\n\n// Track category view event\nnitro.categoryView(category_data);\n\n\nUse nitro.track method to track custom events.
\n// Example custom event\nnitro.track("<EVENT_NAME>", EVENT_VALUE);\n\n\nEvents to enter funnel = ["addtocart", "updatecart", "checkout"]
\nEvents to exit funnel = "buy"
\n [{"title":"Nitro JavaScript API Integration Documentation","anchor":"#nitro-javascript-api-integration-documentation","children":[{"title":"Table of Contents","anchor":"#table-of-contents","children":[]},{"title":"1.\\tVisitor Identification","anchor":"#h-1visitor-identification","children":[]},{"title":"2. Events Tracking","anchor":"#h-2-events-tracking","children":[{"title":"2.1. View Event","anchor":"#h-21-view-event","children":[]},{"title":"2.2. Update Cart Event on add to cart","anchor":"#h-22-update-cart-event-on-add-to-cart","children":[]},{"title":"2.3. Remove From Cart Event","anchor":"#h-23-remove-from-cart-event","children":[]},{"title":"2.4. Checkout Event","anchor":"#h-24-checkout-event","children":[]},{"title":"2.5. Buy Event","anchor":"#h-25-buy-event","children":[]},{"title":"2.6. Product View Event","anchor":"#h-26-product-view-event","children":[]},{"title":"2.7. Category View Event","anchor":"#h-27-category-view-event","children":[]},{"title":"2.8. Custom Events","anchor":"#h-28-custom-events","children":[]},{"title":"2.8. High Intent Users -","anchor":"#h-28-high-intent-users-","children":[]}]}]}] markdown 2024-01-24T10:36:27.610Z 2024-09-11T09:21:07.204Z markdown en 7 1 {"js":"","css":""} 15 nitrox-user-guide 594e4933e5400a560ccb142994572d07aa1ad7c3 NitroX User Guide This document consists a detailed understanding of NitroX f t \N\n
Overview:
\nIn today’s e-commerce landscape, businesses face significant challenges such as rising Customer Acquisition Costs (CAC), poor Return on Ad Spend (ROAS), and the repetitive cycle of targeting the same customer pool. Perhaps most critically, up to 99% of website visitors remain anonymous, making it difficult to convert traffic into actual sales.
\nNitroX is a cutting-edge Revenue as a Service (RaaS) platform designed to address these challenges head-on. Leveraging a decade of innovation and patent-pending identification technology, NitroX transforms anonymous website visitors into identifiable shoppers, enabling e-commerce businesses to capture and convert more of their traffic.
\n\n
Platform Features:
\nNitroX is packed with powerful features that help e-commerce businesses unlock the full potential of their website traffic.
\n1. Live Activity Monitoring: Get real-time insights into customer behavior, enabling swift adjustments to your marketing strategies
\n
2. Contacts: Build and update a robust customer database with daily refreshed, consented user contact information
\n
3. Consent Management: Automatically pre-fill contact info for identified visitors, streamlining consent management and activity tracking
\n
4. High-Intent Users: Identify and target visitors most likely to convert, boosting conversion rates and ROAS with personalized strategies
\n
5. Forever Links: Redirect users from in-app browsers to their default browser for a fully optimized website experience, increasing engagement and conversions
\n
6. Integrations: Connect NitroX to any CRM platform, utilizing identified user data to automate personalized communication and enhance customer engagement
\n
\n
Core Concepts:
\n\n
Getting Started:
\nThe best way to get started with NitroX is by following our Quick Start Guide. This guide will walk you through the essentials in just a few steps:
\n1. Create Your Account: Sign up and activate your NitroX account.
\n2. Integrate with Your Website: If your website is built on Shopify you can install the app directly or you can add the NitroX tracking code to your website.
\n3. Configure Key Features: Set up Consent Management, High-Intent Users, Forever Links, Live Activity Monitoring, and Contacts Management.
\n4. Start Monitoring and Optimizing: Begin exploring user data and adjusting your strategies to maximize performance.
\n\n
\n
Overview:
\nIn today’s e-commerce landscape, businesses face significant challenges such as rising Customer Acquisition Costs (CAC), poor Return on Ad Spend (ROAS), and the repetitive cycle of targeting the same customer pool. Perhaps most critically, up to 99% of website visitors remain anonymous, making it difficult to convert traffic into actual sales.
\nNitroX is a cutting-edge Revenue as a Service (RaaS) platform designed to address these challenges head-on. Leveraging a decade of innovation and patent-pending identification technology, NitroX transforms anonymous website visitors into identifiable shoppers, enabling e-commerce businesses to capture and convert more of their traffic.
\n\n
Platform Features:
\nNitroX is packed with powerful features that help e-commerce businesses unlock the full potential of their website traffic.
\n1. Live Activity Monitoring: Get real-time insights into customer behavior, enabling swift adjustments to your marketing strategies
\n
2. Contacts: Build and update a robust customer database with daily refreshed, consented user contact information
\n
3. Consent Management: Automatically pre-fill contact info for identified visitors, streamlining consent management and activity tracking
\n
4. High-Intent Users: Identify and target visitors most likely to convert, boosting conversion rates and ROAS with personalized strategies
\n
5. Forever Links: Redirect users from in-app browsers to their default browser for a fully optimized website experience, increasing engagement and conversions
\n
6. Integrations: Connect NitroX to any CRM platform, utilizing identified user data to automate personalized communication and enhance customer engagement
\n
\n
Core Concepts:
\n\n
Getting Started:
\nThe best way to get started with NitroX is by following our Quick Start Guide. This guide will walk you through the essentials in just a few steps:
\n1. Create Your Account: Sign up and activate your NitroX account.
\n2. Integrate with Your Website: If your website is built on Shopify you can install the app directly or you can add the NitroX tracking code to your website.
\n3. Configure Key Features: Set up Consent Management, High-Intent Users, Forever Links, Live Activity Monitoring, and Contacts Management.
\n4. Start Monitoring and Optimizing: Begin exploring user data and adjusting your strategies to maximize performance.
\n\n [{"title":"NitroX - User Guide","anchor":"#nitrox-user-guide","children":[]}] html 2024-09-02T12:39:17.444Z 2024-09-09T11:20:36.317Z ckeditor en 10 10 {"js":"","css":""} 18 high-intent-users b28ba3d2d0f8f9d41adaec8beca881ffd5e151e5 High Intent Users This document describes High-Intent Users as a feature in detail f t \N
Overview:
\nThe High Intent Users feature in NitroX is designed to identify and target visitors who exhibit a high likelihood of making a purchase. By analyzing a range of user behaviors and attributes, this feature helps e-commerce businesses focus their marketing efforts on the most promising leads, resulting in improved conversion rates and return on ad spend (ROAS)
\n
\n
\n
Overview:
\nThe High Intent Users feature in NitroX is designed to identify and target visitors who exhibit a high likelihood of making a purchase. By analyzing a range of user behaviors and attributes, this feature helps e-commerce businesses focus their marketing efforts on the most promising leads, resulting in improved conversion rates and return on ad spend (ROAS)
\n
\n
\n [{"title":"NitroX - High Intent Users","anchor":"#nitrox-high-intent-users","children":[]}] html 2024-09-09T11:19:31.487Z 2024-09-16T14:30:59.078Z ckeditor en 10 10 {"js":"","css":""} 19 nitroxregressionchecklist a4a751cc4b9608f9eaebb96565f212e44f807fe5 Blackbox Regression Checklist f t \N ## NitroX Blackbox Regression Checklist:\n\n### Login Flow at NitroX\n1. Login page https://x.nitrocommerce.ai/login should be reachable.\n2. User should be able to login at the existing account.\n3. New user should be able to register as well and then login as well.\n\n### Reset Password Flow\n1. Forget password link at Login page should be reachable.\n2. User should receive reset password link at the entered email id.\n3. Reset password link should be reachable and user should be able to reset the password and login at https://x.nitrocommerce.ai/login .\n\n### Installing SuperAcquire\n1. Go to the admin panel of a new shopify store and view "settings".\n2. Select "Apps and sales channels" and go to "Shopify App Store".\n3. Search and install SuperAcquire -> User should be redirected to Nitro dashboard https://x.nitrocommerce.ai/dashboard.\n\n### Re-installing SuperAcquire\n1. Go to the admin panel of your exisiting shopify store which is already connected to SuperAcquire and view "settings".\n2. Select "Apps and sales channels" and go to "Shopify App Store".\n3. Select "unistall" option beside the SuperAcquire app -> SuperAcquire should get unistalled from the store.\n4. Select "Unistalled" section under "apps and sales channel".\n5. Install SuperAcquire app again -> User should be redirected to Nitro dashboard https://x.nitrocommerce.ai/dashboard.\n\n### Opening SuperAcquire from Shopify\n1. Go to the admin panel of your exisiting shopify store which is already connected to SuperAcquire and view "settings".\n2. Visit "Apps and sales channels"and select "SuperAcquire".\n3. Select on SuperAcquire under installed apps -> click on "Open App" -> User should be redirected to Nitro dashboard https://x.nitrocommerce.ai/dashboard .\n\n### Dashboard Flow\n1. Visit https://x.nitrocommerce.ai/dashboard -> Dashboard page should be reachable.\n2. Organisation dropdown list should be accessable.\n3. Numbers at dashboard widgets should get populated.\n\n### Live Activity Flow\n1. Page view, Category view, Product view, Addtocart, Removedfromcart and Checkout events should get populated under user live actviti for SuperAcquire.\n2. User details should get populated in case of identified user.\n\n### Discount Coupon Prefill Flow\n1. Select Discount coupon from the Consent Management tab.\n2. Discount coupon should get populated at the store.\n3. Visibility of div with id "nitroPopUpIframeContainer" should be "visible".\n4. For identified user, phone number should come prefilled in the popup.\n\n### Forever Links Flow\n1. Select Forever Links tab on NitroX/SuperAcquire dashboard\n2. Click on create link -> forever link for specified URL should get created.\n3. On clicking bin icon against the link, it should get deleted from the list.\n4. On clicking the link, destination URL should open up in default browser window.\n\n\n### Webhook Integration Flow\n1. Go to Webhook Integration under the Platform section from the Integrations tab.\n2. Enter the endpoint and select data type to be exported at webhook.\n3. For Events data type, view, product view, category view, addtocart, removedfromcart and checkout events should get exported at the endpoint, for an identified user.\n4. For Contacts data type, user email and phone should get exported at the endpoint, for an identified user.\n5. Click on Add Webhook -> new webhook should get added and user should be able to save and update it as well.\n6. On clicking Remove button, the given webhook should get deleted.\n\n\n### Contacts Flow\n1. Contacts page should be reachable and download contacts list should get populated on the page.\n2. Click on download phone/emails -> user email modal should open up.\n3. Link to contacts CSV should be emailed at the entered email id.\n4. User contacts should be available in the downloaded CSV file.\n\n\n### High Intent Users Flow\n1. High Intent Users(HIU) page should be reachable.\n2. Users abandoning carts/checkouts should get populated under HIU list after 4hrs.\n3. All identified users should get populated under the All Identified Users list.\n4. User should be able to download HIU contacts and all identified contacts via email.\n4. Masked PIN Code should be avaible for the users under user details.\n
{
\n"org_token": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"eventName": "view",
\n"eventVal": {
\n"page": "https://store.myshopify.com/",
\n"h": "store.myshopify.com",
\n"customer": {
\n"email": "email@gmail.co",
\n"phone": "+911234567890",
\n"name": "Test User"
\n}
\n},
\n"u": "https://store.myshopify.com/",
\n"lang": "en",
\n"userId": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:36:49.048055+00:00"
\n}
Data type:
\n{
\n"org_token": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"eventName": "category_view",
\n"eventVal": {
\n"page": "https://store.myshopify.com/collections/all",
\n"resource_id": null,
\n"resource": null,
\n"domain": "store.myshopify.com",
\n"h": "store.myshopify.com",
\n"customer": {
\n"email": "email@gmail.co",
\n"phone": "+911234567890",
\n"name": "Test User"
\n}
\n},
\n"u": "https://store.myshopify.com/collections/all",
\n"lang": "en",
\n"userId": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:37:09.970422+00:00"
\n}
Data Type:
\n{
\n"org_token": "97a9933c-d2aa-4018-9fcf-f59b2c4938f2",
\n"eventName": "product_view",
\n"eventVal": {
\n"page": "https://quickstart-6afbfc31.myshopify.com/products/the-multi-managed-snowboard",
\n"resource_id": 8213254668437,
\n"resource": "product",
\n"domain": "quickstart-6afbfc31.myshopify.com",
\n"price": 629.95,
\n"h": "quickstart-6afbfc31.myshopify.com",
\n"image": "https://cdn.shopify.com/s/files/1/0654/5866/7669/products/Main_9129b69a-0c7b-4f66-b6cf-c4222f18028a.jpg?v=1710241840",
\n"title": "The Multi-managed Snowboard",
\n"customer": {
\n"email": null,
\n"phone": "+911234512345",
\n"name": null
\n}
\n},
\n"u": "https://quickstart-6afbfc31.myshopify.com/products/the-multi-managed-snowboard",
\n"lang": "en",
\n"userId": "af2c5603-ac36-4722-b795-b9809a78a29b",
\n"timestamp": "2024-11-08T07:03:26.477800+00:00"
\n}
Data Type:
\n{
\n"org_token": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"eventName": "addtocart",
\n"eventVal": {
\n"line_items": [
\n{
\n"quantity": 1,
\n"title": "The Collection Snowboard: Hydrogen",
\n"line_price": "600.00",
\n"id": 45471438340248,
\n"product_id": 8498999558296,
\n"image_url": "https://cdn.shopify.com/s/files/1/0673/1264/8344/files/Main_0a40b01b-5021-48c1-80d1-aa8ab4876d3d.jpg?v=1727439260"
\n}
\n],
\n"cart_value": 600,
\n"recent_product_image": "https://cdn.shopify.com/s/files/1/0673/1264/8344/files/Main_0a40b01b-5021-48c1-80d1-aa8ab4876d3d.jpg?v=1727439260",
\n"init_cart": false,
\n"empty_cart": false,
\n"items_added": [
\n{
\n"quantity": 1,
\n"title": "The Collection Snowboard: Hydrogen",
\n"line_price": "600.00",
\n"id": 45471438340248,
\n"product_id": 8498999558296,
\n"image_url": "https://cdn.shopify.com/s/files/1/0673/1264/8344/files/Main_0a40b01b-5021-48c1-80d1-aa8ab4876d3d.jpg?v=1727439260"
\n}
\n],
\n"items_removed": [],
\n"customer": {
\n"email": "email@gmail.co",
\n"phone": "+911234567890",
\n"name": "Test User"
\n}
\n},
\n"u": "",
\n"lang": "en",
\n"userId": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:30:35.858469+00:00"
\n}
Data Type:
\n{
\n"org_token": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"eventName": "checkout",
\n"eventVal": {
\n"checkout": "https://store.myshopify.com/67312648344/checkouts/ac/Z2NwLWFzaWEtc291dGhlYXN0MTowMUo5SzhUR0dQWlhINFBQS0szRjFUS0tXRg/recover?key=c1f5094475e89c2b566ad99cda25102f&locale=en-IN",
\n"cart_value": "600.00",
\n"customer": {
\n"email": "email@gmail.co",
\n"phone": "+911234567890",
\n"name": "Test User"
\n}
\n},
\n"u": "",
\n"lang": "en",
\n"userId": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:31:53.597232+00:00"
\n}
Data Type:
\n{
\n"org_token": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"eventName": "orders-updated",
\n"eventVal": {
\n"url": "https://store.myshopify.com/67312648344/orders/7c63fe52d7f27866462aeb39bcbe0cb3/authenticate?key=a3b7a6f0c9b70015e8dc8f19445e7e8e",
\n"order_id": 1005,
\n"price": "600.00",
\n"currency": "INR",
\n"customer": {
\n"email": "email@gmail.co",
\n"phone": "+911234567890",
\n"name": "Test User"
\n}
\n},
\n"u": "",
\n"lang": "en",
\n"userId": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:35:28.646894+00:00"
\n}
Data Type:
\n{
\n"org_token": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"eventName": "orders-create",
\n"eventVal": {
\n"url": "https://store.myshopify.com/67312648344/orders/7c63fe52d7f27866462aeb39bcbe0cb3/authenticate?key=a3b7a6f0c9b70015e8dc8f19445e7e8e",
\n"order_id": 1005,
\n"price": "600.00",
\n"currency": "INR",
\n"customer": {
\n"email": "email@gmail.co",
\n"phone": "+911234567890",
\n"name": "Test User"
\n}
\n},
\n"u": "",
\n"lang": "en",
\n"userId": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:35:29.495421+00:00"
\n}
Data Type:
\n{
\n"org_token": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"eventName": "removefromcart",
\n"eventVal": {
\n"line_items": [],
\n"cart_value": 0,
\n"recent_product_image": null,
\n"init_cart": false,
\n"empty_cart": true,
\n"items_added": [],
\n"items_removed": [
\n{
\n"quantity": 2,
\n"title": "The 3p Fulfilled Snowboard",
\n"line_price": "5259.90",
\n"id": 45471438667928,
\n"product_id": 8498999853208,
\n"image_url": "https://cdn.shopify.com/s/files/1/0673/1264/8344/files/Main_b9e0da7f-db89-4d41-83f0-7f417b02831d.jpg?v=1727439260"
\n}
\n],
\n"customer": {
\n"email": "email@gmail.co",
\n"phone": "+911234567890",
\n"name": "Test User"
\n}
\n},
\n"u": "",
\n"lang": "en",
\n"userId": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:38:47.337793+00:00"
\n}
Data Type:
\n{
\n"org_token": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"eventName": "is_consented",
\n"eventVal": {
\n"phone": "+911234567890",
\n"h": "store.myshopify.com",
\n"customer": {
\n"email": "email@gmail.co",
\n"phone": "+911234567890",
\n"name": "Test User"
\n}
\n},
\n"u": "",
\n"lang": "en",
\n"userId": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:49:13.378909+00:00"
\n}
Data Type:
\n{
\n"contact": "email@gmail.co",
\n"type": "EMAIL",
\n"date": "2024-10-08",
\n"org_id": "b4656a84-f7ee-4ef0-a7cc-408cd7ba6584",
\n"name": "Test User",
\n"nitro_id": "218f7fef-56e0-4a1c-81ad-ff84c6377e22",
\n"timestamp": "2024-10-08T06:52:25.839935+00:00",
\n"identified_by": "third_party"
\n}
Data Type:
\nYou can integrate your Nitro account directly with the Shopify Custom App.
\nAn integration between Nitro and a Shopify Custom App automatically installs our scripts.











.png)
.png)




Enter your Shopify Store name under the shop section as mentioned in the placeholder. Also enter the Access Token which you saved earlier.
\nTo enable the integration click Save.
\nOnce the integration is complete, you will start receiving user live activity events for the shopify store.
\n




Note: If you currently have Nitro script on your domain, you will need to remove this before setting up the custom integration.
\n [{"title":"Integrate with Shopify (Custom App)","anchor":"#integrate-with-shopify-custom-app","children":[{"title":"What you'll need","anchor":"#what-youll-need","children":[]},{"title":"Integrating with Nitro","anchor":"#integrating-with-nitro","children":[]},{"title":"Removing the Integration","anchor":"#removing-the-integration","children":[]}]}] markdown 2024-01-25T11:30:12.926Z 2024-12-24T07:28:55.239Z markdown en 3 3 {"js":"","css":""} 14 disable-shopify-captcha 4f73c17fd1c22d5e7ceb5d101c8514171c85100b Disable Shopify Captcha f t \N # Deactivate hCAPTCHA on online store\nGoogle hCAPTCHA helps analyze the behavior of visitors to your online store to block spam from bots. Google hCAPTCHA also reduces friction for real users by eliminating captcha challenges and is enabled by default on all Shopify stores.\n\nGoogle hCAPTCHA can appear in the following locations of your online store:\n- in contact and comment forms\n- on login, create account, and password recovery pages \n\n### Following are the steps to deactivate/activate hcaptcha\n1. From your Shopify admin, go to **Online Store** > **Preferences**.\n\n\n2. In the **Spam protection** section, uncheck **Enable hCaptcha on login, create account and password recovery pages.**.\n\n\n3. Click Save.Google hCAPTCHA helps analyze the behavior of visitors to your online store to block spam from bots. Google hCAPTCHA also reduces friction for real users by eliminating captcha challenges and is enabled by default on all Shopify stores.
\nGoogle hCAPTCHA can appear in the following locations of your online store:
\nFrom your Shopify admin, go to Online Store > Preferences.
\n
In the Spam protection section, uncheck Enable hCaptcha on login, create account and password recovery pages..
\n
Click Save.
\n










Login at https://x.nitrocommerce.ai and go to the Integrations tab. Now go to "Connect with Zoho" under the Platforms section.
\nClick on "Connect with Zoho".
\nNow paste the Client ID, Client Secret, Generated Code and Layout ID which was obtained earlier.
\nSelect "ZOHO_INDIA" under the Zoho Domain dropdown and Click on save.
\nYou will see a toast notification upon successful integration.

.png)
.png)
.png)
.png)
.png)
Banner Image dimensions
\nBrand Logo Image dimensions:
\nBanner Image dimensions:
\nLogo Image dimensions:
\nLogo Image dimensions:
\nHeading Image dimensions:
\nBackground Image dimensions:
\nTo fetch data from Nitro Backend, you need the following IDs:
\n<ORGANISATION_TOKEN><PARENT><NITRO_ID>These IDs are available fron nitro.js at the client side and can be fetched in 2 ways:
\nFor example, Your nitroSettings object should look something like:
\nwindow.nitro = {\n events: {\n onIdentify: function() {\n // ...\n }\n },\n ready: function(token, parent, nitro_id) {\n // ...\n }\n},\n\nFor example:
\nnitro.ready(function(token, parent, nitro_id) {\n // send to your server to fetch data S2S\n})\n\nOnce the required information has been provided in the callback function, send a request to your backend providing these IDs. Thereafter, make a request to nitro backend to fetch the corresponding details.
\nAt server side:
\n<BEARER TOKEN> [THIS TOKEN IS SPECIFIC TO - YOUR ORGANISATION. PLEASE USE IT CAREFULLY]https://t.makehook.ws/jsv1/contact-details/<token>/< parent_id>/<nitro_id> code: 2001,\n identified_data: {\n email: < EMAIL>,\n phone: < PHONE>,\n consent_data: {\n is_phone_consented: true/false,\n is_email_consented: true/false,\n },\n message: "ok"\n [{"title":"Server-to-Server (S2S) Integration Guide","anchor":"#server-to-server-s2s-integration-guide","children":[]}] markdown 2024-11-28T12:16:16.220Z 2024-11-28T13:12:33.409Z markdown en 3 3 {"js":"","css":""}
26 s2s-last-n-events 6e5bc46c46f3ac2604a79efe1a2e18b19afea1c6 Server-to-Server Fetch Last 'N' Events f t \N # Server-to-Server (S2S) Fetch Last 'N' Events\n\n\n### What you'll need\n\n**To fetch data from Nitro Backend, you need the following IDs:**\n- token: `To fetch data from Nitro Backend, you need the following IDs:
\n<ORGANISATION_TOKEN><PARENT><NITRO_ID>These IDs are available fron nitro.js at the client side and can be fetched in 2 ways:
\nFor example, Your nitroSettings object should look something like:
\nwindow.nitro = {\n events: {\n onIdentify: function() {\n // ...\n }\n },\n ready: function(token, parent, nitro_id) {\n // ...\n }\n},\n\nFor example:
\nnitro.ready(function(token, parent, nitro_id) {\n // send to your server to fetch data S2S\n})\n\nOnce the required information has been provided in the callback function, send a request to your backend providing these IDs. Thereafter, make a request to nitro backend to fetch the corresponding details.
\nAt server side:
\n<BEARER TOKEN> [THIS TOKEN IS SPECIFIC TO - YOUR ORGANISATION. PLEASE USE IT CAREFULLY]https://t.makehook.ws/jsv1/events/<org_id>/<nitro_id>\n\nQuery Param: To fetch n-numbers of events, pass _n as query param with the desired number of events required.
\n
example:
\nhttps://t.makehook.ws/jsv1/events/<org_id>/<nitro_id>?_n=5\n\nMaximum number of 25 events are allowed, and default last 5 events are sent.
\n
{\n "code":2001,\n "events":[\n {\n "id":"<NITRO_ID>",\n "org":"<ORG_ID>",\n "event":"<EVENT_NAME>",\n "url":"<VISITED_PAGE_URL>",\n "created_at":"<DATE_CREATED_FORMAT__ISO_8601_FORMAT>",\n },\n ],\n "message":"OK",\n}\n [{"title":"Server-to-Server (S2S) Fetch Last 'N' Events","anchor":"#server-to-server-s2s-fetch-last-n-events","children":[]}] markdown 2024-12-10T08:47:34.566Z 2024-12-10T08:47:40.465Z markdown en 3 3 {"js":"","css":""}
1 home b29b5d2ce62e55412776ab98f05631e0aa96597b Documentation for Nitro f t \N \n* [Nitro Js API Integration Guide](/integration-guide)\n\n* [Shopify Custom App Installation Guide](/shopify-custom-app)\n\n* [API Integration Orbis<>Nitro](/API-integration)\n\n* [Nitro Exporting Data](/exporting-data)\n\n* [Nitro Popup](/pop-up-modal)\n\n* [Nitro API Reference](/nitro-api)\n\n* [Nitro User Guide](/en/nitrox-user-guide)\n\t* [NitroX Quick Start Guide](/en/quick-start-guide)\n * [NitroX - Consent Management](/en/consent-management)\n * [NitroX - High Intent Users](/en/high-intent-users)\n \n * [NitroX - Prefill Templates Image Dimensions](/en/prefill-image-details)\n \n* [Nitrox WordPress/WooCommerce Plugin Installation Guide](/en/wordpress-plugin)\n\n* [Nitrox Magento Plugin Installation Guide](/en/magento-plugin)\n\n* [Nitrox Event Schemas](/en/event-schemas)\n\n\n* [NitroX Blackbox Regression Checklist](/en/nitroxregressionchecklist)\n\n* [SSO Regression Checklist](/en/ssoregressionchecklist)\n\n* [Nitro<>Zoho Integration Guide](/en/nitro-zoho-integration)\n\n* [Server-to-Server(S2S) Integration Guide](/en/S2S-integration)\n\n* [Server-to-Server(S2S) Fetch Last 'N' Events](/en/s2s-last-n-events)\n \n* [DPDP Act](/en/DPDP-Act) \n\n\n \n\n