
The tray.io Adroll connector allows you to manage deliveries in Adroll.

## Authentication

When using the Adroll connector, the first thing you will have to do is click on 'New Authentication' in the step editor:

![add-auth](../../../../../images/add-auth.png)

On the following page proceed to allow Tray access to your account.

## Example

In this example we will build a simple workflow to retrieve a list of domain deliveries from an AdRoll account.

Create a new workflow with a **Manual Trigger**, and add a step from the **AdRoll** connector, with the operation set to **List domain deliveries**. Add two Breakdowns, the first one set to "Entity" and the second set to "Summary". Select an _Advertisable EID_ from the dropdown list. Set the _Past days_ parameter to a number sufficiently high to capture results. In this case we set the number to 300:

![adroll-list-domain-deliveries](adroll-list-domain-deliveries.png)

The output will be an object with both "Summary" and "Entity" properties.


add-auth.png

adroll-list-domain-deliveries.png

adroll

list_currencies_ddl

List currencies DDL

list_advertisables_ddl

List advertisables DDL 

Creates an advertisible in your AdRoll account.

The ISO‌-3166 2-Letter country code the company is based in. This field is used to handle data collection policies in different countries. If left blank, we will apply our most conservative rules.

Country code

Name

The EID of the organization who will own this advertisable. You need to own this organization.

Organization ID

The advertisable’s specified product or brand.

Product name

Whether or not the created advertisable should be your new default advertisable.

Set as default

create_advertisible

Create advertisible

Fetches the campaigns associated with an advertisable based on the given filters.

The EID of the advertisable whose campaigns are to be fetched.

Advertisable

Only campaigns whose status is not one of these will be returned.

Status

Blacklist statuses

If True, only active campaigns will be returned, and vice versa.

Is active

Only campaigns that match one of these statuses will be returned.

Statuses

Only campaigns that match one of these types will be returned.

Type

Types

list_advertisable_campaigns

List advertisable campaigns

list_advertisable_campaigns_ddl

List advertisable campaigns DDL

get_advertisable

Get advertisable

Fetches the adgroups associated with an advertisable based on the given filters.

The EID of the advertisable whose adgroups are to be fetched.

Campaign is active

Campaign blacklist statuses

Campaign statuses

Campaign types

list_advertisable_adgroups

List advertisable adgroups

Fetches the ads associated with an advertisable based on the given filters.

Only ads having the specified height will be returned.

Height

If True, Facebook ads will be included; if False, Facebook ads will be excluded.

Include Facebook

If True, only active ads will be returned, and vice versa.

Only ads that match one of these statuses will be returned.

Only ads that match one of these types will be returned.

Only ads having the specified width will be returned.

Width

list_advertisable_ads

List advertisable ads

list_advertisable_ads_ddl

List advertisable ads DDL

list_advertisable_adgroups_ddl

List advertisable adgroups DDL

Ad EIDS

Adgroup EIDs

Advertisable EID

List of breakdowns. Must be at least one of entity, date, summary.

Breakdown

Breakdowns

Three-letter currency code, in uppercase Default: USD.

Currency

Domain

Domains

End date

Equivalent to setting *End date* to today (exclusive) and *Start date*to (today - past_days). Takes precedence over *Start date* and *End date*.

Past days

Start date

list_domain_deliveries

List domain deliveries

Fetches the advertisables associated with an organization.

The EID of the organization. Defaults to your organization.

Organization

list_advertisables

List advertisables

Gets information about the organization you have connected to your Tray account.

The EID of the organization to retrieve. Defaults to your organization.

list_ads

Get organization info

Ad EIDs

Campaign EIDs

End of the date range (exclusive). Either set Start date and End date, or Past days.

Equivalent to setting *End date* to today (exclusive) and *Start date* to (today - *Past days*). Takes precedence over *Start date* and *End date*. Either set Start date and End date, or Past days.

Start of the date range (inclusive). Either set Start date and End date, or Past days.

list_adgroup_deliveries

List adgroup deliveries

Adroll

Created new operations: LIst domain deliveries, List deliveries for an adgroup, List advertisables.

Adroll

Overview

Authentication

Example

All Operations