Skip to content

Commit 2295867

Browse files
committed
Updated copy on Loops page
1 parent 381191a commit 2295867

File tree

1 file changed

+15
-17
lines changed
  • src/connections/destinations/catalog/loops

1 file changed

+15
-17
lines changed

src/connections/destinations/catalog/loops/index.md

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,23 +7,21 @@ hide-dossier: true
77

88
{% include content/plan-grid.md name="actions" %}
99

10-
[Loops](https://loops.so){:target:="_blank"} is an email platform for SaaS.
10+
[Loops](https://loops.so){:target:="_blank"} is a modern email platform for SaaS, a better way to send marketing and transactional email.
1111

1212
You can use this Segment integration to create and update your Loops contacts as well as trigger email sending via events.
1313

1414
<!-- This include describes the requirement of A.js 2.0 or higher for Actions compatibility, and is required if your destination has a web component. -->
1515

1616
{% include content/ajs-upgrade.md %}
1717

18-
<!-- The section below explains how to enable and configure the destination. Include any configuration steps not captured below. For example, obtaining an API key from your platform and any configuration steps required to connect to the destination. -->
19-
2018
## Getting started
2119

2220
1. From the Segment web app, click **Catalog**, then click **Destinations**.
2321
2. Search for “Loops (Actions)” in the Destinations Catalog, and select the destination.
2422
3. Click **Configure Loops**.
2523
4. Select an existing Source to connect to Loops.
26-
5. Generate an Loops API key from [Settings > API](https://app.loops.so/settings?page=api){:target="_blank"}. Click "Generate key" then click the "Copy to clipboard" icon.
24+
5. Generate an API key in Loops from [Settings > API](https://app.loops.so/settings?page=api){:target="_blank"}. Click "Generate key" then click the "Copy to clipboard" icon.
2725
6. Back in Segment, go to the Settings page inside your Loops destination and paste your API key then click "Save Changes".
2826

2927
## Create or update contacts
@@ -39,34 +37,34 @@ analytics.identify("test-user-a5h7xb", {
3937
});
4038
```
4139

42-
All traits in this call can be applied to your Loops contacts using mappings. Go to the Mappings tab and click "New Mapping". Select "Create or update a contact".
40+
If the email address or user ID do not exist in your contacts, a new contact will be created. If the email address or user ID already exist, the existing contact will be updated with the data sent in the `identify()` call.
41+
42+
Go to the Mappings tab inside your Loops destination and click "New Mapping". Select "Create or update a contact".
4343

44-
It is important that you set up the data mapping properly in step 3 of the form. This is where you can select which data is sent on to Loops and into which fields. We provide an example default mapping in the form but you should make sure that you set up the mapping to capture the correct data into the correct fields (you may have some custom fields that the default mapping doesn't cover).
44+
It is important that you set up the data mapping properly in step 3 of the form. This is where you can select which data is sent on to Loops and into which fields. We provide an example default mapping in the form but you should make sure that you set up the mapping to capture the correct data into the correct fields (you may have some [custom fields in Loops](https://loops.so/docs/add-users/properties){:target="_blank"} that the default mapping doesn't cover, for example).
4545

4646
Any custom fields you are using in Loops can be passed inside "Custom Contact Attributes".
4747

48+
Once you have completed the mapping you can send a test event. Once submitted you can verify everything is set up correctly by looking for the contact on the [Audience](https://app.loops.so/audience){:target="_blank"} page in your Loops account.
49+
4850
We have a full tutorial for creating and updating contacts [in our docs](https://loops.so/docs/add-users/segment#create-or-update-contact){:target="_blank"}.
4951

5052
## Sending events
5153

52-
In Loops you can send emails [triggered by events](https://loops.so/docs/loop-builder/triggering-emails){:target="_blank"}. You can send these events to Loops through Segment by using the [Track method](https://segment.com/docs/connections/spec/track/){:target="_blank"}.
54+
In Loops you can send emails [triggered by events](https://loops.so/docs/loop-builder/triggering-emails){:target="_blank"}. You can trigger these events from Segment by using the [Track method](https://segment.com/docs/connections/spec/track/){:target="_blank"}, like this:
5355

5456
```javascript
5557
analytics.track("User Registered");
5658
```
5759

58-
To trigger email sending with Segment, go to the Mappings tab and click "New Mapping". Select "Send Event".
60+
When you make a `track()` call, Segment will pass this event data on to Loops, which can then send emails based on [email-sending triggers](https://loops.so/docs/loop-builder/loop-triggers){:target="_blank"} you've set up in your account.
5961

60-
In the next page enter the name of the event you're tracking in Segment into the "Event Name" field (e.g. "User Registered" from the example above).
62+
To set up event sending with Segment, go to the Mappings tab inside your Loops destination and click "New Mapping". Select "Send Event".
6163

62-
Read our tutorial for sending events [in our docs](https://loops.so/docs/add-users/segment#send-event){:target="_blank"}.
63-
64-
<!-- The line below renders a table of connection settings (if applicable), Pre-built Mappings, and available actions. -->
64+
In the next page, enter the name of the event you're tracking into the "Event Name" field (e.g. "User Registered" from the example above). If you have not already created the contact in Loops, you need include an email address in your mapping (Loops requires a contact for each event).
6565

66-
{% include components/actions-fields.html %}
66+
Now you are able to send a test event. You can verify that the event was triggered properly in your Loops account from the [Events](https://app.loops.so/settings?page=events){:target="_blank"} page.
6767

68-
<!--
69-
Additional Context
68+
Read our tutorial for sending events [in our docs](https://loops.so/docs/add-users/segment#send-event){:target="_blank"}.
7069

71-
Include additional information that you think will be useful to the user here. For information that is specific to an individual mapping, please add that as a comment so that the Segment docs team can include it in the auto-generated content for that mapping.
72-
-->
70+
{% include components/actions-fields.html %}

0 commit comments

Comments
 (0)