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-hubspot-cloud/index.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,3 +98,9 @@ Follow the steps mentioned [here](https://knowledge.hubspot.com/integrations/con
98
98
### How does disconnecting and uninstalling affect a user's data and HubSpot account?
99
99
Segment immediately stops sending data to HubSpot after you disconnect and uninstall a HubSpot account.
100
100
101
+
### Understanding HubSpot's `date` and dateTime` custom property types
102
+
If you plan on sending a _date_ value that includes time data to your mapped HubSpot custom properties, select HubSpot's `dateTime` property type in HubSpot. If you plan to send a _date_ value that does not contain time data, select the `date` property value in HubSpot. For more information about custom property types, see HubSpot's [Custom objects](https://developers.hubspot.com/docs/api/crm/crm-custom-objects#properties){:target="_blank”} documentation.
103
+
104
+
If you send a _date_ value that contains time data to a custom property in HubSpot with a `date` property type, the event might fail due to an "**Invalid Date Error**."
105
+
106
+
Both of HubSpot's _date_ property types each accept ISO 8601 formatted values, but only the `dateTime` property type accepts values that include time data.
[Kafka](https://kafka.apache.org/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} provides a highly scalable and fault-tolerant messaging system that enables real-time data processing and stream processing at scale. When integrated with Segment, Kafka serves as a powerful backbone for managing and processing event data collected by Segment, allowing businesses to efficiently ingest, route, and analyze data across various applications and systems in real time.
11
+
12
+
This destination is maintained by Segment. For any issues with the destination, [contact the Segment Support team](mailto:[email protected]).
13
+
14
+
## Getting started
15
+
16
+
### Create the Kafka Destination
17
+
18
+
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”} search for "Kafka".
19
+
2. Select the "Kafka" tile and click **Add Destination**.
20
+
3. Select an existing Source to connect to Kafka.
21
+
4. Enter a name for your Kafka destination.
22
+
23
+
### Configure the Kafka Destination
24
+
25
+
The way you've configured your Kafka Cluster informs the authentication and encryption settings you'll need to apply to the Segment Kafka Destination. You may need the assistance of someone technical to provide values for the following Settings:
26
+
27
+
<olstyle="counter-reset: none">
28
+
<livalue="5"markdown="1">
29
+
On the Settings tab, enter values into the **Client ID**, **Brokers** and **Authentication Mechanism** setting fields.
30
+
</li>
31
+
<livalue="6">
32
+
Populate fields based on the value you selected from the <b>Authentication Mechanism</b> field:
33
+
<ul>
34
+
<li>
35
+
<b>Plain</b> or <b>SCRAM-SHA-256 / 512</b> authentication: provide values for <b>Username</b> and <b>Password</b> fields.
36
+
</li>
37
+
<li>
38
+
<b>AWS</b> authentication: provide values for <b>AWS Access Key ID</b> and <b>AWS Secret Key</b> fields, and optionally for the <b>AWS Authorization Identity</b> field.
39
+
</li>
40
+
<li>
41
+
<b>Client Certificate</b> authentication: provide values for the <b>SSL Client Key</b> and <b>SSL Client Certificate</b> fields.
42
+
</li>
43
+
</ul>
44
+
</li>
45
+
<livalue="7"markdown="1">
46
+
Populate the **SSL Certificate Authority** field, if necessary.
47
+
</li>
48
+
<livalue="8"markdown="1">
49
+
Save your changes and proceed to [Configure the Send Action](#configure-the-send-action).
50
+
</li>
51
+
</ol>
52
+
53
+
### Configure the "Send" Action
54
+
55
+
<olstyle="counter-reset: none;">
56
+
<livalue="9"markdown=1>
57
+
Select the Mappings tab and add a new **Send** mapping.
58
+
</li>
59
+
<livalue="10"markdown=1>
60
+
Select a Topic to send data to. This field should auto-populate based on the credentials you provided in the Settings tab.
61
+
</li>
62
+
<livalue="11"markdown=1>
63
+
Map your payload using the **Payload** field. <br> _(Optional)_: Specify partitioning preferences, Headers and Message Key values.
64
+
</li>
65
+
<livalue="12"markdown=1>
66
+
Save and enable the Action, then navigate back to the Kafka destination's Settings tab to enable and save the Destination.
67
+
</li>
68
+
</ol>
69
+
70
+
{% include components/actions-fields.html %}
71
+
72
+
## FAQ
73
+
74
+
### Which Kafka Platforms are supported?
75
+
76
+
The Kafka Destination can send data to Topics on self-hosted Kafka Clusters, or to Clusters hosted on Managed Service platforms like **Confluent Cloud** and **Aiven**.
77
+
78
+
### Which data formats are supported?
79
+
80
+
Segment sends data to Kafka in JSON format only. Segment does not yet support other formats, like Avro or Protobuf.
81
+
82
+
### Which authentication mechanisms are supported?
83
+
84
+
The Authentication Mechanism is controlled with the **Authentication Mechanism** Setting field.
85
+
86
+
Segment supports the following SASL-based authentication methods:
87
+
- Plain
88
+
- SCRAM-SHA-256
89
+
- SCRAM-SHA-512
90
+
- AWS
91
+
92
+
Segment also supports **Client Certificate** authentication.
93
+
94
+
### How is partitioning controlled?
95
+
96
+
The **Send** Action provides multiple ways to specify which Partition an event should be sent to.
97
+
98
+
-**Partition**: Use this field to specify the name of the Partition Segment should send events to.
99
+
-**Default Partition**: Use this field to specify a default Partition. Segment uses this when you don't provide a value in the **Partition** field.
100
+
-**Message Key**: Segment uses a hash of this field's value to determine which Partition should receive an event. If you don't provide a Message Key, Segment uses a round robin algorithm to select the partition to send the event to.
101
+
102
+
### What is the "SSL - Reject Unauthorized Certificate Authority" field for?
103
+
104
+
This field specifies if Segment should reject server connections when a certificate is notsigned by a trusted Certificate Authority (CA). This can be useful for testing purposes or when using a self-signed certificate.
The LinkedIn Conversions API (CAPI) is a conversion tracking tool that creates a direct connection between marketing data from an advertiser’s server and LinkedIn. This integration enables advertisers to measure the performance of their LinkedIn marketing campaigns no matter where the conversion happens and use this data to power campaign optimization. The Conversions API can help strengthen performance and decrease cost per action with more complete attribution, improved reliability, and optimized delivery.
8
+
9
+
This destination is maintained by Segment. For any issues with the destination, [contact the Segment Support team](mailto:[email protected]).
10
+
11
+
## Getting started
12
+
13
+
1. From the Segment web app, click **Catalog**, then click **Destinations**.
14
+
2. Search for “LinkedIn Conversions API” in the Destinations Catalog, and select the destination.
15
+
3. On the LinkedIn Conversions API overview page, click **Add destination**.
16
+
4. Select the source that you want to connect to the LinkedIn Conversions API and click **Next**.
17
+
5. Enter a name for your destination and click **Create destination**.
18
+
6. On the Settings tab, click Connect to `[destination-name]` and follow the prompts to authenticate with LinkedIn using OAuth.
19
+
7. Enable the destination and click **Save Changes**.
20
+
21
+
### Set up a mapping to Stream Conversion Events
22
+
23
+
Follow the steps in the Destination Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customize-mappings). You must create 1 mapping for every conversion rule. After you create a conversion rule, you cannot update the connected LinkedIn Ad account.
24
+
25
+
1. On the Mappings tab, click on **+ New Mapping** and Select **Stream Conversion Event**.
26
+
2. Select the events you'd like to map and send to your LinkedIn Conversions API destination.
27
+
3. Create a conversion rule or enter the link to an existing rule. _If you chose to create a new conversion rule, Segment creates the conversion rule as soon as you click **Save**._
28
+
4. Configure the mappings to map event fields and user attributes from your source to the Conversion API.
29
+
5. Click **Save**.
30
+
31
+
After you've created a Stream Conversion Event mapping, Segment displays the connected rule for each mapping on the Mappings tab. To update the conversion rule you created, select the menu icon for the mapping you'd like to update and click **Edit Mapping**. Scroll to section 3, Create a Conversion Rule, and select **Edit your configuration**. After making changes to your conversion rule, click **Save** to save your changes. You can make changes to all fields except for the Ad account field. After you save your changes, Segment updates the conversion rule in LinkedIn.
32
+
33
+
{% include components/actions-fields.html %}
34
+
35
+
## FAQ and troubleshooting
36
+
37
+
### Why are my inputs failing?
38
+
39
+
Your inputs must meet the following criteria:
40
+
- Contains a valid URN with the following format: <br> `urn:lla:llaPartnerConversion:id`
41
+
- The authenticated user must have write access to the ad account used to create conversion rules
42
+
- Contains a userInfo combination that requires firstName and lastName **OR** a userId mapped to at least one of the following idTypes:
43
+
-`SHA256_EMAIL`
44
+
-`LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID`
45
+
-`ACXIOM_ID`
46
+
-`ORACLE_MOAT_ID`
47
+
-`conversionHappenedAt` must be a valid timestamp (milliseconds since epoch) and must have happened in the past 90 days
48
+
49
+
Any deviations from this specification might lead to failed inputs.
0 commit comments