drewbanin / tap-exacttarget

A Singer.io tap for extracting data from the ExactTarget/Salesforce Marketing Cloud API.

tap-exacttarget

Author: Connor McArthur ([e-mail])

This is a Singer tap that produces JSON-formatted data following the Singer spec.

It:

• Generates a catalog of available data in Exacttarget
• Extracts the following resources:
  • Campaigns (source)
  • Content Areas (source)
  • Data Extensions and their corresponding rows (source)
  • Emails (source)
  • Events: Each of BounceEvent, ClickEvent, OpenEvent, SentEvent, UnsubEvent go into a single event table (source)
  • Folders (source)
  • List Subscribers (source)
  • Lists (source)
  • Sends (source)
  • Subscribers (requires List Subscribers) (source)

Quick Start

1. Install

git clone [e-mail]:fishtown-analytics/tap-exacttarget.git
cd tap-exacttarget
pip install .

2. Get credentials from Exacttarget. You'll need to:

• create a Salesforce Marketing Cloud App,
• authenticate it to your Exacttarget account, then
• get client ID and secret. Save these -- you'll need them in the next step.

3. Create the config file.

There is a template you can use at config.json.example, just copy it to config.json in the repo root and insert your client ID and secret.

4. Run the application to generate a catalog.

tap-exacttarget -c config.json --discover > catalog.json

5. Select the tables you'd like to replicate

Step 4 a file called catalog.json that specifies all the available endpoints and fields. You'll need to open the file and select the ones you'd like to replicate. See the Singer guide on Catalog Format for more information on how tables are selected.

6. Run it!

tap-exacttarget -c config.json --properties catalog.json

Gotchas

• If you select the subscriber stream, you MUST select list_subscriber as well. subscriber is replicated through list_subscriber.

---

Embedded FuelSDK Copyright © 2017 Salesforce and Licensed under the MIT License

Copyright © 2017 Stitch