> ## 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.

# AD EBiS REST Connector

## Intro

AD EBiS is one of the largest advertising analytics platforms in Japan. Use Domo's AD EBiS REST connector to gather data about impressions, clicks, and conversions.

You can connect to your AD EBiS REST account in the Data Center. This topic discusses the fields and menus that are specific to the AD EBiS REST connector user interface. To add DataSets, set update schedules, and edit DataSet information, see [Adding a DataSet Using a Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").

## Prerequisites

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

* Refresh Token

**Note:** You can contact the AD EBiS support desk to obtain your refresh token.

## Connecting to Your AD EBiS REST Account

This section enumerates the options in the **Credentials** and **Details** panes on the AD EBiS REST Connector page. The components of the other panes on this page, **Scheduling**, and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in great detail in [Adding a DataSet Using a Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").

## Credentials Pane

This pane contains fields for entering credentials to connect to your AD EBiS REST account. For information about obtaining these credentials, see the Prerequisites section. 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" valign="top"><p> Refresh Token </p></td><td colspan="1" rowspan="1" valign="top"><p> Enter your refresh token created on AD EBiS. </p><p> You can contact the AD EBiS support desk to obtain your refresh token. </p></td></tr></tbody></table>

Once you have entered valid AD EBiS REST credentials, you can use the same account at any time to create a new AD EBiS REST DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector Accounts](/s/article/360042926054 "Manage Connector Accounts").

## Details Pane

This pane contains a primary **Report** menu, along with other menus which may appear depending on the selected report type.

<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 AD EBiS REST report you want to run. The following reports are available: </p><p /><table border="1"><tbody><tr><td colspan="1" rowspan="1"><b> Report Name </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> Detail Analysis </td><td colspan="1" rowspan="1"> Detailed analysis reports provide the finest granularity of measurement data for detailed measure evaluation. <br /> In the "Ad" channel, measurement results can be obtained in units of ad IDs, so that you can analyze the measures taken by the units for which the submission URLs have been set. <br /> In the "All Traffic" channel, measurement results are obtained for all traffic, including traffic other than ads (natural search, direct, external links), so that you can compare organic and advertising results, or use a filter to obtain results for specific channels. </td></tr><tr><td colspan="1" rowspan="1"><p> Conversion Attributes </p></td><td colspan="1" rowspan="1"> The Conversion Attributes Report enables you to obtain attribute information such as member ID and sales amounts for converted users. This report can be used to obtain attribute information in conjunction with the advertisements (channels) that were contacted before the conversion, This information can also be used to analyze trends, such as what types of products each media is good at inducing purchases of. </td></tr><tr><td colspan="1" rowspan="1"><p> LPO - By Link </p></td><td colspan="1" rowspan="1"> LPO ad measurement data can be obtained for each link URL. You can analyze which URLs contribute most to conversions, and use this information to optimize your landing pages. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Channel </p></td><td colspan="1" rowspan="1"><div /><p> This field becomes available if the report is Detail Analysis or Conversion Attributes. </p><p> You can just select the type of traffic you want to query. </p><p><b> Ad </b>: Returns the data about ad channel traffic. </p><p><b> All Traffic </b>: Returns the data about all channels (Ad clicks, Organic searches, direct and referrals). </p></td></tr><tr><td colspan="1" rowspan="1"><p> Dimensions </p></td><td colspan="1" rowspan="1"><p> This field becomes available if the report is Detail Analysis or LPO – By Link. </p><p> Select the dimensions you want to use in aggregation. The selected dimensions are also used as columns in the report. </p><p> If the report is “Detail Analysis”, “Ad ID” and “Ad Name”, it will be automatically selected. If the channel is “All Traffic”, then “Media type” will also be selected. </p><p> If the report is “LPO – By Link”, “Link URL” it will be selected automatically. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Metrics </p></td><td colspan="1" rowspan="1"><p> You can select the metrics you want to obtain as the columns of the report. <br /> If the report is “Conversion Attributes”, then “Conversion name” will be automatically selected. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Conversion Ids </p></td><td colspan="1" rowspan="1"><p> Enter the IDs for conversions for which you want to retrieve the data, separated by commas. For example 1,2,3. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Device Type </p></td><td colspan="1" rowspan="1"><p> You can just select the device type of the traffic for which you want to retrieve data. If you don't select, all device types will be covered. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Ad Group 1 IDs </p></td><td colspan="1" rowspan="1"><div><p> Enter the IDs for Ad Group 1 for which you want to retrieve the data, separated by commas. For example 1,2,3. </p></div></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Ad Group 2 IDs </p></td><td colspan="1" rowspan="1"><div><p> Enter the IDs for Ad Group 2 for which you want to retrieve the data, separated by commas. For example 1,2,3. </p></div></td></tr><tr><td colspan="1" rowspan="1"><p> Media IDs </p></td><td colspan="1" rowspan="1"><div><p> Enter the IDs for the media, for which you want to retrieve the data, separated by commas. For example 1,2,3. </p></div></td></tr><tr><td colspan="1" rowspan="1"><p> Ad ID </p></td><td colspan="1" rowspan="1"><div><div /><div> Select how you want to compare the entered value to the value in the field and then enter the IDs of ads for which you want to retrieve the data using the <b> Value </b> field, separated by commas. </div><p> For example, sample1, sample2, sample3. </p></div></td></tr><tr><td colspan="1" rowspan="1"><p> Ad name </p></td><td colspan="1" rowspan="1"><div><div><div /><div> Select how you want to compare the entered value to the value in the field, and then enter the names of ads for which you want to retrieve the data using the <b> Value </b> field, separated by commas. </div> For example, 70%off, summer campaign. </div></div></td></tr><tr><td colspan="1" rowspan="1"><p> Ad note </p></td><td colspan="1" rowspan="1"><div><div><div><div /><div> Select how you want to compare the entered value to the value in the field, and then enter the notes of the ads for which you want to retrieve the data using the <b> Value </b> field, separated by commas. </div> For example, campaign 2024, winter campaign. </div></div></div></td></tr><tr><td colspan="1" rowspan="1"><p> Link URL </p></td><td colspan="1" rowspan="1"><div><div><div><div><div> Select how you want to compare the entered value to the value in the field, and then enter the link URL for which you want to retrieve the data using the <b> Value </b> field, separated by commas. </div> For example, /campaign001, /product-200/page1. </div></div></div></div></td></tr><tr><td colspan="1" rowspan="1"><p> Landing Page URL </p></td><td colspan="1" rowspan="1" valign="top"><p> Select how you want to compare the entered value to the value in the field, and then enter the landing page URL for which you want to retrieve the data using the <b> Value </b> field, separated by commas. </p><p> For example, /campaign001, /product-200/page1. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Agency IDs </p></td><td colspan="1" rowspan="1"><div> Enter the IDs of the agencies for which you want to retrieve the data, separated by comma. For example, 132, 230, 240. </div></td></tr><tr><td colspan="1" rowspan="1"><p> User name </p></td><td colspan="1" rowspan="1"><div><div><p> This field becomes available if the report is Detail Analysis or Conversion Attributes. <b /></p><p> Select how you want to compare the entered value to the value in the field, and then enter the user name for which you want to retrieve data using the <b> Value </b> field, separated by commas. </p></div> For example, user2298.110384612, user212011.88719382. </div></td></tr><tr><td colspan="1" rowspan="1"><p> User ID </p></td><td colspan="1" rowspan="1"><div><div><div><p> This filed becomes available if the report is “Conversion Attributes”. <b /></p><p> Select how you want to compare the entered value to the value in the field, and then enter the IDs of the users for whom you want to retrieve the data using the <b> Value </b> field, separated by commas. </p></div><p> For example, uvhk53ohra.7jrus8g853, tl1fhqkx4h. </p></div></div></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Minimum amount </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Detail Analysis” or “Conversion Attributes”. </p><p> Enter the minimum sales amount for which you want to retrieve the data. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Maximum amount </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Detail Analysis” or “Conversion Attributes”. </p><p> Then enter the maximum sales amount for which you want to retrieve the data. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Item 1-5 </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Detail Analysis” or “Conversion Attributes”. </p><p> Select how you want to compare the entered value to the value in the field, and then enter the values of the items field for which you want to retrieve data using the <b> Value </b> field, separated by commas. </p><p> For example, Japan, US. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Contact History </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Conversion Attributes”. </p><p> Select the contact histories for which you want to retrieve the data. The ads, search word, display channel or landing page URL must be specified together. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Page ID </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Conversion Attributes”. </p><p> Select how you want to compare the entered value to the value in the field, and then enter the IDs of the pages for which you want to retrieve the data using the <b> Value </b> field, separated by commas. </p><p> For example, 323,9991. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Page title </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Conversion Attributes”. </p><p> Select how you want to compare the entered value to the value in the field, and then enter the titles of the pages for which you want to retrieve the data using the <b> Value </b> field, separated by commas. </p><p> For example, Registration, Product Detail. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Channel access type </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Detail Analysis” or “Conversion Attributes”. Select the channel access type for which you want to retrieve the data. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Display channel </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Detail Analysis” or “Conversion Attributes”. </p><p> Select the display channel for which you want to retrieve the data. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Search word </p></td><td colspan="1" rowspan="1" valign="top"><p> This filed becomes available if the report is “Detail Analysis” or “Conversion Attributes”. </p><p> Select how you want to compare the entered value to the value in the field, and then enter the search words for which you want to retrieve the data using the <b> Value </b> field, separated by commas. </p><p> For example, Bag, T-Shirt. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Duration </p></td><td colspan="1" rowspan="1" valign="top"><p> Select whether you want to pull data for a specific date or a date range. </p><p><b> Single Date: </b> Select the specific or relative single date. </p><p><b> Date Range: </b> Select the specific or relative date range. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Report Date </p></td><td colspan="1" rowspan="1" valign="top"> Select the Date Type from the following, if the report data is for a specific date or for a relative number of days back from today: <p><b> Relative: </b> Enter the number of days back for which you want to get the data using the <b> Days Back </b> field. Specify either today or 0, yesterday or 1, or today-7 or 7 to get the data for 7 days into the past. </p><p><b> Specific: </b> Select the specific date by the <b> Select Specific Date </b> field. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> Start Date </p></td><td colspan="1" rowspan="1" valign="top"><p> Select the <b> Date Type </b> from the followings: </p><p><b> Relative: </b> Enter the number of days back for which you want to get the data from (start day). Combine with the <b> End Date </b> to create a range of represented days. <br /><br /> For example, if you enter10 for the <b> Start Date </b> and 5 for the <b> End Date </b>, then the report would contain data for 10 days ago up until 5 days ago. </p><p><b> Specific: </b> Select the specific date by the <b> Select Specific Start Date </b> field. </p></td></tr><tr><td colspan="1" rowspan="1" valign="top"><p> End Date </p></td><td colspan="1" rowspan="1" valign="top"><p> Select the <b> Date Type </b> from the followings: </p><p><b> Relative: </b> Enter the number of days back for which you want to get the data (end day). Combine with the Start Date to create a range of represented days. <br /><br /> For example, if you enter 10 for the <b> Start Date </b> and 5 for the <b> End Date </b>, then the report would contain data from 10 days ago up until 5 days ago. </p><p><b> Specific: </b> Select the specific date by the <b> Select Specific End Date </b> field. </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 Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").
