# Enable & View Data Feeds

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">Take the PXA course</a>

{% hint style="info" %}
**Version Upgrade**: The latest action feed version is **Version 5 (V5)**. If you're using an older version, see the *upgrade section* to learn how to upgrade.
{% endhint %}

Data Feeds are automated, scheduled files that can report on a number of different data for your campaign. The primary feature is the **Action Feed**, which reports both new actions and any updates to existing actions.

An *Action Feed* can be customized in terms of its delivery frequency, data format, and delivery method.

#### Enable the action feed

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.&#x20;
2. In the left column, scroll to the *Technical* section.
3. Select [Data Feeds](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-daily-feeds-flow.ihtml).
4. On the right side of the screen, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Edit]**.
5. Select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Toggle on]** to enable the action feed.

From here, you can customize the details of your action feed.

|                     |                                                                                                                                                                                                                                                                                         |                                                                              |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Frequency**       | Choose the frequency that you want to receive the feed, from hourly up to monthly.                                                                                                                                                                                                      |                                                                              |
| **Data Format**     | <p>This determines the file type of the action feed:</p><p>• XML delivers the data in a Extensible Markup Language (XML) file.</p><p>• TAB delivers the data in a .txt file with items separated by tabs.</p><p>• PIPE delivers the data in a .txt file with items separated by pipes ( | ).</p><p>• CSV delivers the data in a comma separated values (CSV) file.</p> |
| **Delivery Method** | Choose your preferred delivery method: impact.com FTP (i.e., you pull your action feed from our FTP servers), Partner FTP (i.e., we send the action feed file to your FTP server), or Email (i.e., we email this file as an attachment to an email address).                            |                                                                              |

**Customize the action feed**

Once the action feed is enabled, you can always disable or change details about it—like the frequency, data format, and more.

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.&#x20;
2. In the left column, scroll to the *Technical* section.
3. Select **Event Notifications**.
4. In the top of the screen, select the **Data Feeds** tab.
5. On the right side of the screen, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Edit]**.

Refer to the description list in the previous section for details on each setting.

#### Understand the action feed file

The action feed file can be read using a plain text editor or imported into a spreadsheet.

See the table below for reference to the headers for **Action Feed Version 5 (V5)**.

<details>

<summary>Action Feed V5 Header Reference</summary>

