RaviTezu / 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
• Get client ID and secret. Save these -- you'll need them in the next step.
• Find out if the sales force integration package is created (after 1st Aug, 2019) with only OAuth2 support
• Find your tenant subdomain {tenant-subdomin}.login.exacttarget.com
• Obtian a refresh token following the steps here

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, client_secret, tenant_subdomain and refresh_token.

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 © 2019 Salesforce and Licensed under the MIT License

Copyright © 2019 Stitch