From 7387d0e0eb25c273ac5c9a0344a55418d85a30ef Mon Sep 17 00:00:00 2001 From: Thomas Gilbert Date: Wed, 22 Nov 2023 10:18:46 -0500 Subject: [PATCH 1/4] add docs for new movable ink destination --- .../catalog/actions-movable-ink/index.md | 54 +++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 src/connections/destinations/catalog/actions-movable-ink/index.md diff --git a/src/connections/destinations/catalog/actions-movable-ink/index.md b/src/connections/destinations/catalog/actions-movable-ink/index.md new file mode 100644 index 0000000000..055549f003 --- /dev/null +++ b/src/connections/destinations/catalog/actions-movable-ink/index.md @@ -0,0 +1,54 @@ +--- +title: Movable Ink (Actions) Destination +id: 6537b55db9e94b2e110c9cf9 +beta: true +--- + +[Movable Ink](https://movableink.com/){:target="_blank"} lets email marketers deliver jaw-dropping customer experiences. Our cloud-based software activates any data to generate intelligent content at the moment of open. + +This destination enables you to send Segment event data which can be used to automatically generate personalized creative at scale across email and mobile experiences. + +info: This destination is maintained by Movable Ink. For any issues with the destination, please reach out to your Movable Ink Client Experience team. + +## Pre-Requisites + +A Movable Ink Stories license is required to leverage this integration. Please reach out to your Movable Ink client experience team with any questions. + +You will need to share sample event payloads with your Movable Ink Client Experience team before enabling the destination in Segment. Your Client Experience team will then work with a Solutions Architect to map the event within Movable Ink and share an endpoint URL, access key ID and access secret. This event mapping in Movable Ink and API credentials are required for a successful response. + +### To find sample event payloads within Segment: + +1. To locate sample event payloads in Segment if you plan on sending an entire existing event: +2. Navigate to ‘Sources’ and click on the source you’d like to stream data from. +3. Click ‘Debugger’. You will see a list of incoming sample events. +4. Click on the event you’re interested in. Click ‘Raw’ on the right-hand side of the screen to view a full sample payload +5. Copy and paste this sample payload and share with your client experience team. + +Your client experience manager will then provide you with a Movable Ink endpoint URL, access Key ID and access secret. + +## Getting Started + +1. From the Segment web app, click **Catalog**, then click **Destinations**. +2. Search for **Movable Ink (Actions)** and select it. +3. Click **Add Destination** +4. Within the Settings of your new destination input your Movable Ink API credentials into the following fields: +- Username: paste your Movable Ink Access Key ID +- Access Secret: paste your Movable Ink Access Secret +- Movable Ink URL: paste your Movable Ink Endpoint URL + +## Select events and event properties to stream to Movable Ink + +1. Navigate to the 'Mappings' section and create a new mapping. +2. Choose the events to be sent: +- Select the events you’d like to send to Movable Ink by adding or removing any event types (ex. Track, Identify, etc.) you’d like to send. +- Optionally, specify events using 'Add Condition' and rules based on Event Names. +3. Preview the data: +- Load a test event from the source or use a sample event for data preview. +- Map specific fields (optional): +4. Click 'Test Mapping' to send a test event and identify any potential issues. +5. Return to the Mappings overview page and enable your mapping. +6. Finalize the setup by navigating to your integration’s Settings page and activating the integration by toggling on 'Enable Destination.' + +Note: In case of unexpected errors, contact your Movable Ink client experience team with the full sample payload. + +{% include components/actions-fields.html %} \ No newline at end of file From f65c95de7f1300df884e213a8fc2d490d329a7d1 Mon Sep 17 00:00:00 2001 From: Thomas Gilbert Date: Wed, 22 Nov 2023 11:08:03 -0500 Subject: [PATCH 2/4] clarify that there is only one action --- .../destinations/catalog/actions-movable-ink/index.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/src/connections/destinations/catalog/actions-movable-ink/index.md b/src/connections/destinations/catalog/actions-movable-ink/index.md index 055549f003..d421a76f17 100644 --- a/src/connections/destinations/catalog/actions-movable-ink/index.md +++ b/src/connections/destinations/catalog/actions-movable-ink/index.md @@ -38,10 +38,8 @@ Your client experience manager will then provide you with a Movable Ink endpoint ## Select events and event properties to stream to Movable Ink -1. Navigate to the 'Mappings' section and create a new mapping. -2. Choose the events to be sent: -- Select the events you’d like to send to Movable Ink by adding or removing any event types (ex. Track, Identify, etc.) you’d like to send. -- Optionally, specify events using 'Add Condition' and rules based on Event Names. +1. There is only one Action available with this destination, "Send Entire Event". To configure this Action, navigate to the 'Mappings' section of your destination. +2. Select 'Edit Mapping' and tailor the events you wish to send by adding or removing conditions that trigger this Action. 3. Preview the data: - Load a test event from the source or use a sample event for data preview. - Map specific fields (optional): From c6441e6956e7be0223ad747a56191ee13cef124f Mon Sep 17 00:00:00 2001 From: rchinn-segment Date: Wed, 22 Nov 2023 12:23:14 -0800 Subject: [PATCH 3/4] edits --- .../catalog/actions-movable-ink/index.md | 54 ++++++++++--------- 1 file changed, 29 insertions(+), 25 deletions(-) diff --git a/src/connections/destinations/catalog/actions-movable-ink/index.md b/src/connections/destinations/catalog/actions-movable-ink/index.md index d421a76f17..4fa6fc6e83 100644 --- a/src/connections/destinations/catalog/actions-movable-ink/index.md +++ b/src/connections/destinations/catalog/actions-movable-ink/index.md @@ -4,49 +4,53 @@ id: 6537b55db9e94b2e110c9cf9 beta: true --- -[Movable Ink](https://movableink.com/){:target="_blank"} lets email marketers deliver jaw-dropping customer experiences. Our cloud-based software activates any data to generate intelligent content at the moment of open. +[Movable Ink](https://movableink.com/){:target="_blank"} lets email marketers deliver jaw-dropping customer experiences. Movable Ink's cloud-based software activates any data to generate intelligent content at the moment of open. -This destination enables you to send Segment event data which can be used to automatically generate personalized creative at scale across email and mobile experiences. +This destination enables you to send Segment event data which can be used to automatically generate personalized content at scale across email and mobile experiences. -info: This destination is maintained by Movable Ink. For any issues with the destination, please reach out to your Movable Ink Client Experience team. +> info "" +> This destination is maintained by Movable Ink. For any issues with the destination, please reach out to your Movable Ink Client Experience team. ## Pre-Requisites -A Movable Ink Stories license is required to leverage this integration. Please reach out to your Movable Ink client experience team with any questions. +A Movable Ink Stories license is required to use this integration. Please reach out to your Movable Ink client experience team with any questions. -You will need to share sample event payloads with your Movable Ink Client Experience team before enabling the destination in Segment. Your Client Experience team will then work with a Solutions Architect to map the event within Movable Ink and share an endpoint URL, access key ID and access secret. This event mapping in Movable Ink and API credentials are required for a successful response. +You'll need to share sample event payloads with your Movable Ink Client Experience team before enabling the destination in Segment. Your Client Experience team will then work with a Solutions Architect to map the event within Movable Ink and share an endpoint URL, access key ID, and access secret. This event mapping in Movable Ink and API credentials are required for a successful response. -### To find sample event payloads within Segment: +### Find sample event payloads in Segment: -1. To locate sample event payloads in Segment if you plan on sending an entire existing event: -2. Navigate to ‘Sources’ and click on the source you’d like to stream data from. -3. Click ‘Debugger’. You will see a list of incoming sample events. -4. Click on the event you’re interested in. Click ‘Raw’ on the right-hand side of the screen to view a full sample payload -5. Copy and paste this sample payload and share with your client experience team. +To locate sample event payloads in Segment if you plan on sending an entire existing event: -Your client experience manager will then provide you with a Movable Ink endpoint URL, access Key ID and access secret. +1. Navigate to **Sources** and click on the source you’d like to stream data from. +2. Click **Debugger**. You'll see a list of incoming sample events. +3. Click on the event you’re interested in. Click **Raw** to view a full sample payload. +4. Copy and paste this sample payload and share with your client experience team. -## Getting Started +Your client experience manager will then provide you with a Movable Ink endpoint URL, access Key ID, and access secret. + +## Getting started 1. From the Segment web app, click **Catalog**, then click **Destinations**. -2. Search for **Movable Ink (Actions)** and select it. -3. Click **Add Destination** +2. Search for "Movable Ink (Actions)" and select it. +3. Click **Add Destination**. 4. Within the Settings of your new destination input your Movable Ink API credentials into the following fields: -- Username: paste your Movable Ink Access Key ID -- Access Secret: paste your Movable Ink Access Secret -- Movable Ink URL: paste your Movable Ink Endpoint URL +- **Username**: paste your Movable Ink Access Key ID +- **Access Secret**: paste your Movable Ink Access Secret +- **Movable Ink URL**: paste your Movable Ink Endpoint URL ## Select events and event properties to stream to Movable Ink -1. There is only one Action available with this destination, "Send Entire Event". To configure this Action, navigate to the 'Mappings' section of your destination. -2. Select 'Edit Mapping' and tailor the events you wish to send by adding or removing conditions that trigger this Action. +"Send Entire Event" is the only action available with this destination. To configure this action: +1. Navigate to the **Mappings** section of your destination. +2. Select **Edit Mapping** and tailor the events you wish to send by adding or removing conditions that trigger this action. 3. Preview the data: - Load a test event from the source or use a sample event for data preview. -- Map specific fields (optional): -4. Click 'Test Mapping' to send a test event and identify any potential issues. -5. Return to the Mappings overview page and enable your mapping. -6. Finalize the setup by navigating to your integration’s Settings page and activating the integration by toggling on 'Enable Destination.' +4. Map specific fields (optional): +- Click **Test Mapping** to send a test event and identify any potential issues. +- Return to the Mappings overview page and enable your mapping. +6. Finalize the setup by navigating to your integration’s Settings page and activating the integration by toggling on **Enable Destination**. -Note: In case of unexpected errors, contact your Movable Ink client experience team with the full sample payload. +> info "" +> For any unexpected errors, contact your Movable Ink client experience team with the full sample payload. {% include components/actions-fields.html %} \ No newline at end of file From 10e363ea736d3f39abd9b365cfc0167b61cb444e Mon Sep 17 00:00:00 2001 From: rchinn-segment Date: Wed, 22 Nov 2023 12:53:38 -0800 Subject: [PATCH 4/4] More cleanup --- .../catalog/actions-movable-ink/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/connections/destinations/catalog/actions-movable-ink/index.md b/src/connections/destinations/catalog/actions-movable-ink/index.md index 4fa6fc6e83..572052cdc7 100644 --- a/src/connections/destinations/catalog/actions-movable-ink/index.md +++ b/src/connections/destinations/catalog/actions-movable-ink/index.md @@ -19,21 +19,21 @@ You'll need to share sample event payloads with your Movable Ink Client Experien ### Find sample event payloads in Segment: -To locate sample event payloads in Segment if you plan on sending an entire existing event: +To find sample event payloads in Segment: -1. Navigate to **Sources** and click on the source you’d like to stream data from. -2. Click **Debugger**. You'll see a list of incoming sample events. -3. Click on the event you’re interested in. Click **Raw** to view a full sample payload. +1. Navigate to **Connections > Sources** and click on the source you’d like to stream data from. +2. Select the **Debugger** tab. You'll see a list of incoming sample events. +3. Select the event you’re interested in, then select **Raw** to view a full sample payload. 4. Copy and paste this sample payload and share with your client experience team. Your client experience manager will then provide you with a Movable Ink endpoint URL, access Key ID, and access secret. ## Getting started -1. From the Segment web app, click **Catalog**, then click **Destinations**. +1. From the Segment web app, navigate to **Connections > Catalog**, then select **Destinations**. 2. Search for "Movable Ink (Actions)" and select it. 3. Click **Add Destination**. -4. Within the Settings of your new destination input your Movable Ink API credentials into the following fields: +4. Within the **Settings** tab of your destination, input your Movable Ink API credentials into the following fields: - **Username**: paste your Movable Ink Access Key ID - **Access Secret**: paste your Movable Ink Access Secret - **Movable Ink URL**: paste your Movable Ink Endpoint URL @@ -48,7 +48,7 @@ Your client experience manager will then provide you with a Movable Ink endpoint 4. Map specific fields (optional): - Click **Test Mapping** to send a test event and identify any potential issues. - Return to the Mappings overview page and enable your mapping. -6. Finalize the setup by navigating to your integration’s Settings page and activating the integration by toggling on **Enable Destination**. +6. Navigate to your integration’s **Settings** tab and activate the integration by toggling on **Enable Destination**. > info "" > For any unexpected errors, contact your Movable Ink client experience team with the full sample payload.