Setting up an
This guide explains how to set up an data source or destination.
to aIntroduction
-
What is an
? -
An Adverity access to a data source or a destination. You need to create an to collect data and load it into external destinations. You can use one to create multiple datastreams and destinations.
gives -
What do I need to create an
? -
To set up an data source and destination. If you do not have credentials to create an , you can ask someone else to create an for you.
, you need to provide valid credentials, such as a username and password, or an API Key, for example. The credentials required differ for each -
Most give sAdverity access to multiple items that are linked to the , such as accounts or profiles. In Adverity, these items are known as Billing Objects. When you create an , you choose which Billing Objects Adverity can access.
If an Billing Objects you want to give Adverity access to, this means that the only grants Adverity access to a single item, for example a single account.
does not ask you to select the -
Who can use an
that I create? -
An workspace in which it was created, and any child workspaces belonging to this workspace. This means that all users with access to these workspaces can use the to collect or load data.
is available to use in the
Creating an
Using your own credentials to create an
If you have valid credentials for the data source or destination you want to authorize Adverity to access, follow these steps:
-
Select the workspace you work with in Adverity and then, in the , click .
-
In the top right corner of the page, click + Create .
-
Search for and click the data source or destination for which you want to create an .
-
Click Access using your credentials.
-
Use your credentials to create the
:-
For some Next and then enter the required credentials (for example, a username and password).
s, click -
For some Adverity.
s, you will be taken to a login page where you can enter your credentials to authorize
-
-
If you are creating an data source with Billing Objects, choose which Billing Objects Adverity can access using this :
for a-
Grant access to all Billing Objects, including those created in the future - Select this option to allow Adverity to access all Billing Objects associated with the credentials you have used. Adverity will also have access to all associated Billing Objects created in the future.
-
Select specific Billing Objects to which you want to grant access - Select this option to only allow Adverity to access the Billing Objects you choose in this step. You will need to grant Adverity access to any associated Billing Objects that are created in the future.
-
-
Click Confirm.
As a result, the Managing authorizations.
is set up and you are taken to the overview page. For more information about updating, deleting and synchronizing s, seeImportant information about Billing Objects
If you use your credentials to grant Adverity access to a connector, all the Billing Objects available to you using your credentials will be visible in the page to all Adverity users with permission to edit this .
If someone else uses their credentials to grant Adverity access to a connector, the same applies to the Billing Objects available using their credentials.
This is important to consider if you do not want all Adverity users with permission to edit the to be able to see the details of the Billing Objects. For more information about user permissions, see Managing user permissions.
Asking someone else to create an
If you do not have the required credentials for the data source or destination you want to authorize Adverity to access, you can ask someone else to create an for you. The person you ask then needs to follow the steps set out in Responding to an authorization request below.
To ask someone else to create an
for you, follow these steps:-
Select the workspace you work with in Adverity and then, in the , click .
-
In the top right corner of the page, click + Create .
-
Search for and click the connector or destination for which you want to create an .
-
Click Access using someone else's credentials.
-
Click Next.
-
Fill in the following fields:
-
Email
-
Enter the email address of the person you want to ask to create the
. -
Authorizations added
-
(Optional) Rename the
that you want the recipient to create. -
(Optional) Ask the recipient to create additional data sources or destinations:
s to different-
Click + Add more . s
-
In the Add window, search for and click the data source or destination for which you want an .
-
Click Add .
-
-
Message
-
(Optional) In the Message field, change the email message.
Do not remove the
{{links}}
placeholder from the message field. The recipient needs these links to create the s. -
Notification email
-
(Optional) Enter any email addresses that you want to receive a notification when the
has been created.
-
-
Click Send access request.
As a result, an email is sent to the email address in the Email field to request the or s for you.
page with the status Access pending. If a pending is not authorized within 7 days, it will expire. Click next to a pending to see when it will expire.
The person granting the request will need to choose which Billing Objects Adverity can access. If the data source has a lot of Billing Objects, it may take a long time for the Billing Objects objects to load before the recipient can create the .
After the Notification email field. You can then use this to collect data from the corresponding data source or load data into the corresponding destination.
has been granted, an email notification will be sent to the email addresses you entered in theResponding to an request
If you receive an Adverity Request email, an Adverity user has asked you to give Adverity access to a data source. To grant this , follow these steps:
-
Click the link in the email. This link is the name that the user who sent the request has given the
. -
Use your credentials to create the
:-
For some Adverity platform and asked to enter the required credentials (for example, a username and password).
s, you will be taken to the -
For some data source where you can enter your credentials to authorize Adverity.
s, you will be taken to a login page for the corresponding
-
-
If this data source has Billing Objects, choose which Billing Objects Adverity can access using this . For more information, see What are Billing Objects? and Important information about Billing Objects. Select one of the following options:
-
Grant access to all Billing Objects, including those created in the future - Select this option to allow Adverity to access all Billing Objects associated with the credentials you have used. Adverity will also have access to all associated Billing Objects created in the future.
-
Select specific Billing Objects to which you want to grant access - Select this option to only allow Adverity to access the Billing Objects you choose in this step. You will need to grant Adverity access to any associated Billing Objects that are created in the future.
-
-
Click Authorize.
As a result, you have granted Adverity access to the data source or destination using your credentials. This can now be used to create datastreams to fetch data from this data source or load data into this destination.
Video guide: How to set up Adverity
s inThis video guide explains how to create Adverity using your own credentials, and by asking someone else to create the using their credentials.
s in