Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

TDL-20985 MailChimp v2 #855

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion _data/taps/versions/mailchimp.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,17 @@
# MAILCHIMP VERSIONS #
# -------------------------- #

latest-version: "1"
latest-version: "2"

released-versions:
- number: "2"
status: "released"
date-released: ""
# beta release: July 23, 2019
# date-last-connection:
deprecation-date: ""
sunset-date: ""

- number: "1"
status: "released"
date-released: "March 9, 2020"
Expand Down
251 changes: 251 additions & 0 deletions _integration-schemas/mailchimp/v2/automations.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,251 @@
---
tap: "mailchimp"
version: "2"

key: "automation"
name: "automations"
doc-link: "https://developer.mailchimp.com/documentation/mailchimp/reference/automations/#read-get_automations"
singer-schema: "https://github.com/singer-io/tap-mailchimp/blob/master/tap_mailchimp/schemas/automations.json"
description: |
The `{{ table.name }}` table contains summary info about your {{ integration.display_name }} account's automations. In {{ integration.display_name }}, an automation is a feature that sends a series of emails to subscribers when triggered by a specific date, activity, or event.

replication-method: "Full Table"

api-method:
name: "Get a list of automations"
doc-link: "https://developer.mailchimp.com/documentation/mailchimp/reference/automations/#read-get_automations"

table-key-properties: "id"
valid-replication-keys: ""

attributes:
- name: "id"
type: "string"
primary-key: true
description: "The automation ID."
foreign-key-id: "automation-id"

- name: "create_time"
type: "date-time"
replication-key: true
description: "The date and time the Automation was created in ISO 8601 format."

- name: "emails_sent"
type: "integer"
description: "The total number of emails sent for the Automation."

- name: "recipients"
type: "object"
description: "The list settings for the automation"
subattributes:
- name: "list_id"
type: "string"
description: "The list ID."

- name: "list_is_active"
type: "boolean"
description: "The status of the list used, namely if it's deleted or disabled."

- name: "list_name"
type: "string"
description: "The name of the list."

- name: "segment_opts"
type: "object"
description: "Details about segmentation options."
subattributes:
- name: "match"
type: "string"
description: |
The segment match type. Possible values are:
- `any`
- `all`
- name: "saved_segment_id"
type: "integer"
description: "The ID for an existing saved segment."

- name: "conditions"
type: "array"
description: "Details about segment conditions."
subattributes:
- name: "condition_type"
type: "string"
description: "The type of the segment."

- name: "field"
type: "string"
description: "The segment field."

- name: "op"
type: "string"
description: "The operator."

- name: "value"
type: "string"
description: "The value."

- name: "store_id"
type: "string"
description: "The ID of the store."

- name: "report_summary"
type: "object"
description: "A summary of opens, clicks, and unsubscribes for sent campaigns."
subattributes:
- name: "click_rate"
type: "number"
description: "The number of unique clicks, divided by the total number of successful deliveries."

- name: "clicks"
type: "integer"
description: "The total number of clicks for an campaign."

- name: "open_rate"
type: "number"
description: "The number of unique opens divided by the total number of successful deliveries."

- name: "opens"
type: "integer"
description: "The total number of opens for a campaign."

- name: "subscriber_clicks"
type: "integer"
description: "The number of unique clicks."

- name: "unique_opens"
type: "integer"
description: "The number of unique opens."

- name: "settings"
type: "object"
description: "The settings for the automation workflow."
subattributes:
- name: "authenticate"
type: "boolean"
description: "Indicates whether {{ integration.display_name }} authenticated the automation."

- name: "auto_footer"
type: "boolean"
description: "Indicates whether {{ integration.display_name }}'s default footer is automatically appended to the automation."
- name: "from_name"
type: "string"
description: "The `from` name for the automation."
- name: "inline_css"
type: "boolean"
description: "Indicates whether the CSS included with the automation content is automatically inlined."
- name: "reply_to"
type: "string"
description: "The reply-to email address for the automation."

- name: "title"
type: "string"
description: "The title of the automation."

- name: "to_name"
type: "string"
description: "The automation's custom `to` name, typically the first name merge field."

- name: "use_conversation"
type: "boolean"
description: "Indicates whether {{ integration.display_name }}'s Conversations feature is used to manage out-of-office replies."

- name: "start_time"
type: "date-time"
description: "The date and time the Automation was started in ISO 8601 format."

- name: "status"
type: "string"
description: |
The current status of the Automation. Possible values are:

- `save`
- `paused`
- `sending`

- name: "tracking"
type: "object"
description: "The tracking options for the automation."
subattributes:
- name: "capsule"
type: "object"
description: "Capsule tracking options for the automation."
subattributes:
- name: "notes"
type: "boolean"
description: "Indicates whether contact notes are updated for a campaign based on a subscriber's email address."

- name: "clicktale"
type: "string"
description: "The custom slug for ClickTale tracking."

- name: "ecomm360"
type: "boolean"
description: "Indicates whether eCommerce360 tracking is enabled."

- name: "goal_tracking"
type: "boolean"
description: "Indicates whether Goal tracking is enabled."

- name: "google_analytics"
type: "string"
description: "The custom slug for Google Analytics tracking."

- name: "html_clicks"
type: "boolean"
description: "Indicates whether clicks in the HTML version of the automation are tracked."

- name: "salesforce"
type: "object"
description: "Salesforce tracking options for an automation."
subattributes:
- name: "campaign"
type: "boolean"
description: "Indicates whether a campaign should be created in a connected Salesforce account."

- name: "notes"
type: "boolean"
description: "Indicates whether contact notes are updated for a campaign based on a subscriber's email address."

- name: "text_clicks"
type: "boolean"
description: "Indicates whether clicks are tracked in the plain-text version of the automation."

- name: "opens"
type: "boolean"
description: "Whether to track opens. Defaults to true"

- name: "trigger_settings"
type: "object"
description: "Available triggers for automation workflows."
subattributes:
- name: "runtime"
type: "object"
description: ""
subattributes:
- name: "hours"
type: "object"
description: ""
subattributes:
- name: "type"
type: "string"
description: ""
- name: "days"
type: "array"
description: ""
subattributes:
- name: "items"
type: "string"
description: ""

- name: "workflow_emails_count"
type: "integer"
description: "The number of emails in the automation workflow."

- name: "workflow_title"
type: "string"
description: "The title of the workflow type."

- name: "workflow_type"
type: "string"
description: "The type of the workflow."
---
Loading