Skip to main content
All CollectionsAccountsConfiguration
Configuring an external data source (polling source) for a single account
Configuring an external data source (polling source) for a single account

Set up read-only polling sources to connect external data to Fluency in supported formats.

Updated over a month ago

Polling sources allow you to connect external data to Fluency. They are read-only, meaning you cannot edit or change polling source information via the Fluency platform. Fluency supports formats such as CSV, TSV, JSON, text, and XML.


Adding a polling source to a single account

To configure a polling source for multiple accounts instead, create an Account Data Set Template or a Global Data Set.

To set up a polling source for a single account, follow the steps below, or you can also go through our in-platform walkthrough.

  1. Go to Manage in the top menu.

  2. Select an account from the list.

  3. Click Account Settings in the top right.

  4. Select the Blueprints tab and then the Polling Sources tab.

  5. Click + Add New.

  6. Add a List Name that pertains to the data you're using (e.g., inventory, images, specials, etc.). Note: The name is case sensitive, so watch for unintended spaces or capitalized letters. If you plan to use this polling source in a Blueprint, make sure the naming convention is the same.

  7. Configure the optional fields (see below for more details).

    • Note: Your polling source will refresh based on your chosen frequency. However, you can manually refresh it by clicking Refresh Data or Refresh Template under Update Frequency.

  8. Under Endpoint, paste the link you generated for your polling source. The URL protocol will automatically update, so ensure there is no double protocol (e.g., https://https://).

  9. Click Save to finish.

Connecting assets stored in a Google Drive

  1. Select gdrive:// from the Endpoint dropdown (step #8 in the instructions above).

  2. For the endpoint, enter the folder ID for the Google Drive folder where your assets are stored.


How to set up a polling source

  1. Create a data feed with the account data you want to use in your campaigns, such as an inventory feed. In this example, we'll use Google Sheets.
    ​
    ​Tip: Need to target specific locations with your campaigns? Follow Fluency's location-targeting syntax when setting up a data feed.
    ​

  2. Within the Google Sheet, go to File > Share > Publish to web.

  3. Under Link, choose the specific tab you want to link.

  4. To the right of that field, select Comma-separated values (.csv).

  5. Click Publish.

The link generated in the field below will be the link to the polling source that you'll input in Fluency.

Note: Make sure that your polling source has given access to anyone on the web to ensure that Fluency can ingest the data.


Optional fields

Configure the optional fields as needed:

  • Data Filter: Add one if you want to exclude data. A data filter is necessary to associate the information contained in each row of the polling source with the account in Fluency. A simple way to do this would be for the polling source to include a column with the Fluency UUID. Assuming the column name is UUID, the data filter would look like this: UUID={owneruuid}.

  • Update Frequency: Specify how often the polling source should refresh. The default refresh is every 24 hours.

  • Extract Media: Toggle on if you're pulling images from a Google Drive or other sources.

  • Stale Data Threshold: If your data updates regularly, inputting a number of days will result in Fluency checking to make sure the updates are happening. Note: You can set stale data thresholds in your account ingest sheet by adding a new column with a header. Example: feed:24:Inventory:720. In this example, your data will be updated every 24 hours. If your data has not changed in over 720 hours, you will receive a stale data notification.


Using RSS feeds as a polling source

RSS feeds publish in XML format and can be used as a data source to bring in blog content for advertising. For RSS feeds, Fluency provides an HTML Cleanser tool that removes HTML tags and forms unique pieces of data within the feed. This separation allows you to use images and text separately in your campaigns.

Did this answer your question?