> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# RetailNext Connector

## Intro

RetailNext is a leading provider of in-store analytics. The RetailNext connector allows you to bring in all kinds of data, from foot traffic to total transaction count, about your store. It also provides data from locations, times and days to fuel complicated analysis. To learn more about the RetailNext API, visit their page ([https://retailnext.atlassian.net/wik.../174817482/API](https://retailnext.atlassian.net/wiki/spaces/PUBLICDOCS/pages/174817482/API "https://retailnext.atlassian.net/wiki/spaces/PUBLICDOCS/pages/174817482/API") ).

You connect to your RetailNext account in the Data Center. This topic discusses the fields and menus that are specific to the RetailNext connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your RetailNext account and create a DataSet, you must have the following:

* Your RetailNext Secret key
* Your RetailNext Subscription
* Your RetailNext Access key

To obtain these credentials, reach out to your RetailNext account representative.

## Connecting to Your RetailNext Account

This section enumerates the options in the **Credentials** and **Details** panes in the RetailNext Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Credentials Pane

This pane contains fields for entering credentials to connect to your RetailNext account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Secret Key </p></td><td colspan="1" rowspan="1"><p> Please provide your account's secret key for your API token. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Subscription </p></td><td colspan="1" rowspan="1"><p> Please provide your account's subscription (https\://\[subscription].api.retailnext.net...) </p></td></tr><tr><td colspan="1" rowspan="1"><p> Access Key </p></td><td colspan="1" rowspan="1"><p> Please provide your account's access key for your API token. </p></td></tr></tbody></table>

Once you have entered valid RetailNext credentials, you can use the same account any time you go to create a new RetailNext DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](https://domo-support.domo.com/s/article/360042926054?language=en_US "Managing User Accounts for Connectors").

## Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the RetailNext report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p><b> Report Name </b></p></td><td colspan="1" rowspan="1"><p><b> Description </b></p></td></tr><tr><td colspan="1" rowspan="1"><p> Average Age </p></td><td colspan="1" rowspan="1"><p> Returns the average age of shoppers who enter the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Avg Dwell Time </p></td><td colspan="1" rowspan="1"><p> Returns the average amount of time shoppers stand in a specified dwell zone. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Avg Transaction Value (ATV) </p></td><td colspan="1" rowspan="1"><p> Returns the average net sales amount per transaction. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Average Unit Retail (AUR) </p></td><td colspan="1" rowspan="1"><p> Returns the average net sales amount per item sold. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Avg Units per Transaction (UPT) </p></td><td colspan="1" rowspan="1"><p> Returns the average number of items purchased per transaction. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Conversion Rate </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of shoppers visiting the store who make a purchase. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Dwell Conversion Rate </p></td><td colspan="1" rowspan="1"><p> Percentage of shoppers dwelling in a location who purchase an item from that location. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Dwells </p></td><td colspan="1" rowspan="1"><p> Returns the number of shoppers who stand in a specified dwell zone for longer than a defined minimum amount of time. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Engagement Rate </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of shoppers walking by a location who stop at that location. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Exposure Rate </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of shoppers who walk by a specific location as compared to the total store traffic. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Female Average Age </p></td><td colspan="1" rowspan="1"><p> Returns the average age of female shoppers who enter the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Female Percentage </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of shoppers who are female. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Guest Wi-Fi Uptake </p></td><td colspan="1" rowspan="1"><p> Returns the ratio of wi-fi users to detected devices in the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Labor Hours </p></td><td colspan="1" rowspan="1"><p> Returns the total number of hours worked by staff members. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Male Average Age </p></td><td colspan="1" rowspan="1"><p> Returns the average age of male shoppers who enter the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Male Percentage </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of shoppers who are male. </p></td></tr><tr><td colspan="1" rowspan="1"><p> MDD Capture Rate </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of people passing by the store who enter the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Mobile Device Detection Rate </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of shoppers who enter the store with a detected mobile device. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Net Items </p></td><td colspan="1" rowspan="1"><p> Returns the number of items sold after subtracting returns for a specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Net Transactions Value </p></td><td colspan="1" rowspan="1"><p> Returns the net transactions value. </p></td></tr><tr><td colspan="1" rowspan="1"><p> New Guest Wi-Fi Users </p></td><td colspan="1" rowspan="1"><p> Returns the number of wi-fi users enrolling for the first time during a specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> New Shopper % </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of shoppers visiting the store for the first time. </p></td></tr><tr><td colspan="1" rowspan="1"><p> New Shoppers </p></td><td colspan="1" rowspan="1"><p> Returns the number of new shoppers in the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Number of Visits (non-unique) </p></td><td colspan="1" rowspan="1"><p> Returns the total number of visits to your store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Passby Traffic </p></td><td colspan="1" rowspan="1"><p> Returns the number of people who walk by the store, including those who enter. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repeat Guest Wi-Fi Users </p></td><td colspan="1" rowspan="1"><p> Returns the number of unique wi-fi users who did not enroll for the first time during a specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repeat Shopper % </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of shoppers who have visited the store before today. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Repeat Shoppers </p></td><td colspan="1" rowspan="1"><p> Returns the number of repeat shoppers. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Return Amount </p></td><td colspan="1" rowspan="1"><p> Returns your net return amount. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Return Items Count </p></td><td colspan="1" rowspan="1"><p> Returns the total number of returned items. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Return Transactions </p></td><td colspan="1" rowspan="1"><p> Returns the total number of return transactions for a specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Return Transactions Value </p></td><td colspan="1" rowspan="1"><p> Returns the total value of your return transactions. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sales </p></td><td colspan="1" rowspan="1"><p> Returns the sales amount for the store, rounded. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sales Amount </p></td><td colspan="1" rowspan="1"><p> Returns the total sales amount for the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sales Items Count </p></td><td colspan="1" rowspan="1"><p> Returns the total number of sales items. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sales Per Square Unit </p></td><td colspan="1" rowspan="1"><p> Returns the net sales per square unit of space. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sales Transactions </p></td><td colspan="1" rowspan="1"><p> Returns the total number of sales transactions for a specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sales Transactions Values </p></td><td colspan="1" rowspan="1"><p> Returns the total value of sales transactions. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Shoppers Per Labor Hour </p></td><td colspan="1" rowspan="1"><p> Returns the ratio of shoppers who entered the store to labor hours. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Shopper Yield </p></td><td colspan="1" rowspan="1"><p> Returns the average net sale amount for each shopper visiting the store within a specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p><span> Staff Count </span></p></td><td colspan="1" rowspan="1"><p> Returns the number of staff members present in the store per hour. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Staff Productivity </p></td><td colspan="1" rowspan="1"><p> Returns the net sales per staff hour. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Staff Traffic In </p></td><td colspan="1" rowspan="1"><p> Returns the number of staff members who walk into the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Staff Traffic Out </p></td><td colspan="1" rowspan="1"><p> Returns the number of staff members who walk out of the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Total Guest Wi-Fi Users </p></td><td colspan="1" rowspan="1"><p> Returns the number of unique wi-fi users for a specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Total Transactions Count </p></td><td colspan="1" rowspan="1"><p> Total number of sales and return transactions for a specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Traffic In </p></td><td colspan="1" rowspan="1"><p> Number of shoppers who walk into the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Traffic Out </p></td><td colspan="1" rowspan="1"><p> Number of staff members who walk out of the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Transactions per Square Unit </p></td><td colspan="1" rowspan="1"><p> Returns the total number of sales transactions per square unit of space. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Unique Passby Traffic </p></td><td colspan="1" rowspan="1"><p> Returns the number of individual shoppers who walk by the store (each person is counted only once for the date range selected). </p></td></tr><tr><td colspan="1" rowspan="1"><p> Unique Traffic </p></td><td colspan="1" rowspan="1"><p> Returns the number of individual shoppers who enter the store (each person is counted only once for the date range selected). </p></td></tr><tr><td colspan="1" rowspan="1"><p> Unique Wireless Events Detected Inside </p></td><td colspan="1" rowspan="1"><p> Returns the unique wireless events detected in the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Unique Wireless Passby Events </p></td><td colspan="1" rowspan="1"><p> Returns the number of unique wireless passby events. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Video Capture Rate </p></td><td colspan="1" rowspan="1"><p> Percentage of people passing by the store who enter the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Video Passby Traffic </p></td><td colspan="1" rowspan="1"><p> Number of people who walk by the store, including those who enter the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Visit Duration </p></td><td colspan="1" rowspan="1"><p> Average amount of time shoppers spend inside the store. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Visit Frequency </p></td><td colspan="1" rowspan="1"><p> Returns the average number of times a shopper enters the store within a specified time period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Wireless New Visitors </p></td><td colspan="1" rowspan="1"><p> Returns the number of new wireless devices. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Wireless New Visitors Rate </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of new wireless devices. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Wireless Passby Capture Rate </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of unique wireless passby events. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Wireless Passby Events </p></td><td colspan="1" rowspan="1"><p> Returns the number of wireless passby events. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Wireless Repeat Visitors </p></td><td colspan="1" rowspan="1"><p> Returns the number of repeat wireless devices. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Wireless Repeat Visitors Rate </p></td><td colspan="1" rowspan="1"><p> Returns the percentage of repeat wireless devices. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Wireless Visit Frequency </p></td><td colspan="1" rowspan="1"><p> Returns the wireless visit frequency. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Locations </p></td><td colspan="1" rowspan="1"><p> Select at least one location to return information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the first date in your date range is a specific or relative date. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the second date in your date range is a specific or relative date. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Start Date </p></td><td colspan="1" rowspan="1"><p> Select the first date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific End Date </p></td><td colspan="1" rowspan="1"><p> Select the second date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to Start From </p></td><td colspan="1" rowspan="1"><p> Enter the number of the farthest day back that should be represented in the report. Combine with <b> Days Back to End At </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to End At </p></td><td colspan="1" rowspan="1"><p> Enter the number of the most recent day back that should be represented in the report. Combine with <b> Days Back to Start From </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Choose Time </p></td><td colspan="1" rowspan="1"><p> Select whether you want your report to show data for hours in which your store is open or specific hours you choose. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Choose Start Time </p></td><td colspan="1" rowspan="1"><p> Select the desired start time for the data in your report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Choose End Time </p></td><td colspan="1" rowspan="1"><p> Select the desired end time for the data in your report. </p></td></tr></tbody></table>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## FAQs

<AccordionGroup>
  <Accordion title="How frequently will my data update?">
    As often as needed.
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    No.
  </Accordion>
</AccordionGroup>
