You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-loops/index.md
+18-17Lines changed: 18 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,22 +11,23 @@ id: 63360a5fe290ca3fdfad4a68
11
11
12
12
[Loops](https://loops.so?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target:="_blank"} is a modern email platform for SaaS, a better way to send marketing and transactional email.
13
13
14
-
You can use this Segment integration to create and update your Loops contacts as well as trigger email sending via events.
14
+
You can use this Segment destination to create and update your Loops contacts and trigger email sending with events.
15
15
16
-
This destination is maintained by Loops. For any issues with the destination, [contact their Support team](mailto:[email protected]).
16
+
Loops maintains this destination. For any issues with the destination, [contact their Support team](mailto:[email protected]).
17
17
18
18
## Getting started
19
19
20
20
1. From the Segment web app, click **Catalog**, then click **Destinations**.
21
21
2. Search for “Loops (Actions)” in the Destinations Catalog, and select the destination.
22
22
3. Click **Configure Loops**.
23
-
4. Select an existing Source to connect to Loops.
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.
25
-
6. Back in Segment, go to the Settings page inside your Loops destination and paste your API key then click "Save Changes".
23
+
4. Select an existing Source to connect to Loops and click **Next**.
24
+
5. On the Setup page, enter a name for your destination and click **Create destination**.
25
+
6. Open Loops and generate an API key from [Settings > API](https://app.loops.so/settings?page=api){:target="_blank"}. Click "Generate key" then click the "Copy to clipboard" icon.
26
+
7. Open the Segment app, go to the Settings page inside your Loops destination, and paste your API key. Then, click "Save Changes".
26
27
27
28
## Create or update contacts
28
29
29
-
You can create and update Loops contacts by using Segment's [Identify method](https://segment.com/docs/connections/spec/identify/){:target="_blank"}, like this:
30
+
You can create and update Loops contacts by using Segment's [Identify method](/docs/connections/spec/identify/), like this:
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
+
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 exists, the existing contact will be updated with the data sent in the Identify call.
41
42
42
-
Go to the Mappings tab inside your Loops destination and click "New Mapping". Select "Create or update a contact".
43
+
Go to the Mappings tab inside your Loops destination and click **New Mapping**. Select **Create or update a contact**.
43
44
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).
45
+
It is important that you set up the data mapping properly in step 3 of the "Create or update a contact" form. This is where you can select which data is sent on to Loops and into which fields. Loops provides an example default mapping in the form, but you should make sure that you set up the mapping to capture the correct data in 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).
45
46
46
-
Any custom fields you are using in Loops can be passed inside "Custom Contact Attributes".
47
+
You can pass any custom fields that you're using in Loops inside "Custom Contact Attributes".
47
48
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
+
Once you have completed the mapping you can send a test event. After you submit a test event, 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
50
50
-
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"}.
51
+
Loops has a full tutorial for creating and updating contacts [in the Loops docs](https://loops.so/docs/add-users/segment#create-or-update-contact){:target="_blank"}.
51
52
52
53
## Sending events
53
54
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:
55
+
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](/docs/connections/spec/track/), like this:
55
56
56
57
```javascript
57
58
analytics.track("User Registered");
58
59
```
59
60
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.
61
+
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.
61
62
62
-
To set up event sending with Segment, go to the Mappings tab inside your Loops destination and click "New Mapping". Select "Send Event".
63
+
To set up event sending with Segment, go to the Mappings tab inside your Loops destination and click **New Mapping**. Select **Send Event**.
63
64
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).
65
+
In the next page, enter the name of the event you're tracking into the "Event Name" field (for example, "User Registered" from the example above). If you have not already created the contact in Loops, you need to include an email address in your mapping, as Loops requires a contact for each event.
65
66
66
67
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.
67
68
68
-
Read our tutorial for sending events [in our docs](https://loops.so/docs/add-users/segment#send-event){:target="_blank"}.
69
+
Read the tutorial for sending events [in the Loops docs](https://loops.so/docs/add-users/segment#send-event){:target="_blank"}.
0 commit comments