# 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.&#x20;

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.daasity.com/core-concepts/data-integrations/setup-guides/digital-integrations/rockerbox/integration-specifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
