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
> Welcome to Segment - glad to have you onboard! This doc serves as a guideline for your team to create best-in-class documentation alongside your amazing product.
6
-
>
7
-
> Here are the guidelines we want you to have in mind when writing out your documentation:
8
-
>
9
-
> - Be succinct and simple in your writing. Reduce text bloat where possible.
10
-
> - Avoid 1st person language as it’s confusing for customers if they don’t know who wrote the docs (Segment or the Partner).
11
-
> - Where pre-reading is required, hyperlink to other more generic parts of Segment’s (or your) documentation.
12
-
>
13
-
> - Screenshots/Images are generally discouraged unless absolutely necessary
14
-
>
15
-
> The below template intends to provide a standardized structure. To submit your documentation, complete the following steps:
16
-
>
17
-
> 1. Fork and clone the `segment-docs` repo locally
18
-
> 2. Create a new branch (e.g., partner-name/destination)
19
-
> 3. Create an `index.md` file in the following path `src/connections/destinations/catalog/{destination-slug}/index.md
20
-
> 4. Copy the template below into your `index.md` file, and edit it to be in line with how your integration operates
21
-
> 5. Add, commit, and push your code, then submit a pull request to the `segment-docs` repo
22
-
>
23
-
> If a section does not apply to your integration, feel free to remove. Please don’t create separate sections unless absolutely necessary. In most cases, creating a H3 (###) sub-heading under an existing section is the best option!
24
-
>
25
-
> If you have any questions in the meantime, please reach out to our team at [email protected].
26
-
27
-
## Template begins here...
28
-
29
1
---
30
-
title: [integration_name] Destination
2
+
title: Taboola Actions Destination
31
3
---
32
4
33
-
> (delete after reading) This template is meant for Actions-based destinations that do not have an existing Classic or non-Actions-based version. For Actions Destinations that are a new version of a classic destination, see the doc-template-update.md template.
34
-
35
-
> (delete after reading) In the section above, edit the `title` field. For example, Slack (Actions) Destination
36
-
37
5
{% include content/plan-grid.md name="actions" %}
38
6
39
-
> (delete after reading) Include a 1-2 sentence introduction to your company and the value it provides to customers - updating the name and hyperlink. Please leave the utm string unchanged.
7
+
[Taboola](https://developers.taboola.com/backstage-api/reference/create-a-first-party-audience/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} integration allows you to connect and target your Segment audiences with Taboola.
40
8
41
-
[<integration_name>](https://yourintegration.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} provides self-serve predictive analytics for growth marketers, leveraging machine learning to automate audience insights and recommendations.
9
+
This destination is maintained by Taboola. For any issues with the destination, [contact their Support team](mailto:[email protected]).
42
10
43
-
> (delete after reading) Update your company name and support email address.
44
-
45
-
This destination is maintained by <integration_name>. For any issues with the destination, [contact their Support team](mailto:support@<integration_name>.com).
11
+
## Getting started
46
12
47
-
> (delete after reading) 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.
13
+
### Get Taboola Account Details
48
14
49
-
## Getting started
15
+
Before connecting the **Taboola (Actions)** destination you'll need the following:
16
+
1. Your Taboola **Client ID** and **Client Secret** - provided by your Taboola account manager.
17
+
2.**Account ID**: retrieve using one of these options:
18
+
*[Taboola Ads](https://ads.taboola.com) - Use the account's alphanumeric name without spaces and in lowercase. For example, 'My Account - Name' would become 'myaccountname'
19
+
*[API](https://developers.taboola.com/backstage-api/reference/get-account-details) - Retrieve Account Details using the Get Account Details API.
50
20
51
-
Before connecting the **Taboola (Actions)** destination you'll need your Taboola **Client ID**, **Client Secret** and **Account ID** values to hand. <TODO: Eden to provide instructions for how to get these values>
21
+
### Create and Connect the Taboola Destination
52
22
53
23
1. From your Segment workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”} search for **Taboola (Actions)**.
54
24
2. Select **Taboola (Actions)** and click **Add Destination**.
@@ -72,6 +42,9 @@ The **Taboola (Actions)** Destination is now connected to your Engage Space. The
72
42
73
43
The Audience will start to sync to Taboola shortly.
74
44
45
+
> info ""
46
+
> To view the audience on the Taboola platform, navigate to the [Tbaoola Ads audience page](https://ads.taboola.com/audiences), select "Custom Audience" and search for the audience you have just connected.
47
+
75
48
## Supported identifiers
76
49
77
50
The **Taboola (Actions)** destination supports syncing Audiences to Taboola using either the `userId` and/or the `Mobile Device ID`.
@@ -83,13 +56,4 @@ The **Taboola (Actions)** destination supports syncing Audiences to Taboola usin
83
56
2. Ensure that both the `android.id` and `ios.id` identifiers are configured exactly as per the image below. This configuration step takes place when the Destination is being connected to an Audience.
84
57

85
58
86
-
87
-
{% include components/actions-fields.html %}
88
-
89
-
90
-
> (delete after reading) Additional Context
91
-
>
92
-
> 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.
93
-
94
-
95
-
> (delete after reading) Congratulations! 🎉 You’ve finished the documentation for your Segment integration. If there’s any additional information or nuance which did not fit in the above template and that you want to share with our mutual customers, feel free to include these as a separate section for us to review. If not, you may now submit this doc to our team.
0 commit comments