> For the complete documentation index, see [llms.txt](https://help.daasity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.daasity.com/core-concepts/data-integrations/setup-guides/digital-integrations/rockerbox/integration-specifications.md).

# Integration Specifications

## Integration Overview

Rockerbox is a marketing attribution platform that allows businesses to evaluate marketing channel effectiveness and execute better budget channel optimization. Rockerbox incorporates attribution, multi-touch attribution, halo analysis, geo lift, in-channel testing, incrementality and media mix modeling.

The Daasity Rockerbox integration allows merchants to integrate both spend and channel attribution data coming from Rockerbox.  This gives them access to marketing spend that Daasity may not have an integration for and a more complete channel attribution model. 

## **Integration Availability**

This integration is available for:

* Enterprise

## SFTP Feed

The Daasity Rockerbox extractor is built based on this [Rockerbox Reports Documentation](https://app.rockerbox.com/documentation/reports). Daasity uses an SFTP server to extract files and replicate data from Rockerbox.

{% hint style="warning" %}
You will need to contact Rockerbox to setup a feed to their SFTP server and provide Daasity with the credentials to retrieve your reports to be ingested into your account
{% endhint %}

## Entity Relationship Diagram (ERD)

[Click here to view the ERD for the Daasity Rockerbox integration](https://lucid.app/documents/embedded/68f2fb05-4349-48c3-8518-d9205097947b) illustrating the different tables and keys to join across tables.

## Rockerbox Schema

The Daasity Rockerbox extractor creates these tables using the reports and replication methods listed. The data is mapped from source SFTP file to the table based on the mapping logic outlined in each table.

* [Spend Report](#spend-report)
* [Buckets Breakdown](#buckets-breakdown)
* [MTA with UTM](#mta-with-utm)

### **Spend Report**

* Endpoint: [Reports](https://app.rockerbox.com/documentation/reports)
* Update Method: UPSERT
* Table Name: \[`rockerbox.spend_report`]

| CSV Header                             | Database Column       |
| -------------------------------------- | --------------------- |
| date                                   | report\_date          |
| platform                               | platform              |
| tier\_1                                | tier\_1               |
| tier\_2                                | tier\_2               |
| tier\_3                                | tier\_3               |
| tier\_4                                | tier\_4               |
| tier\_5                                | tier\_5               |
| tier\_one                              | tier\_one             |
| tier\_two                              | tier\_two             |
| tier\_three                            | tier\_three           |
| tier\_four                             | tier\_four            |
| tier\_five                             | tier\_five            |
| tier\_one\_alt                         | tier\_one\_alt        |
| tier\_two\_alt                         | tier\_two\_alt        |
| tier\_three\_alt                       | tier\_three\_alt      |
| tier\_four\_alt                        | tier\_four\_alt       |
| tier\_five\_alt                        | tier\_five\_alt       |
| spend\_assignment\_id                  | spend\_assignment\_id |
| spend                                  | spend                 |
| imps                                   | impressions           |
| clicks                                 | clicks                |
| Daasity: source\_id                    | \_\_source\_id        |
| Daasity: MD5(object)                   | \_\_sync\_key         |
| Daasity: timestamp when loaded into DB | \_\_synced\_at        |
| Daasity: account\_id                   | \_account\_id         |

### **Buckets Breakdown**

* Endpoint: [Reports](https://app.rockerbox.com/documentation/reports)
* Update Method: UPSERT
* Table Name: \[`rockerbox.buckets_breakdown`]

| CSV Header                                                                                                                         | Database Column            |
| ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| date                                                                                                                               | date                       |
| tier\_1                                                                                                                            | tier\_1                    |
| tier\_2                                                                                                                            | tier\_2                    |
| tier\_3                                                                                                                            | tier\_3                    |
| tier\_4                                                                                                                            | tier\_4                    |
| tier\_5                                                                                                                            | tier\_5                    |
| first\_touch                                                                                                                       | first\_touch               |
| ntf\_first\_touch                                                                                                                  | ntf\_first\_touch          |
| revenue\_first\_touch                                                                                                              | revenue\_first\_touch      |
| ntf\_revenue\_first\_touch                                                                                                         | ntf\_revenue\_first\_touch |
| last\_touch                                                                                                                        | last\_touch                |
| ntf\_last\_touch                                                                                                                   | ntf\_last\_touch           |
| revenue\_last\_touch                                                                                                               | revenue\_last\_touch       |
| ntf\_revenue\_last\_touch                                                                                                          | ntf\_revenue\_last\_touch  |
| even                                                                                                                               | even                       |
| ntf\_even                                                                                                                          | ntf\_even                  |
| revenue\_even                                                                                                                      | revenue\_even              |
| ntf\_revenue\_even                                                                                                                 | ntf\_revenue\_even         |
| normalized                                                                                                                         | normalized                 |
| ntf\_normalized                                                                                                                    | ntf\_normalized            |
| revenue\_normalized                                                                                                                | revenue\_normalized        |
| ntf\_revenue\_normalized                                                                                                           | ntf\_revenue\_normalized   |
| spend                                                                                                                              | spend                      |
| Daasity: source\_id                                                                                                                | \_\_source\_id             |
| Daasity: MD5(tier\_1 + tier\_2 + tier\_3 + tier\_4 + tier\_5 + first\_touch + last\_touch + even + normalize + normalized + spend) | \_\_sync\_key              |
| Daasity: timestamp when loaded into DB                                                                                             | \_\_synced\_at             |
| Daasity: account\_id                                                                                                               | \_account\_id              |

### **MTA with UTM**

* Endpoint: [Reports](https://app.rockerbox.com/documentation/reports)
* Update Method: UPSERT
* Table Name: \[`rockerbox.mta_with_utm`]

| CSV Header                                    | Database Column       |
| --------------------------------------------- | --------------------- |
| uid                                           | uid                   |
| date                                          | date                  |
| conversion\_count                             | conversion\_count     |
| onsite\_min                                   | onsite\_min           |
| hash\_ip\_conv                                | hash\_ip\_conv        |
| conversion\_hash\_id                          | conversion\_hash\_id  |
| timestamp\_conv                               | timestamp\_conv       |
| onsite\_count                                 | onsite\_count         |
| event\_id                                     | event\_id             |
| timestamp\_events                             | timestamp\_events     |
| total\_events                                 | total\_events         |
| sequence\_number                              | sequence\_number      |
| original\_url                                 | original\_url         |
| request\_referrer                             | request\_referrer     |
| matches                                       | matches               |
| tier\_1                                       | tier\_1               |
| tier\_2                                       | tier\_2               |
| tier\_3                                       | tier\_3               |
| tier\_4                                       | tier\_4               |
| tier\_5                                       | tier\_5               |
| normalized                                    | normalized            |
| total\_weight                                 | total\_weight         |
| revenue                                       | revenue               |
| external\_id                                  | external\_id          |
| base\_id                                      | base\_id              |
| email                                         | email                 |
| conversion\_key                               | conversion\_key       |
| action                                        | action                |
| first\_touch                                  | first\_touch          |
| revenue\_first\_touch                         | revenue\_first\_touch |
| last\_touch                                   | last\_touch           |
| revenue\_last\_touch                          | revenue\_last\_touch  |
| even                                          | even                  |
| revenue\_even                                 | revenue\_even         |
| revenue\_normalized                           | revenue\_normalized   |
| utm\_medium                                   | utm\_medium           |
| utm\_source                                   | utm\_source           |
| utm\_campaign                                 | utm\_campaign         |
| Daasity: source\_id                           | \_\_source\_id        |
| Daasity: MD5(date + event\_id + external\_id) | \_\_sync\_key         |
| Daasity: timestamp when loaded into DB        | \_\_synced\_at        |
| Daasity: account\_id                          | \_account\_id         |