|                      |                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Field**            | **Format**          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `AdvertiserId`       | Integer             | The unique advertiser account ID to which the action posted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `CampaignId`         | Integer             | The unique ID of the campaign to which the action corresponds.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `CampaignName`       | String              | The name of the campaign to which the action corresponds.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `ActionTrackerId`    | Integer             | The unique ID of the action tracker to which the action corresponds.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `ActionTrackerName`  | String              | The name of the action tracker to which the action corresponds.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `TemplateTermName`   | String              | The name of the template term to which the action corresponds.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `MediaPartnerId`     | Integer             | The unique media partner ID to which the action was credited.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `MediaPartnerName`   | String              | The name of the media partner to which the action was credited.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `ActionId`           | String              | The unique ID that impact.com has assigned to the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `Status`             | String              | <p><strong>Important:</strong> This is a deprecated field and is not available in the latest version of the Action Feed (version 4).</p><p>An action can have one of the below statuses:</p><p><em>Default</em>: The status of the action when it is first created. If no changes are made to the action, then this would remain as the status.</p><p><em>Approved</em>: The advertiser decided this was a valid action, but the advertiser can still make a change before the locking date.</p><p><em>Rejected</em>: The advertiser decided this was an invalid action, so the media partner should not be paid out.</p><p><em>Modified</em>: The advertiser decided that part of the action was invalid (e.g., the customer returned an item in the order) so the payout was reduced.</p><p><strong>Note:</strong> All actions with an <em>over limit</em> status can be approved manually by the advertiser.</p><p><em>Over Limit - Weekday Cap</em>: The action occurred after the weekday cap was already met.</p><p><em>Over Limit - Weekend Cap</em>: The action occurred after the weekend cap was already met.</p><p><em>Over Limit - Budget</em>: The action occurred after the budget specified on the insertion order was already met.</p><p><em>Over Limit - Action Cap</em>: The action occurred after the maximum number of actions specified on the insertion order was already met.</p><p><em>Over Limit - IO Expired</em>: The action occurred after the insertion order was terminated or expired.</p><p><em>Over Limit - Concurrent Calls</em>: The action occurred after the number of concurrent calls specified on the insertion order was already met.</p> |
| `State`              | String              | This value is a status indicating advertiser response to the action, with one of the following values: "APPROVED", "PENDING", or "REVERSED". This value cannot be changed after the action’s locking date.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `ModificationReason` | String              | Important: This is a deprecated field and is not available in the latest version of the Action Feed (version 4).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `AdId`               | Integer             | The unique ID of the ad with which the consumer interacted to initiate the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `ClientCost`         | Decimal (8,2)       | The net “cost” of the action to the advertiser.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `Payout`             | Decimal (8,2)       | The payout to be received by the media partner. For modified actions, this is the net payout. For over limit actions, the payout is $0.00.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `DeltaPayout`        | Decimal (8,2)       | The change in the payout from the previous state. For example, if the advertiser modified the action as a result of a customer return, this value represents the negative adjustment in the payout. If the action has not been modified, this will be the same value as Payout.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `IntendedPayout`     | Decimal (8,2)       | The payout of the action before it was modified. If the action has not been modified, this will be the same value as Payout.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `Amount`             | Decimal (8,2)       | The sales amount, or revenue, of the action. This value is only relevant for pay-per-sale events.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `DeltaAmount`        | Decimal (8,2)       | The change in the sales amount if the action has been modified. If the action has not been modified, this will be the same value as Amount.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `IntendedAmount`     | Decimal (8,2)       | The sales amount before the action was modified. If the action has not been modified, this will be the same value as Amount.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `Currency`           | String (3)          | The currency code that the action was submitted with (currency in advertiser settings is the default if currency code value is not submitted).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `OriginalCurrency`   | String (3)          | The original currency code detected with the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `ReferringDate`      | Timestamp, ISO 8601 | The date and time of the referral associated with the action. This will be the same as the EventDate for actions batched without a ClickId.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `EventDate`          | Timestamp, ISO 8601 | The date and time that the event took place.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `CreationDate`       | Timestamp, ISO 8601 | The date and time when the action was processed and created in the impact.com system.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `LockingDate`        | Timestamp, ISO 8601 | The date when the action locks. After this date, the action cannot be modified by advertiser, and it becomes payable to the media partner.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `ClearedDate`        | Timestamp, ISO 8601 | If the media partner has been paid on this action already, this is the date and time when the funds were transferred to their account.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `ReferringType`      | String              | The type of referral corresponding to this action. For example, ‘CLICK\_COOKIE’ for a click referral, or ‘REPORTED\_PARTNER\_ID’ if the action was batched with a media partner ID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `ReferringDomain`    | String              | The URL where the click referral came from.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `IpAddress`          | String              | The customer's IP Address.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `PromoCode`          | String (64)         | The promo code that was submitted with the action, if there was one.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `Oid`                | String (64)         | The unique, trackable order ID of the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `CustomerId`         | String (50)         | The customer ID submitted with the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `CustomerPostCode`   | Numeric             | The customer’s postal code, if it was submitted with the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `CustomerStatus`     | String (40)         | The customer’s status (New or Returning), if it was submitted with the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `Note`               | String (255)        | A note can include any extra information the advertiser wants to include in the action. If a Note was submitted with the action, it will appear here.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `CallerId`           | Integer             | If this was a Call Tracking action, the required CallerId value for the action will appear here.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `CustomerArea`       | String              | The geographical area of the customer, if it was detected with the action (i.e. DMA code).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `CustomerCity`       | String              | The city of the customer, if it was detected with the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `CustomerRegion`     | String              | The region of the customer, if it was detected with the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `CustomerCountry`    | String              | The country of the customer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `SharedId`           | String (32)         | This value is specific to the media partner, but available to both the media partner and advertiser.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `Items`              | String (255)        | Item-level category, sku, amount, quantity, payout, name, item rebate, and item list (respectively) separated by the “^” character. Multiple items are separated by the “\~” character.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

</details>
