diff --git a/src/_data/catalog/destination_categories.yml b/src/_data/catalog/destination_categories.yml index b7facf92f3..17e491bda8 100644 --- a/src/_data/catalog/destination_categories.yml +++ b/src/_data/catalog/destination_categories.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# destination categories last updated 2024-07-30 +# destination categories last updated 2024-08-01 items: - display_name: A/B Testing slug: a-b-testing diff --git a/src/_data/catalog/destinations.yml b/src/_data/catalog/destinations.yml index 4d97867e6a..b2fe5f4d18 100644 --- a/src/_data/catalog/destinations.yml +++ b/src/_data/catalog/destinations.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# destination data last updated 2024-07-30 +# destination data last updated 2024-08-01 items: - id: 637e8d185e2dec264895ea89 display_name: 1Flow @@ -65317,7 +65317,7 @@ items: url: connections/destinations/catalog/madkudu previous_names: - Madkudu - website: http://www.madkudu.com/segment + website: http://www.madkudu.com status: PUBLIC categories: - Analytics @@ -87405,7 +87405,8 @@ items: - Segment Connections website: http://www.segment.com status: PUBLIC - categories: [] + categories: + - Raw Data logo: url: https://cdn.filepicker.io/api/file/alMBNLNZQon4th4eYp6R mark: @@ -88930,7 +88931,9 @@ items: - Segment Profiles website: https://segment.com/product/profiles/ status: PUBLIC - categories: [] + categories: + - Raw Data + - Analytics logo: url: https://cdn.filepicker.io/api/file/vorrYlOTuuGLZFVXG9xA mark: @@ -96049,6 +96052,180 @@ items: actions: [] presets: [] partnerOwned: true +- id: 65a6ac19ea6d3ced628be00b + display_name: Survicate (Actions) + name: Survicate (Actions) + slug: actions-survicate + hidden: false + endpoints: + - US + regions: + - us-west-2 + - eu-west-1 + url: connections/destinations/catalog/actions-survicate + previous_names: + - Survicate (Actions) + website: https://www.survicate.com + status: PUBLIC_BETA + categories: + - Surveys + - Analytics + logo: + url: https://cdn-devcenter.segment.com/5d79073e-56be-4a89-847f-9fd955922de8.svg + mark: + url: https://cdn-devcenter.segment.com/6f44d6d0-edd6-4667-a42c-e84402fddc1a.svg + methods: + track: true + identify: true + group: true + alias: true + screen: false + page: true + platforms: + browser: true + mobile: false + server: false + warehouse: false + cloudAppObject: false + components: [] + browserUnbundlingSupported: false + browserUnbundlingPublic: false + replay: false + connection_modes: + device: + web: false + mobile: false + server: false + cloud: + web: true + mobile: false + server: false + settings: + - name: workspaceKey + type: string + defaultValue: '' + description: The workspace key for your Survicate account. + required: true + label: Workspace Key + actions: + - id: 8u2Pd9K2q6GL9iy5fK4dfu + name: Track Event + slug: trackEvent + description: Invoke survey with Segment Track event + platform: WEB + hidden: false + defaultTrigger: type = "track" + fields: + - id: o7zWRDPD57vxgsyYTMEZr5 + sortOrder: 0 + fieldKey: name + label: Event name + type: STRING + description: The event name + placeholder: '' + defaultValue: + '@path': $.event + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + - id: xwqt4XEXVhoEmQQ6HdmSuK + sortOrder: 1 + fieldKey: properties + label: Event Properties + type: OBJECT + description: Object containing the properties of the event + placeholder: '' + defaultValue: + '@path': $.properties + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: bQ8erC9qmdS9jhSZ6hqXLa + name: Identify Group + slug: identifyGroup + description: Send group traits to Survicate + platform: WEB + hidden: false + defaultTrigger: type = "group" + fields: + - id: vMJmbZwQfkVkKBj6ebd9Je + sortOrder: 0 + fieldKey: groupId + label: Group ID + type: STRING + description: The Segment groupId to be forwarded to Survicate + placeholder: '' + defaultValue: + '@path': $.groupId + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + - id: rwBcSbHCpwLAM4aedtDVxH + sortOrder: 1 + fieldKey: traits + label: Traits + type: OBJECT + description: The Segment traits to be forwarded to Survicate + placeholder: '' + defaultValue: + '@path': $.traits + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + - id: v6MqaNttyMGfw5ZXBfwaU7 + name: Identify User + slug: identifyUser + description: Set visitor traits with Segment Identify event + platform: WEB + hidden: false + defaultTrigger: type = "identify" + fields: + - id: 6Fc4b1zK1VrsXQf9N1zsdR + sortOrder: 0 + fieldKey: traits + label: Traits + type: OBJECT + description: The Segment traits to be forwarded to Survicate + placeholder: '' + defaultValue: + '@path': $.traits + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + presets: + - actionId: 8u2Pd9K2q6GL9iy5fK4dfu + name: Track Event + fields: + name: + '@path': $.event + properties: + '@path': $.properties + trigger: type = "track" + - actionId: v6MqaNttyMGfw5ZXBfwaU7 + name: Identify User + fields: + traits: + '@path': $.traits + trigger: type = "identify" + - actionId: bQ8erC9qmdS9jhSZ6hqXLa + name: Identify Group + fields: + groupId: + '@path': $.groupId + traits: + '@path': $.traits + trigger: type = "group" + partnerOwned: true - id: 59c467ba9e26eb0001380743 display_name: Swrve name: Swrve @@ -108201,6 +108378,1642 @@ items: actions: [] presets: [] partnerOwned: true +- id: 643fdf094cfdbcf1bcccbc42 + display_name: Usermaven (Actions) + name: Usermaven (Actions) + slug: actions-usermaven + hidden: false + endpoints: + - US + regions: + - us-west-2 + - eu-west-1 + url: connections/destinations/catalog/actions-usermaven + previous_names: + - Usermaven (Actions) + website: https://usermaven.com + status: PUBLIC_BETA + categories: + - Analytics + - Attribution + logo: + url: https://cdn.filepicker.io/api/file/SlCGmjU5S3aL28rraX3o + mark: + url: https://cdn.filepicker.io/api/file/gdpRGnhNS9aMqPDaOzvu + methods: + track: true + identify: true + group: true + alias: true + screen: false + page: true + platforms: + browser: true + mobile: false + server: true + warehouse: false + cloudAppObject: false + components: [] + browserUnbundlingSupported: false + browserUnbundlingPublic: false + replay: false + connection_modes: + device: + web: false + mobile: false + server: false + cloud: + web: true + mobile: false + server: true + settings: + - name: api_key + type: string + defaultValue: '' + description: Found on your general settings page. + required: true + label: API Key + - name: server_token + type: string + defaultValue: '' + description: Found on your general settings page. + required: true + label: Server Token + actions: + - id: 8gRstXiw7PFVv2UYWS1xnb + name: Identify User + slug: identify + description: Sets a user data. + platform: CLOUD + hidden: false + defaultTrigger: null + fields: + - id: 3bbUEZnNyCBU3tSpLvNzQ4 + sortOrder: 0 + fieldKey: user_id + label: User id + type: STRING + description: The user id, to uniquely identify the user + placeholder: '' + defaultValue: + '@path': $.userId + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + - id: Qzg9XR25ZfKT8WDgUmLW + sortOrder: 1 + fieldKey: user_email + label: Email address + type: STRING + description: The user email address + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.traits.email + then: + '@path': $.traits.email + else: + '@path': $.properties.email + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + - id: w1xLwoyUHrg25b4ZEZZiHM + sortOrder: 2 + fieldKey: user_created_at + label: Created at + type: STRING + description: The timestamp when the user was created + placeholder: '' + defaultValue: + '@path': $.traits.created_at + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: cLoeYWB567isgyGieoGbWR + sortOrder: 3 + fieldKey: user_first_name + label: First name + type: STRING + description: The user first name + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.traits.first_name + then: + '@path': $.traits.first_name + else: + '@path': $.properties.first_name + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: tR9DbcT5ZaF3cpyC3HZ26P + sortOrder: 4 + fieldKey: user_last_name + label: Last name + type: STRING + description: The user last name + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.traits.last_name + then: + '@path': $.traits.last_name + else: + '@path': $.properties.last_name + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 6uwDj8ZLV1sYZkGmH2rAz2 + sortOrder: 5 + fieldKey: user_custom_attributes + label: Custom attributes + type: OBJECT + description: The user custom attributes + placeholder: '' + defaultValue: + '@path': $.traits + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: j9GT4VwX5c3VzzF3uhituf + sortOrder: 6 + fieldKey: user_anonymous_id + label: Anonymous ID + type: STRING + description: User Anonymous id + placeholder: '' + defaultValue: + '@path': $.anonymousId + required: false + multiple: false + choices: null + dynamic: false + allowNull: true + - id: a1cv8hah5MYz9JWm3ZMHzk + sortOrder: 7 + fieldKey: event_id + label: Event ID + type: STRING + description: The ID of the event. + placeholder: '' + defaultValue: + '@path': $.messageId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: bfJyLfiueAoxTwxibGA8Kc + sortOrder: 8 + fieldKey: doc_path + label: Document Path + type: STRING + description: The path of the document. + placeholder: '' + defaultValue: + '@path': $.context.page.path + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: bghsPuZDH8V5jJaB6VDELs + sortOrder: 9 + fieldKey: doc_search + label: Document Search + type: STRING + description: The search query of the document. + placeholder: '' + defaultValue: + '@path': $.context.page.search + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: mhMrdnRHt5CHnXhRe4G9us + sortOrder: 10 + fieldKey: event_type + label: Event Type + type: STRING + description: The type of the event. + placeholder: '' + defaultValue: + '@path': $.type + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: vY5eeLDFZGwLM9aKDtUzaN + sortOrder: 11 + fieldKey: page_title + label: Page Title + type: STRING + description: The title of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.title + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: vyK9boowXDzWEK6bcTd1Wm + sortOrder: 12 + fieldKey: referer + label: Referrer + type: STRING + description: The referrer of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.referrer + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 41attN27QtLpwZhym83ny2 + sortOrder: 13 + fieldKey: url + label: URL + type: STRING + description: The URL of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.url + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: uXQ9gR5WLxSivonwSGHzzY + sortOrder: 14 + fieldKey: user_agent + label: User Agent + type: STRING + description: The user agent of the browser. + placeholder: '' + defaultValue: + '@path': $.context.userAgent + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: nguvw4VmBEsyLqFGst7XG1 + sortOrder: 15 + fieldKey: user_language + label: User Language + type: STRING + description: The language of the browser. + placeholder: '' + defaultValue: + '@path': $.context.locale + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: oz78bK2cF8sFigDCANLb7h + sortOrder: 16 + fieldKey: utc_time + label: UTC Time + type: STRING + description: The time of the event in UTC. + placeholder: '' + defaultValue: + '@path': $.timestamp + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: xAPQLtHC6VQSYwtg3Ag2i5 + sortOrder: 17 + fieldKey: utm + label: UTM + type: OBJECT + description: Information about the UTM parameters. + placeholder: '' + defaultValue: + source: + '@path': $.context.campaign.source + medium: + '@path': $.context.campaign.medium + name: + '@path': $.context.campaign.name + term: + '@path': $.context.campaign.term + content: + '@path': $.context.campaign.content + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: wd3zgVhgGgD59jJCYcxKN9 + sortOrder: 18 + fieldKey: screen + label: Screen + type: OBJECT + description: Information about the screen. + placeholder: '' + defaultValue: + height: + '@path': $.context.screen.height + width: + '@path': $.context.screen.width + density: + '@path': $.context.screen.density + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: jdHyDdR2DE8SfTNpfN2qt + sortOrder: 19 + fieldKey: timezone + label: Timezone + type: STRING + description: The timezone of the browser. + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.properties.timezone + then: + '@path': $.properties.timezone + else: + '@path': $.traits.timezone + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: ai1FtyAf7WV9EBPhC689FL + sortOrder: 20 + fieldKey: source_ip + label: IP Address + type: STRING + description: The IP address of the user. + placeholder: '' + defaultValue: + '@path': $.context.ip + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: eLtV6kjxhyWifZZU14HtJn + name: Track Event + slug: track + description: Sends a track event to Usermaven. + platform: CLOUD + hidden: false + defaultTrigger: null + fields: + - id: 2n8SZLssV3oyDQzbhpc5fy + sortOrder: 0 + fieldKey: event + label: Event Name + type: STRING + description: The event name + placeholder: '' + defaultValue: + '@path': $.event + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + - id: euAJwe9DvAJiELYxRC41dB + sortOrder: 1 + fieldKey: event_attributes + label: Event Attributes + type: OBJECT + description: Attributes associated with the event + placeholder: '' + defaultValue: + '@path': $.properties + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: nzu6Pz6tfr9X7GjfqTpCcH + sortOrder: 2 + fieldKey: user_id + label: User id + type: STRING + description: The user id, to uniquely identify the user + placeholder: '' + defaultValue: + '@path': $.userId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: vSWjC7UwheaF41DrVrNhcR + sortOrder: 3 + fieldKey: user_email + label: Email address + type: STRING + description: The user email address + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.properties.email + then: + '@path': $.properties.email + else: + '@path': $.context.traits.email + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: vvhfKj6dr9U6dDNtCXxtD8 + sortOrder: 4 + fieldKey: user_created_at + label: Created at + type: STRING + description: The timestamp when the user was created + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.properties.created_at + then: + '@path': $.properties.created_at + else: + '@path': $.context.traits.created_at + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: wQ11oJYCuk75r9TNM3tYmg + sortOrder: 5 + fieldKey: user_anonymous_id + label: Anonymous ID + type: STRING + description: User Anonymous id + placeholder: '' + defaultValue: + '@path': $.anonymousId + required: false + multiple: false + choices: null + dynamic: false + allowNull: true + - id: qcWiXJDgCQ3LSR99fpbQsH + sortOrder: 6 + fieldKey: event_id + label: Event ID + type: STRING + description: The ID of the event. + placeholder: '' + defaultValue: + '@path': $.messageId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: ekmokJzDb2SUtf483vMk1P + sortOrder: 7 + fieldKey: doc_path + label: Document Path + type: STRING + description: The path of the document. + placeholder: '' + defaultValue: + '@path': $.context.page.path + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 71Nnfr22WKZPWhqmcKL1KQ + sortOrder: 8 + fieldKey: doc_search + label: Document Search + type: STRING + description: The search query of the document. + placeholder: '' + defaultValue: + '@path': $.context.page.search + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 9KFPCeR3zmb46VzHWjwago + sortOrder: 9 + fieldKey: event_type + label: Event Type + type: STRING + description: The type of the event. + placeholder: '' + defaultValue: + '@path': $.type + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: Wp2apRZ7muGj1dtMzYdyf + sortOrder: 10 + fieldKey: page_title + label: Page Title + type: STRING + description: The title of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.title + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: mLViGMv4hEgxzAhSidUZ1s + sortOrder: 11 + fieldKey: referer + label: Referrer + type: STRING + description: The referrer of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.referrer + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: kmsejfaGuMNQByyTMZWpWP + sortOrder: 12 + fieldKey: url + label: URL + type: STRING + description: The URL of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.url + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: jgD139s6JWNkA93MSJFxiX + sortOrder: 13 + fieldKey: user_agent + label: User Agent + type: STRING + description: The user agent of the browser. + placeholder: '' + defaultValue: + '@path': $.context.userAgent + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: pAa4Tia3bDWxLb16GfCBZ9 + sortOrder: 14 + fieldKey: user_language + label: User Language + type: STRING + description: The language of the browser. + placeholder: '' + defaultValue: + '@path': $.context.locale + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 3EkH5HZ41AdDnxGux7owND + sortOrder: 15 + fieldKey: utc_time + label: UTC Time + type: STRING + description: The time of the event in UTC. + placeholder: '' + defaultValue: + '@path': $.timestamp + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 7x5KudSAJ1NYv1KUdkpCBK + sortOrder: 16 + fieldKey: utm + label: UTM + type: OBJECT + description: Information about the UTM parameters. + placeholder: '' + defaultValue: + source: + '@path': $.context.campaign.source + medium: + '@path': $.context.campaign.medium + name: + '@path': $.context.campaign.name + term: + '@path': $.context.campaign.term + content: + '@path': $.context.campaign.content + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: aZbZ72ACb5Cnx1p41DwbBh + sortOrder: 17 + fieldKey: screen + label: Screen + type: OBJECT + description: Information about the screen. + placeholder: '' + defaultValue: + height: + '@path': $.context.screen.height + width: + '@path': $.context.screen.width + density: + '@path': $.context.screen.density + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: mkiePznZADL6bNR11ccZ93 + sortOrder: 18 + fieldKey: timezone + label: Timezone + type: STRING + description: The timezone of the browser. + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.properties.timezone + then: + '@path': $.properties.timezone + else: + '@path': $.traits.timezone + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: edk1MfyzLwZwUKrU2nDnuP + sortOrder: 19 + fieldKey: source_ip + label: IP Address + type: STRING + description: The IP address of the user. + placeholder: '' + defaultValue: + '@path': $.context.ip + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: qg6REVpUrbDEyU9oS6M9nZ + name: Group + slug: group + description: Send company attributes to Usermaven. + platform: CLOUD + hidden: false + defaultTrigger: null + fields: + - id: sh3owu8c1aCPoYEJjfv2Qo + sortOrder: 0 + fieldKey: company_id + label: Company id + type: STRING + description: The company id, to uniquely identify the company + placeholder: '' + defaultValue: + '@path': $.groupId + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + - id: wPa3KGt7kqYvKsbtoC9qqC + sortOrder: 1 + fieldKey: user_id + label: User id + type: STRING + description: The user id, to uniquely identify the user + placeholder: '' + defaultValue: + '@path': $.userId + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + - id: wKq54EoNb2N8nQRgeRUa2r + sortOrder: 2 + fieldKey: company_name + label: Company name + type: STRING + description: The company name + placeholder: '' + defaultValue: + '@path': $.traits.name + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 9aansDTgo4axVtxDwYtGUb + sortOrder: 3 + fieldKey: company_created_at + label: Company created at + type: STRING + description: The timestamp when the company was created + placeholder: '' + defaultValue: + '@path': $.traits.created_at + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 8RChgfe4udobJ53NFPk2ny + sortOrder: 4 + fieldKey: company_custom_attributes + label: Company custom attributes + type: OBJECT + description: The company custom attributes + placeholder: '' + defaultValue: + '@path': $.traits + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: fkEU3emnuTBgQNqz197Pbf + sortOrder: 5 + fieldKey: user_anonymous_id + label: Anonymous ID + type: STRING + description: User Anonymous id + placeholder: '' + defaultValue: + '@path': $.anonymousId + required: false + multiple: false + choices: null + dynamic: false + allowNull: true + - id: b8Grxf47tgaymCrFYxdKC2 + sortOrder: 6 + fieldKey: event_id + label: Event ID + type: STRING + description: The ID of the event. + placeholder: '' + defaultValue: + '@path': $.messageId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: tqeBxjh5tygVJxcuNQap6W + sortOrder: 7 + fieldKey: doc_path + label: Document Path + type: STRING + description: The path of the document. + placeholder: '' + defaultValue: + '@path': $.context.page.path + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: n1tz8y7Vk7eHkCqVGqDqpG + sortOrder: 8 + fieldKey: doc_search + label: Document Search + type: STRING + description: The search query of the document. + placeholder: '' + defaultValue: + '@path': $.context.page.search + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 8SzzyK4YJSXmYD677x48YY + sortOrder: 9 + fieldKey: event_type + label: Event Type + type: STRING + description: The type of the event. + placeholder: '' + defaultValue: + '@path': $.type + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: ir8k3oeMxfwZ1qCxfL1A78 + sortOrder: 10 + fieldKey: page_title + label: Page Title + type: STRING + description: The title of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.title + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 6vjReNP8CS37MuVw4aQxje + sortOrder: 11 + fieldKey: referer + label: Referrer + type: STRING + description: The referrer of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.referrer + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: uoPEkMnNAsiUiUh2kbkzR8 + sortOrder: 12 + fieldKey: url + label: URL + type: STRING + description: The URL of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.url + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: qEtNvAsLT7XoZNX4NYQse2 + sortOrder: 13 + fieldKey: user_agent + label: User Agent + type: STRING + description: The user agent of the browser. + placeholder: '' + defaultValue: + '@path': $.context.userAgent + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 6fhugx5B84z4Lx6SkXfKor + sortOrder: 14 + fieldKey: user_language + label: User Language + type: STRING + description: The language of the browser. + placeholder: '' + defaultValue: + '@path': $.context.locale + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: gYvqqhf4iMwgN185B3hMuX + sortOrder: 15 + fieldKey: utc_time + label: UTC Time + type: STRING + description: The time of the event in UTC. + placeholder: '' + defaultValue: + '@path': $.timestamp + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: oxT7SYKvLMN424Wdz1x1sM + sortOrder: 16 + fieldKey: utm + label: UTM + type: OBJECT + description: Information about the UTM parameters. + placeholder: '' + defaultValue: + source: + '@path': $.context.campaign.source + medium: + '@path': $.context.campaign.medium + name: + '@path': $.context.campaign.name + term: + '@path': $.context.campaign.term + content: + '@path': $.context.campaign.content + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 3ust1dkkdzvtshCbBcYhBW + sortOrder: 17 + fieldKey: screen + label: Screen + type: OBJECT + description: Information about the screen. + placeholder: '' + defaultValue: + height: + '@path': $.context.screen.height + width: + '@path': $.context.screen.width + density: + '@path': $.context.screen.density + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: sjvgwBKB9iKWykF7EwmWyd + sortOrder: 18 + fieldKey: timezone + label: Timezone + type: STRING + description: The timezone of the browser. + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.properties.timezone + then: + '@path': $.properties.timezone + else: + '@path': $.traits.timezone + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: fyADYUMXK7L4G6ZcrKXTBg + sortOrder: 19 + fieldKey: source_ip + label: IP Address + type: STRING + description: The IP address of the user. + placeholder: '' + defaultValue: + '@path': $.context.ip + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: oPWRb2J53D99hbWYZe8CAo + name: Page + slug: page + description: Send pageview events to Usermaven. + platform: CLOUD + hidden: false + defaultTrigger: null + fields: + - id: gqKuCczrypPscaZDsbd1Xb + sortOrder: 0 + fieldKey: user_id + label: User id + type: STRING + description: The user id, to uniquely identify the user + placeholder: '' + defaultValue: + '@path': $.userId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: dvRSNK2pXM7EcLbeVqg9sE + sortOrder: 1 + fieldKey: user_email + label: Email address + type: STRING + description: The user email address + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.properties.email + then: + '@path': $.properties.email + else: + '@path': $.context.traits.email + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: c9pMdDurL25jq8xLPuo3R4 + sortOrder: 2 + fieldKey: user_created_at + label: Created at + type: STRING + description: The timestamp when the user was created + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.properties.created_at + then: + '@path': $.properties.created_at + else: + '@path': $.context.traits.created_at + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: cRw19qoPZAH9YDxbedBAys + sortOrder: 3 + fieldKey: page_name + label: Page Name + type: STRING + description: The name of the page + placeholder: '' + defaultValue: + '@path': $.properties.name + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: jT1j6YiJx3T9uAg95iJAXc + sortOrder: 4 + fieldKey: user_anonymous_id + label: Anonymous ID + type: STRING + description: User Anonymous id + placeholder: '' + defaultValue: + '@path': $.anonymousId + required: false + multiple: false + choices: null + dynamic: false + allowNull: true + - id: pZnPSTHCrjMUmaQdbZeVHN + sortOrder: 5 + fieldKey: event_id + label: Event ID + type: STRING + description: The ID of the event. + placeholder: '' + defaultValue: + '@path': $.messageId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: skBwtvoErnzcFnQmboKrwo + sortOrder: 6 + fieldKey: doc_path + label: Document Path + type: STRING + description: The path of the document. + placeholder: '' + defaultValue: + '@path': $.context.page.path + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 7E4LnrCaYRLDrJuFoKn7cC + sortOrder: 7 + fieldKey: doc_search + label: Document Search + type: STRING + description: The search query of the document. + placeholder: '' + defaultValue: + '@path': $.context.page.search + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: sXbG92qvkcVENkJBWbnGo3 + sortOrder: 8 + fieldKey: event_type + label: Event Type + type: STRING + description: The type of the event. + placeholder: '' + defaultValue: + '@path': $.type + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 6JerdPkPH9F2zzLRasmGVa + sortOrder: 9 + fieldKey: page_title + label: Page Title + type: STRING + description: The title of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.title + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: h6Z5GRoMSJ3f9ekh8apmP9 + sortOrder: 10 + fieldKey: referer + label: Referrer + type: STRING + description: The referrer of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.referrer + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 9ACL7AHihYvUzV7jjGyM5C + sortOrder: 11 + fieldKey: url + label: URL + type: STRING + description: The URL of the page where the event occurred. + placeholder: '' + defaultValue: + '@path': $.context.page.url + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 96Lhr6inykPkBs5Z8TiBK5 + sortOrder: 12 + fieldKey: user_agent + label: User Agent + type: STRING + description: The user agent of the browser. + placeholder: '' + defaultValue: + '@path': $.context.userAgent + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: hNXpSEx4eYjkQXWEdyMFRs + sortOrder: 13 + fieldKey: user_language + label: User Language + type: STRING + description: The language of the browser. + placeholder: '' + defaultValue: + '@path': $.context.locale + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 2oyfB4ayAtYWU7mqinnroE + sortOrder: 14 + fieldKey: utc_time + label: UTC Time + type: STRING + description: The time of the event in UTC. + placeholder: '' + defaultValue: + '@path': $.timestamp + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: kwdo9Ea2DtACznKXLSmU5X + sortOrder: 15 + fieldKey: utm + label: UTM + type: OBJECT + description: Information about the UTM parameters. + placeholder: '' + defaultValue: + source: + '@path': $.context.campaign.source + medium: + '@path': $.context.campaign.medium + name: + '@path': $.context.campaign.name + term: + '@path': $.context.campaign.term + content: + '@path': $.context.campaign.content + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: vwR6kCrJqg64iBJo3egnEy + sortOrder: 16 + fieldKey: screen + label: Screen + type: OBJECT + description: Information about the screen. + placeholder: '' + defaultValue: + height: + '@path': $.context.screen.height + width: + '@path': $.context.screen.width + density: + '@path': $.context.screen.density + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: kcouWQ4RcRwB7Vzqb9ZDPw + sortOrder: 17 + fieldKey: timezone + label: Timezone + type: STRING + description: The timezone of the browser. + placeholder: '' + defaultValue: + '@if': + exists: + '@path': $.properties.timezone + then: + '@path': $.properties.timezone + else: + '@path': $.traits.timezone + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: kNpF1HohXZH2FMnA7kJrKa + sortOrder: 18 + fieldKey: source_ip + label: IP Address + type: STRING + description: The IP address of the user. + placeholder: '' + defaultValue: + '@path': $.context.ip + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + presets: + - actionId: 8gRstXiw7PFVv2UYWS1xnb + name: Identify User + fields: + user_id: + '@path': $.userId + user_email: + '@if': + exists: + '@path': $.traits.email + then: + '@path': $.traits.email + else: + '@path': $.properties.email + user_created_at: + '@path': $.traits.created_at + user_first_name: + '@if': + exists: + '@path': $.traits.first_name + then: + '@path': $.traits.first_name + else: + '@path': $.properties.first_name + user_last_name: + '@if': + exists: + '@path': $.traits.last_name + then: + '@path': $.traits.last_name + else: + '@path': $.properties.last_name + user_custom_attributes: + '@path': $.traits + user_anonymous_id: + '@path': $.anonymousId + event_id: + '@path': $.messageId + doc_path: + '@path': $.context.page.path + doc_search: + '@path': $.context.page.search + event_type: + '@path': $.type + page_title: + '@path': $.context.page.title + referer: + '@path': $.context.page.referrer + url: + '@path': $.context.page.url + user_agent: + '@path': $.context.userAgent + user_language: + '@path': $.context.locale + utc_time: + '@path': $.timestamp + utm: + source: + '@path': $.context.campaign.source + medium: + '@path': $.context.campaign.medium + name: + '@path': $.context.campaign.name + term: + '@path': $.context.campaign.term + content: + '@path': $.context.campaign.content + screen: + height: + '@path': $.context.screen.height + width: + '@path': $.context.screen.width + density: + '@path': $.context.screen.density + timezone: + '@if': + exists: + '@path': $.properties.timezone + then: + '@path': $.properties.timezone + else: + '@path': $.traits.timezone + source_ip: + '@path': $.context.ip + trigger: type = "identify" + - actionId: qg6REVpUrbDEyU9oS6M9nZ + name: Group + fields: + company_id: + '@path': $.groupId + user_id: + '@path': $.userId + company_name: + '@path': $.traits.name + company_created_at: + '@path': $.traits.created_at + company_custom_attributes: + '@path': $.traits + user_anonymous_id: + '@path': $.anonymousId + event_id: + '@path': $.messageId + doc_path: + '@path': $.context.page.path + doc_search: + '@path': $.context.page.search + event_type: + '@path': $.type + page_title: + '@path': $.context.page.title + referer: + '@path': $.context.page.referrer + url: + '@path': $.context.page.url + user_agent: + '@path': $.context.userAgent + user_language: + '@path': $.context.locale + utc_time: + '@path': $.timestamp + utm: + source: + '@path': $.context.campaign.source + medium: + '@path': $.context.campaign.medium + name: + '@path': $.context.campaign.name + term: + '@path': $.context.campaign.term + content: + '@path': $.context.campaign.content + screen: + height: + '@path': $.context.screen.height + width: + '@path': $.context.screen.width + density: + '@path': $.context.screen.density + timezone: + '@if': + exists: + '@path': $.properties.timezone + then: + '@path': $.properties.timezone + else: + '@path': $.traits.timezone + source_ip: + '@path': $.context.ip + trigger: type = "group" + - actionId: oPWRb2J53D99hbWYZe8CAo + name: Page + fields: + user_id: + '@path': $.userId + user_email: + '@if': + exists: + '@path': $.properties.email + then: + '@path': $.properties.email + else: + '@path': $.context.traits.email + user_created_at: + '@if': + exists: + '@path': $.properties.created_at + then: + '@path': $.properties.created_at + else: + '@path': $.context.traits.created_at + page_name: + '@path': $.properties.name + user_anonymous_id: + '@path': $.anonymousId + event_id: + '@path': $.messageId + doc_path: + '@path': $.context.page.path + doc_search: + '@path': $.context.page.search + event_type: + '@path': $.type + page_title: + '@path': $.context.page.title + referer: + '@path': $.context.page.referrer + url: + '@path': $.context.page.url + user_agent: + '@path': $.context.userAgent + user_language: + '@path': $.context.locale + utc_time: + '@path': $.timestamp + utm: + source: + '@path': $.context.campaign.source + medium: + '@path': $.context.campaign.medium + name: + '@path': $.context.campaign.name + term: + '@path': $.context.campaign.term + content: + '@path': $.context.campaign.content + screen: + height: + '@path': $.context.screen.height + width: + '@path': $.context.screen.width + density: + '@path': $.context.screen.density + timezone: + '@if': + exists: + '@path': $.properties.timezone + then: + '@path': $.properties.timezone + else: + '@path': $.traits.timezone + source_ip: + '@path': $.context.ip + trigger: type = "page" + - actionId: eLtV6kjxhyWifZZU14HtJn + name: Track Event + fields: + event: + '@path': $.event + event_attributes: + '@path': $.properties + user_id: + '@path': $.userId + user_email: + '@if': + exists: + '@path': $.properties.email + then: + '@path': $.properties.email + else: + '@path': $.context.traits.email + user_created_at: + '@if': + exists: + '@path': $.properties.created_at + then: + '@path': $.properties.created_at + else: + '@path': $.context.traits.created_at + user_anonymous_id: + '@path': $.anonymousId + event_id: + '@path': $.messageId + doc_path: + '@path': $.context.page.path + doc_search: + '@path': $.context.page.search + event_type: + '@path': $.type + page_title: + '@path': $.context.page.title + referer: + '@path': $.context.page.referrer + url: + '@path': $.context.page.url + user_agent: + '@path': $.context.userAgent + user_language: + '@path': $.context.locale + utc_time: + '@path': $.timestamp + utm: + source: + '@path': $.context.campaign.source + medium: + '@path': $.context.campaign.medium + name: + '@path': $.context.campaign.name + term: + '@path': $.context.campaign.term + content: + '@path': $.context.campaign.content + screen: + height: + '@path': $.context.screen.height + width: + '@path': $.context.screen.width + density: + '@path': $.context.screen.density + timezone: + '@if': + exists: + '@path': $.properties.timezone + then: + '@path': $.properties.timezone + else: + '@path': $.traits.timezone + source_ip: + '@path': $.context.ip + trigger: type = "track" + partnerOwned: true - id: 6537b5da8f27fd20713a5ba8 display_name: UserMotion (Actions) name: UserMotion (Actions) diff --git a/src/_data/catalog/destinations_private.yml b/src/_data/catalog/destinations_private.yml index 4f7a161085..1c085b7ba5 100644 --- a/src/_data/catalog/destinations_private.yml +++ b/src/_data/catalog/destinations_private.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# destination data last updated 2024-07-30 +# destination data last updated 2024-08-01 items: - id: 54521fd925e721e32a72eee1 display_name: Pardot @@ -785,1620 +785,3 @@ items: '@path': $.traits enable_batching: true trigger: type = "track" or type = "identify" - - id: 643fdf094cfdbcf1bcccbc42 - display_name: Usermaven (Actions) - name: Usermaven (Actions) - slug: usermaven-actions - previous_names: - - Usermaven (Actions) - url: connections/destinations/catalog/usermaven-actions - website: https://usermaven.com - status: PRIVATE_BETA - logo: - url: https://cdn.filepicker.io/api/file/SlCGmjU5S3aL28rraX3o - mark: - url: https://cdn.filepicker.io/api/file/gdpRGnhNS9aMqPDaOzvu - methods: - track: true - identify: true - group: true - alias: true - screen: false - page: true - platforms: - browser: true - mobile: false - server: true - warehouse: false - cloudAppObject: false - components: [] - browserUnbundlingSupported: false - browserUnbundlingPublic: false - replay: false - settings: - - name: api_key - type: string - defaultValue: '' - description: Found on your general settings page. - required: true - label: API Key - - name: server_token - type: string - defaultValue: '' - description: Found on your general settings page. - required: true - label: Server Token - actions: - - id: 8gRstXiw7PFVv2UYWS1xnb - name: Identify User - slug: identify - description: Sets a user data. - platform: CLOUD - hidden: false - defaultTrigger: null - fields: - - id: 3bbUEZnNyCBU3tSpLvNzQ4 - sortOrder: 0 - fieldKey: user_id - label: User id - type: STRING - description: The user id, to uniquely identify the user - placeholder: '' - defaultValue: - '@path': $.userId - required: true - multiple: false - choices: null - dynamic: false - allowNull: false - - id: Qzg9XR25ZfKT8WDgUmLW - sortOrder: 1 - fieldKey: user_email - label: Email address - type: STRING - description: The user email address - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.traits.email - then: - '@path': $.traits.email - else: - '@path': $.properties.email - required: true - multiple: false - choices: null - dynamic: false - allowNull: false - - id: w1xLwoyUHrg25b4ZEZZiHM - sortOrder: 2 - fieldKey: user_created_at - label: Created at - type: STRING - description: The timestamp when the user was created - placeholder: '' - defaultValue: - '@path': $.traits.created_at - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: cLoeYWB567isgyGieoGbWR - sortOrder: 3 - fieldKey: user_first_name - label: First name - type: STRING - description: The user first name - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.traits.first_name - then: - '@path': $.traits.first_name - else: - '@path': $.properties.first_name - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: tR9DbcT5ZaF3cpyC3HZ26P - sortOrder: 4 - fieldKey: user_last_name - label: Last name - type: STRING - description: The user last name - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.traits.last_name - then: - '@path': $.traits.last_name - else: - '@path': $.properties.last_name - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 6uwDj8ZLV1sYZkGmH2rAz2 - sortOrder: 5 - fieldKey: user_custom_attributes - label: Custom attributes - type: OBJECT - description: The user custom attributes - placeholder: '' - defaultValue: - '@path': $.traits - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: j9GT4VwX5c3VzzF3uhituf - sortOrder: 6 - fieldKey: user_anonymous_id - label: Anonymous ID - type: STRING - description: User Anonymous id - placeholder: '' - defaultValue: - '@path': $.anonymousId - required: false - multiple: false - choices: null - dynamic: false - allowNull: true - - id: a1cv8hah5MYz9JWm3ZMHzk - sortOrder: 7 - fieldKey: event_id - label: Event ID - type: STRING - description: The ID of the event. - placeholder: '' - defaultValue: - '@path': $.messageId - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: bfJyLfiueAoxTwxibGA8Kc - sortOrder: 8 - fieldKey: doc_path - label: Document Path - type: STRING - description: The path of the document. - placeholder: '' - defaultValue: - '@path': $.context.page.path - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: bghsPuZDH8V5jJaB6VDELs - sortOrder: 9 - fieldKey: doc_search - label: Document Search - type: STRING - description: The search query of the document. - placeholder: '' - defaultValue: - '@path': $.context.page.search - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: mhMrdnRHt5CHnXhRe4G9us - sortOrder: 10 - fieldKey: event_type - label: Event Type - type: STRING - description: The type of the event. - placeholder: '' - defaultValue: - '@path': $.type - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: vY5eeLDFZGwLM9aKDtUzaN - sortOrder: 11 - fieldKey: page_title - label: Page Title - type: STRING - description: The title of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.title - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: vyK9boowXDzWEK6bcTd1Wm - sortOrder: 12 - fieldKey: referer - label: Referrer - type: STRING - description: The referrer of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.referrer - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 41attN27QtLpwZhym83ny2 - sortOrder: 13 - fieldKey: url - label: URL - type: STRING - description: The URL of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.url - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: uXQ9gR5WLxSivonwSGHzzY - sortOrder: 14 - fieldKey: user_agent - label: User Agent - type: STRING - description: The user agent of the browser. - placeholder: '' - defaultValue: - '@path': $.context.userAgent - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: nguvw4VmBEsyLqFGst7XG1 - sortOrder: 15 - fieldKey: user_language - label: User Language - type: STRING - description: The language of the browser. - placeholder: '' - defaultValue: - '@path': $.context.locale - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: oz78bK2cF8sFigDCANLb7h - sortOrder: 16 - fieldKey: utc_time - label: UTC Time - type: STRING - description: The time of the event in UTC. - placeholder: '' - defaultValue: - '@path': $.timestamp - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: xAPQLtHC6VQSYwtg3Ag2i5 - sortOrder: 17 - fieldKey: utm - label: UTM - type: OBJECT - description: Information about the UTM parameters. - placeholder: '' - defaultValue: - source: - '@path': $.context.campaign.source - medium: - '@path': $.context.campaign.medium - name: - '@path': $.context.campaign.name - term: - '@path': $.context.campaign.term - content: - '@path': $.context.campaign.content - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: wd3zgVhgGgD59jJCYcxKN9 - sortOrder: 18 - fieldKey: screen - label: Screen - type: OBJECT - description: Information about the screen. - placeholder: '' - defaultValue: - height: - '@path': $.context.screen.height - width: - '@path': $.context.screen.width - density: - '@path': $.context.screen.density - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: jdHyDdR2DE8SfTNpfN2qt - sortOrder: 19 - fieldKey: timezone - label: Timezone - type: STRING - description: The timezone of the browser. - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.properties.timezone - then: - '@path': $.properties.timezone - else: - '@path': $.traits.timezone - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: ai1FtyAf7WV9EBPhC689FL - sortOrder: 20 - fieldKey: source_ip - label: IP Address - type: STRING - description: The IP address of the user. - placeholder: '' - defaultValue: - '@path': $.context.ip - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: eLtV6kjxhyWifZZU14HtJn - name: Track Event - slug: track - description: Sends a track event to Usermaven. - platform: CLOUD - hidden: false - defaultTrigger: null - fields: - - id: 2n8SZLssV3oyDQzbhpc5fy - sortOrder: 0 - fieldKey: event - label: Event Name - type: STRING - description: The event name - placeholder: '' - defaultValue: - '@path': $.event - required: true - multiple: false - choices: null - dynamic: false - allowNull: false - - id: euAJwe9DvAJiELYxRC41dB - sortOrder: 1 - fieldKey: event_attributes - label: Event Attributes - type: OBJECT - description: Attributes associated with the event - placeholder: '' - defaultValue: - '@path': $.properties - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: nzu6Pz6tfr9X7GjfqTpCcH - sortOrder: 2 - fieldKey: user_id - label: User id - type: STRING - description: The user id, to uniquely identify the user - placeholder: '' - defaultValue: - '@path': $.userId - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: vSWjC7UwheaF41DrVrNhcR - sortOrder: 3 - fieldKey: user_email - label: Email address - type: STRING - description: The user email address - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.properties.email - then: - '@path': $.properties.email - else: - '@path': $.context.traits.email - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: vvhfKj6dr9U6dDNtCXxtD8 - sortOrder: 4 - fieldKey: user_created_at - label: Created at - type: STRING - description: The timestamp when the user was created - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.properties.created_at - then: - '@path': $.properties.created_at - else: - '@path': $.context.traits.created_at - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: wQ11oJYCuk75r9TNM3tYmg - sortOrder: 5 - fieldKey: user_anonymous_id - label: Anonymous ID - type: STRING - description: User Anonymous id - placeholder: '' - defaultValue: - '@path': $.anonymousId - required: false - multiple: false - choices: null - dynamic: false - allowNull: true - - id: qcWiXJDgCQ3LSR99fpbQsH - sortOrder: 6 - fieldKey: event_id - label: Event ID - type: STRING - description: The ID of the event. - placeholder: '' - defaultValue: - '@path': $.messageId - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: ekmokJzDb2SUtf483vMk1P - sortOrder: 7 - fieldKey: doc_path - label: Document Path - type: STRING - description: The path of the document. - placeholder: '' - defaultValue: - '@path': $.context.page.path - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 71Nnfr22WKZPWhqmcKL1KQ - sortOrder: 8 - fieldKey: doc_search - label: Document Search - type: STRING - description: The search query of the document. - placeholder: '' - defaultValue: - '@path': $.context.page.search - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 9KFPCeR3zmb46VzHWjwago - sortOrder: 9 - fieldKey: event_type - label: Event Type - type: STRING - description: The type of the event. - placeholder: '' - defaultValue: - '@path': $.type - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: Wp2apRZ7muGj1dtMzYdyf - sortOrder: 10 - fieldKey: page_title - label: Page Title - type: STRING - description: The title of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.title - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: mLViGMv4hEgxzAhSidUZ1s - sortOrder: 11 - fieldKey: referer - label: Referrer - type: STRING - description: The referrer of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.referrer - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: kmsejfaGuMNQByyTMZWpWP - sortOrder: 12 - fieldKey: url - label: URL - type: STRING - description: The URL of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.url - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: jgD139s6JWNkA93MSJFxiX - sortOrder: 13 - fieldKey: user_agent - label: User Agent - type: STRING - description: The user agent of the browser. - placeholder: '' - defaultValue: - '@path': $.context.userAgent - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: pAa4Tia3bDWxLb16GfCBZ9 - sortOrder: 14 - fieldKey: user_language - label: User Language - type: STRING - description: The language of the browser. - placeholder: '' - defaultValue: - '@path': $.context.locale - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 3EkH5HZ41AdDnxGux7owND - sortOrder: 15 - fieldKey: utc_time - label: UTC Time - type: STRING - description: The time of the event in UTC. - placeholder: '' - defaultValue: - '@path': $.timestamp - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 7x5KudSAJ1NYv1KUdkpCBK - sortOrder: 16 - fieldKey: utm - label: UTM - type: OBJECT - description: Information about the UTM parameters. - placeholder: '' - defaultValue: - source: - '@path': $.context.campaign.source - medium: - '@path': $.context.campaign.medium - name: - '@path': $.context.campaign.name - term: - '@path': $.context.campaign.term - content: - '@path': $.context.campaign.content - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: aZbZ72ACb5Cnx1p41DwbBh - sortOrder: 17 - fieldKey: screen - label: Screen - type: OBJECT - description: Information about the screen. - placeholder: '' - defaultValue: - height: - '@path': $.context.screen.height - width: - '@path': $.context.screen.width - density: - '@path': $.context.screen.density - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: mkiePznZADL6bNR11ccZ93 - sortOrder: 18 - fieldKey: timezone - label: Timezone - type: STRING - description: The timezone of the browser. - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.properties.timezone - then: - '@path': $.properties.timezone - else: - '@path': $.traits.timezone - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: edk1MfyzLwZwUKrU2nDnuP - sortOrder: 19 - fieldKey: source_ip - label: IP Address - type: STRING - description: The IP address of the user. - placeholder: '' - defaultValue: - '@path': $.context.ip - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: qg6REVpUrbDEyU9oS6M9nZ - name: Group - slug: group - description: Send company attributes to Usermaven. - platform: CLOUD - hidden: false - defaultTrigger: null - fields: - - id: sh3owu8c1aCPoYEJjfv2Qo - sortOrder: 0 - fieldKey: company_id - label: Company id - type: STRING - description: The company id, to uniquely identify the company - placeholder: '' - defaultValue: - '@path': $.groupId - required: true - multiple: false - choices: null - dynamic: false - allowNull: false - - id: wPa3KGt7kqYvKsbtoC9qqC - sortOrder: 1 - fieldKey: user_id - label: User id - type: STRING - description: The user id, to uniquely identify the user - placeholder: '' - defaultValue: - '@path': $.userId - required: true - multiple: false - choices: null - dynamic: false - allowNull: false - - id: wKq54EoNb2N8nQRgeRUa2r - sortOrder: 2 - fieldKey: company_name - label: Company name - type: STRING - description: The company name - placeholder: '' - defaultValue: - '@path': $.traits.name - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 9aansDTgo4axVtxDwYtGUb - sortOrder: 3 - fieldKey: company_created_at - label: Company created at - type: STRING - description: The timestamp when the company was created - placeholder: '' - defaultValue: - '@path': $.traits.created_at - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 8RChgfe4udobJ53NFPk2ny - sortOrder: 4 - fieldKey: company_custom_attributes - label: Company custom attributes - type: OBJECT - description: The company custom attributes - placeholder: '' - defaultValue: - '@path': $.traits - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: fkEU3emnuTBgQNqz197Pbf - sortOrder: 5 - fieldKey: user_anonymous_id - label: Anonymous ID - type: STRING - description: User Anonymous id - placeholder: '' - defaultValue: - '@path': $.anonymousId - required: false - multiple: false - choices: null - dynamic: false - allowNull: true - - id: b8Grxf47tgaymCrFYxdKC2 - sortOrder: 6 - fieldKey: event_id - label: Event ID - type: STRING - description: The ID of the event. - placeholder: '' - defaultValue: - '@path': $.messageId - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: tqeBxjh5tygVJxcuNQap6W - sortOrder: 7 - fieldKey: doc_path - label: Document Path - type: STRING - description: The path of the document. - placeholder: '' - defaultValue: - '@path': $.context.page.path - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: n1tz8y7Vk7eHkCqVGqDqpG - sortOrder: 8 - fieldKey: doc_search - label: Document Search - type: STRING - description: The search query of the document. - placeholder: '' - defaultValue: - '@path': $.context.page.search - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 8SzzyK4YJSXmYD677x48YY - sortOrder: 9 - fieldKey: event_type - label: Event Type - type: STRING - description: The type of the event. - placeholder: '' - defaultValue: - '@path': $.type - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: ir8k3oeMxfwZ1qCxfL1A78 - sortOrder: 10 - fieldKey: page_title - label: Page Title - type: STRING - description: The title of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.title - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 6vjReNP8CS37MuVw4aQxje - sortOrder: 11 - fieldKey: referer - label: Referrer - type: STRING - description: The referrer of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.referrer - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: uoPEkMnNAsiUiUh2kbkzR8 - sortOrder: 12 - fieldKey: url - label: URL - type: STRING - description: The URL of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.url - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: qEtNvAsLT7XoZNX4NYQse2 - sortOrder: 13 - fieldKey: user_agent - label: User Agent - type: STRING - description: The user agent of the browser. - placeholder: '' - defaultValue: - '@path': $.context.userAgent - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 6fhugx5B84z4Lx6SkXfKor - sortOrder: 14 - fieldKey: user_language - label: User Language - type: STRING - description: The language of the browser. - placeholder: '' - defaultValue: - '@path': $.context.locale - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: gYvqqhf4iMwgN185B3hMuX - sortOrder: 15 - fieldKey: utc_time - label: UTC Time - type: STRING - description: The time of the event in UTC. - placeholder: '' - defaultValue: - '@path': $.timestamp - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: oxT7SYKvLMN424Wdz1x1sM - sortOrder: 16 - fieldKey: utm - label: UTM - type: OBJECT - description: Information about the UTM parameters. - placeholder: '' - defaultValue: - source: - '@path': $.context.campaign.source - medium: - '@path': $.context.campaign.medium - name: - '@path': $.context.campaign.name - term: - '@path': $.context.campaign.term - content: - '@path': $.context.campaign.content - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 3ust1dkkdzvtshCbBcYhBW - sortOrder: 17 - fieldKey: screen - label: Screen - type: OBJECT - description: Information about the screen. - placeholder: '' - defaultValue: - height: - '@path': $.context.screen.height - width: - '@path': $.context.screen.width - density: - '@path': $.context.screen.density - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: sjvgwBKB9iKWykF7EwmWyd - sortOrder: 18 - fieldKey: timezone - label: Timezone - type: STRING - description: The timezone of the browser. - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.properties.timezone - then: - '@path': $.properties.timezone - else: - '@path': $.traits.timezone - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: fyADYUMXK7L4G6ZcrKXTBg - sortOrder: 19 - fieldKey: source_ip - label: IP Address - type: STRING - description: The IP address of the user. - placeholder: '' - defaultValue: - '@path': $.context.ip - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: oPWRb2J53D99hbWYZe8CAo - name: Page - slug: page - description: Send pageview events to Usermaven. - platform: CLOUD - hidden: false - defaultTrigger: null - fields: - - id: gqKuCczrypPscaZDsbd1Xb - sortOrder: 0 - fieldKey: user_id - label: User id - type: STRING - description: The user id, to uniquely identify the user - placeholder: '' - defaultValue: - '@path': $.userId - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: dvRSNK2pXM7EcLbeVqg9sE - sortOrder: 1 - fieldKey: user_email - label: Email address - type: STRING - description: The user email address - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.properties.email - then: - '@path': $.properties.email - else: - '@path': $.context.traits.email - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: c9pMdDurL25jq8xLPuo3R4 - sortOrder: 2 - fieldKey: user_created_at - label: Created at - type: STRING - description: The timestamp when the user was created - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.properties.created_at - then: - '@path': $.properties.created_at - else: - '@path': $.context.traits.created_at - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: cRw19qoPZAH9YDxbedBAys - sortOrder: 3 - fieldKey: page_name - label: Page Name - type: STRING - description: The name of the page - placeholder: '' - defaultValue: - '@path': $.properties.name - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: jT1j6YiJx3T9uAg95iJAXc - sortOrder: 4 - fieldKey: user_anonymous_id - label: Anonymous ID - type: STRING - description: User Anonymous id - placeholder: '' - defaultValue: - '@path': $.anonymousId - required: false - multiple: false - choices: null - dynamic: false - allowNull: true - - id: pZnPSTHCrjMUmaQdbZeVHN - sortOrder: 5 - fieldKey: event_id - label: Event ID - type: STRING - description: The ID of the event. - placeholder: '' - defaultValue: - '@path': $.messageId - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: skBwtvoErnzcFnQmboKrwo - sortOrder: 6 - fieldKey: doc_path - label: Document Path - type: STRING - description: The path of the document. - placeholder: '' - defaultValue: - '@path': $.context.page.path - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 7E4LnrCaYRLDrJuFoKn7cC - sortOrder: 7 - fieldKey: doc_search - label: Document Search - type: STRING - description: The search query of the document. - placeholder: '' - defaultValue: - '@path': $.context.page.search - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: sXbG92qvkcVENkJBWbnGo3 - sortOrder: 8 - fieldKey: event_type - label: Event Type - type: STRING - description: The type of the event. - placeholder: '' - defaultValue: - '@path': $.type - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 6JerdPkPH9F2zzLRasmGVa - sortOrder: 9 - fieldKey: page_title - label: Page Title - type: STRING - description: The title of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.title - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: h6Z5GRoMSJ3f9ekh8apmP9 - sortOrder: 10 - fieldKey: referer - label: Referrer - type: STRING - description: The referrer of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.referrer - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 9ACL7AHihYvUzV7jjGyM5C - sortOrder: 11 - fieldKey: url - label: URL - type: STRING - description: The URL of the page where the event occurred. - placeholder: '' - defaultValue: - '@path': $.context.page.url - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 96Lhr6inykPkBs5Z8TiBK5 - sortOrder: 12 - fieldKey: user_agent - label: User Agent - type: STRING - description: The user agent of the browser. - placeholder: '' - defaultValue: - '@path': $.context.userAgent - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: hNXpSEx4eYjkQXWEdyMFRs - sortOrder: 13 - fieldKey: user_language - label: User Language - type: STRING - description: The language of the browser. - placeholder: '' - defaultValue: - '@path': $.context.locale - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: 2oyfB4ayAtYWU7mqinnroE - sortOrder: 14 - fieldKey: utc_time - label: UTC Time - type: STRING - description: The time of the event in UTC. - placeholder: '' - defaultValue: - '@path': $.timestamp - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: kwdo9Ea2DtACznKXLSmU5X - sortOrder: 15 - fieldKey: utm - label: UTM - type: OBJECT - description: Information about the UTM parameters. - placeholder: '' - defaultValue: - source: - '@path': $.context.campaign.source - medium: - '@path': $.context.campaign.medium - name: - '@path': $.context.campaign.name - term: - '@path': $.context.campaign.term - content: - '@path': $.context.campaign.content - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: vwR6kCrJqg64iBJo3egnEy - sortOrder: 16 - fieldKey: screen - label: Screen - type: OBJECT - description: Information about the screen. - placeholder: '' - defaultValue: - height: - '@path': $.context.screen.height - width: - '@path': $.context.screen.width - density: - '@path': $.context.screen.density - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: kcouWQ4RcRwB7Vzqb9ZDPw - sortOrder: 17 - fieldKey: timezone - label: Timezone - type: STRING - description: The timezone of the browser. - placeholder: '' - defaultValue: - '@if': - exists: - '@path': $.properties.timezone - then: - '@path': $.properties.timezone - else: - '@path': $.traits.timezone - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - - id: kNpF1HohXZH2FMnA7kJrKa - sortOrder: 18 - fieldKey: source_ip - label: IP Address - type: STRING - description: The IP address of the user. - placeholder: '' - defaultValue: - '@path': $.context.ip - required: false - multiple: false - choices: null - dynamic: false - allowNull: false - presets: - - actionId: 8gRstXiw7PFVv2UYWS1xnb - name: Identify User - fields: - user_id: - '@path': $.userId - user_email: - '@if': - exists: - '@path': $.traits.email - then: - '@path': $.traits.email - else: - '@path': $.properties.email - user_created_at: - '@path': $.traits.created_at - user_first_name: - '@if': - exists: - '@path': $.traits.first_name - then: - '@path': $.traits.first_name - else: - '@path': $.properties.first_name - user_last_name: - '@if': - exists: - '@path': $.traits.last_name - then: - '@path': $.traits.last_name - else: - '@path': $.properties.last_name - user_custom_attributes: - '@path': $.traits - user_anonymous_id: - '@path': $.anonymousId - event_id: - '@path': $.messageId - doc_path: - '@path': $.context.page.path - doc_search: - '@path': $.context.page.search - event_type: - '@path': $.type - page_title: - '@path': $.context.page.title - referer: - '@path': $.context.page.referrer - url: - '@path': $.context.page.url - user_agent: - '@path': $.context.userAgent - user_language: - '@path': $.context.locale - utc_time: - '@path': $.timestamp - utm: - source: - '@path': $.context.campaign.source - medium: - '@path': $.context.campaign.medium - name: - '@path': $.context.campaign.name - term: - '@path': $.context.campaign.term - content: - '@path': $.context.campaign.content - screen: - height: - '@path': $.context.screen.height - width: - '@path': $.context.screen.width - density: - '@path': $.context.screen.density - timezone: - '@if': - exists: - '@path': $.properties.timezone - then: - '@path': $.properties.timezone - else: - '@path': $.traits.timezone - source_ip: - '@path': $.context.ip - trigger: type = "identify" - - actionId: qg6REVpUrbDEyU9oS6M9nZ - name: Group - fields: - company_id: - '@path': $.groupId - user_id: - '@path': $.userId - company_name: - '@path': $.traits.name - company_created_at: - '@path': $.traits.created_at - company_custom_attributes: - '@path': $.traits - user_anonymous_id: - '@path': $.anonymousId - event_id: - '@path': $.messageId - doc_path: - '@path': $.context.page.path - doc_search: - '@path': $.context.page.search - event_type: - '@path': $.type - page_title: - '@path': $.context.page.title - referer: - '@path': $.context.page.referrer - url: - '@path': $.context.page.url - user_agent: - '@path': $.context.userAgent - user_language: - '@path': $.context.locale - utc_time: - '@path': $.timestamp - utm: - source: - '@path': $.context.campaign.source - medium: - '@path': $.context.campaign.medium - name: - '@path': $.context.campaign.name - term: - '@path': $.context.campaign.term - content: - '@path': $.context.campaign.content - screen: - height: - '@path': $.context.screen.height - width: - '@path': $.context.screen.width - density: - '@path': $.context.screen.density - timezone: - '@if': - exists: - '@path': $.properties.timezone - then: - '@path': $.properties.timezone - else: - '@path': $.traits.timezone - source_ip: - '@path': $.context.ip - trigger: type = "group" - - actionId: oPWRb2J53D99hbWYZe8CAo - name: Page - fields: - user_id: - '@path': $.userId - user_email: - '@if': - exists: - '@path': $.properties.email - then: - '@path': $.properties.email - else: - '@path': $.context.traits.email - user_created_at: - '@if': - exists: - '@path': $.properties.created_at - then: - '@path': $.properties.created_at - else: - '@path': $.context.traits.created_at - page_name: - '@path': $.properties.name - user_anonymous_id: - '@path': $.anonymousId - event_id: - '@path': $.messageId - doc_path: - '@path': $.context.page.path - doc_search: - '@path': $.context.page.search - event_type: - '@path': $.type - page_title: - '@path': $.context.page.title - referer: - '@path': $.context.page.referrer - url: - '@path': $.context.page.url - user_agent: - '@path': $.context.userAgent - user_language: - '@path': $.context.locale - utc_time: - '@path': $.timestamp - utm: - source: - '@path': $.context.campaign.source - medium: - '@path': $.context.campaign.medium - name: - '@path': $.context.campaign.name - term: - '@path': $.context.campaign.term - content: - '@path': $.context.campaign.content - screen: - height: - '@path': $.context.screen.height - width: - '@path': $.context.screen.width - density: - '@path': $.context.screen.density - timezone: - '@if': - exists: - '@path': $.properties.timezone - then: - '@path': $.properties.timezone - else: - '@path': $.traits.timezone - source_ip: - '@path': $.context.ip - trigger: type = "page" - - actionId: eLtV6kjxhyWifZZU14HtJn - name: Track Event - fields: - event: - '@path': $.event - event_attributes: - '@path': $.properties - user_id: - '@path': $.userId - user_email: - '@if': - exists: - '@path': $.properties.email - then: - '@path': $.properties.email - else: - '@path': $.context.traits.email - user_created_at: - '@if': - exists: - '@path': $.properties.created_at - then: - '@path': $.properties.created_at - else: - '@path': $.context.traits.created_at - user_anonymous_id: - '@path': $.anonymousId - event_id: - '@path': $.messageId - doc_path: - '@path': $.context.page.path - doc_search: - '@path': $.context.page.search - event_type: - '@path': $.type - page_title: - '@path': $.context.page.title - referer: - '@path': $.context.page.referrer - url: - '@path': $.context.page.url - user_agent: - '@path': $.context.userAgent - user_language: - '@path': $.context.locale - utc_time: - '@path': $.timestamp - utm: - source: - '@path': $.context.campaign.source - medium: - '@path': $.context.campaign.medium - name: - '@path': $.context.campaign.name - term: - '@path': $.context.campaign.term - content: - '@path': $.context.campaign.content - screen: - height: - '@path': $.context.screen.height - width: - '@path': $.context.screen.width - density: - '@path': $.context.screen.density - timezone: - '@if': - exists: - '@path': $.properties.timezone - then: - '@path': $.properties.timezone - else: - '@path': $.traits.timezone - source_ip: - '@path': $.context.ip - trigger: type = "track" diff --git a/src/_data/catalog/slugs.yml b/src/_data/catalog/slugs.yml index e4025017eb..ad61a11647 100644 --- a/src/_data/catalog/slugs.yml +++ b/src/_data/catalog/slugs.yml @@ -229,4 +229,7 @@ destinations: override: "actions-amazon-amc" - original: "display-and-video-360-actions" override: "actions-display-video-360" - + - original: "usermaven-actions" + override: "actions-usermaven" + - original: "survicate-actions" + override: "actions-survicate" \ No newline at end of file diff --git a/src/_data/catalog/source_categories.yml b/src/_data/catalog/source_categories.yml index 16d588e8e0..1fd64b6e7c 100644 --- a/src/_data/catalog/source_categories.yml +++ b/src/_data/catalog/source_categories.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# source categories last updated 2024-07-30 +# source categories last updated 2024-08-01 items: - display_name: A/B Testing slug: a-b-testing diff --git a/src/_data/catalog/sources.yml b/src/_data/catalog/sources.yml index de31928c17..22cae65001 100644 --- a/src/_data/catalog/sources.yml +++ b/src/_data/catalog/sources.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# sources last updated 2024-07-30 +# sources last updated 2024-08-01 items: - id: 8HWbgPTt3k display_name: .NET diff --git a/src/connections/destinations/catalog/actions-listrak/images/mappings1.png b/src/connections/destinations/catalog/actions-listrak/images/mappings1.png new file mode 100644 index 0000000000..552067cdd4 Binary files /dev/null and b/src/connections/destinations/catalog/actions-listrak/images/mappings1.png differ diff --git a/src/connections/destinations/catalog/actions-listrak/images/mappings2.png b/src/connections/destinations/catalog/actions-listrak/images/mappings2.png new file mode 100644 index 0000000000..a7f5f1cfb2 Binary files /dev/null and b/src/connections/destinations/catalog/actions-listrak/images/mappings2.png differ diff --git a/src/connections/destinations/catalog/actions-listrak/images/subscription1.png b/src/connections/destinations/catalog/actions-listrak/images/subscription1.png new file mode 100644 index 0000000000..c7e4c39408 Binary files /dev/null and b/src/connections/destinations/catalog/actions-listrak/images/subscription1.png differ diff --git a/src/connections/destinations/catalog/actions-listrak/images/subscription2.png b/src/connections/destinations/catalog/actions-listrak/images/subscription2.png new file mode 100644 index 0000000000..4386a93ed4 Binary files /dev/null and b/src/connections/destinations/catalog/actions-listrak/images/subscription2.png differ diff --git a/src/connections/destinations/catalog/actions-listrak/index.md b/src/connections/destinations/catalog/actions-listrak/index.md index 40ef2f72b0..40ff578cd3 100644 --- a/src/connections/destinations/catalog/actions-listrak/index.md +++ b/src/connections/destinations/catalog/actions-listrak/index.md @@ -22,36 +22,66 @@ To add the Listrak Actions destination: 7. In the same section of the **Settings** tab, enter your Listrak API client ID and client secret. 8. Click **Save Changes**. 9. Follow the steps in the Destinations Actions documentation to [customize mappings](/docs/connections/destinations/actions/#customize-mappings) or follow the steps below to Sync an Engage Audience. -10. Enable the destination and click **Save Changes**. - -### Sync an Engage Audience - -To sync an Engage audience with your Listrak (Actions) destination: - -1. Each Engage audience to be synced to Listrak must only include email addresses subscribed to the list. To do this, add a condition to the Engage audience that ensures the custom trait for the list exists (eg. have a Custom Trait listrak_list_12345 exists, where 12345 is the list ID). -2. In Listrak, go to **Contacts > Profile Fields** and click **Create Field Group**. -3. Enter a name for the Profile Field Group (eg. `Engage Audiences`) and Click **Save**. -4. Enter a name for the audience for the **Field Name**. -5. Select **Check Box** for the **Data Type**. -6. Click the **Update** button. -7. Go to **Help & Support > API ID Information** and note the list ID and profile field ID. -8. In Segment, open the previously created Listrak destination. -9. In the **Mappings** tab, click **New Mapping** and select **Update Email Contact Profile Fields**. -10. Under **Select events to map and send**, select **Track** for the **Event Type**. -11. Click **Add Condition** and add this condition: **Event Name** is `Audience Entered`. -12. Click **Add Condition** and add this condition: **Event Property** `audience_key` is `my_audience` (where `my_audience` is the Audience Key found on the Audience settings page). -13. Under **Select mappings**, enter the list ID and map the email address if `context.traits.email` is not desired. -14. Under **Select mappings**, in the section for mapping the `Profile Field Values`, enter the profile field ID for the `Enter Key Name` textbox on the right and `on` in the textbox for its value to the left. Click **Save**. -15. Repeat steps 9 through 14 using `Audience Exited` instead of `Audience Entered` in step 11 and `off` instead of `on` in step 14. -16. **Enable** both mappings. -17. Go to the **Settings** tab for the destination and **Enable** the destination. Click **Save Changes**. -18. Select the Engage space and navigate to **Engage > Audiences**. Select the source audience to send to the Listrak destination. -19. Click **Add Destination** and select the Listrak Audience destination. -20. In the connection settings that appear on the right-hand side, ensure that the toggle to **Send Track** events is _enabled_, and the toggle to **Send Identify** events is _disabled_. -21. Click **Save**. -22. To filter email sends in Listrak using the new audience profile field, see the [help article](https://help.listrak.com/en/articles/3951597-introduction-to-building-filter-2-0-segments){:target="_blank”}. -23. Repeat steps 1 through 21, if you want to sync another audience. + +## Syncing an Engage audience to Listrak + +To sync an Engage audience with Listrak (Actions), first ensure that the Engage audience only includes profiles with email addresses subscribed to the Listrak list. + +For example, when you build the audience, ensure each profile includes a Custom Trait like `listrak_list_12345`, where `12345` is the List ID. + +### Listrak configuration + +1. In Listrak, navigate to **Contacts > Profile Fields** and click **Create Field Group**. +2. Enter a name for the Profile Field Group (like `Engage Audiences`) and click **Save**. +3. Enter a name for the audience in the **Field Name** field. +4. Select **Check Box** for the **Data Type**. +5. Click **Update**. +6. Go to **Help & Support > API ID Information** and note the List ID and Profile Field ID values. You'll use these in your Segment destination. + +### Segment configuration + +In Segment, open the Listrak destination you created. Navigate to the **Mappings** tab, click **New Mapping**, and select **Update Email Contact Profile Fields**. + +You can configure the "Update Email Contact Profile Fields" mapping in two ways: + +1. **Separate Mappings:** Create individual mappings for "Audience Entered" and "Audience Exited" events. Set the profile field to "on" for "Audience Entered" and "off" for "Audience Exited." +2. **Single Mapping:** Use one mapping with the special value `useAudienceKey` for the profile field. This will dynamically use "on" and "off" in the request made to Listrak based on the `audience_key` boolean value - `true` ("Audience Entered") activates the field, and `false` ("Audience Exited") deactivates it. + +### Recommended approach: single mapping for both events + +1. To use a single mapping for "Audience Entered" and "Audience Exited" events, under **Select events to map and send**, configure a condition to include events from the desired audience only. +- Set **Event Context** `personas.computation_key` to `my_audience` (where `my_audience` is the Audience Key from the Audience settings page). + + ![Mapping Subscription](images/subscription1.png) + +2. Under **Select mappings**, enter the Listrak List ID and map the email address if `context.traits.email` is not needed. +3. In the **Profile Field Values** section, enter the Listrak Profile Field ID in the `Enter Key Name` textbox on the right, and type `useAudienceKey` in the textbox on the left. +- This configuration will activate the profile field based on the boolean value in the Audience payload: "true" activates the field for "Audience Entered," and "false" deactivates it for "Audience Exited." + + + ![Mapping Subscription](images/mappings1.png) + +4. Click **Save** to save the mapping. + +### Alternative approach: separate mappings for each event + +1. Under **Select events to map and send**, select **Track** for the **Event Type**. +2. Click **Add Condition** and add: **Event Name** is `Audience Entered`. +3. Click **Add Condition** and add: **Event Property** `audience_key` is `my_audience` (where `my_audience` is the Audience Key from the Audience settings page). + + ![Mapping Subscription](images/subscription2.png) + +5. Under **Select mappings**, enter the Listrak List ID and map the email address if `context.traits.email` is not needed. +6. In the **Profile Field Values** section, enter the Listrak Profile Field ID in the `Enter Key Name` textbox on the right, and type `on` in the textbox on the left. This will activate the profile field in Listrak. + + ![Mapping Subscription](images/mappings2.png) + +6. Click **Save** to save the mapping. +7. Repeat the previous steps, substituting `Audience Entered` for `Audience Exited` and `on` for `off`. + +## Using Segment audience data in Listrak + +To filter email sends in Listrak using the new audience profile field, refer to the [help article](https://help.listrak.com/en/articles/3951597-introduction-to-building-filter-2-0-segments){:target="_blank"}. {% include components/actions-fields.html %} ---- diff --git a/src/connections/destinations/catalog/actions-survicate/index.md b/src/connections/destinations/catalog/actions-survicate/index.md index 3ccd0f53e6..8df29e7707 100644 --- a/src/connections/destinations/catalog/actions-survicate/index.md +++ b/src/connections/destinations/catalog/actions-survicate/index.md @@ -1,7 +1,7 @@ --- -rewrite: true title: Survicate (Actions) Destination id: 65a6ac19ea6d3ced628be00b +beta: true --- [Survicate](https://survicate.com/integrations/segment-survey/?utm_source=segment&utm_medium=referral){:target="_blank”} is a complete toolkit for customer feedback. diff --git a/src/connections/destinations/catalog/usermaven/index.md b/src/connections/destinations/catalog/actions-usermaven/index.md similarity index 50% rename from src/connections/destinations/catalog/usermaven/index.md rename to src/connections/destinations/catalog/actions-usermaven/index.md index 5765b271bf..9333c30ebf 100644 --- a/src/connections/destinations/catalog/usermaven/index.md +++ b/src/connections/destinations/catalog/actions-usermaven/index.md @@ -1,18 +1,11 @@ --- -# The end name should be similar to `Slack Destination` -title: Usermaven Destination -hide-boilerplate: true -hide-dossier: true +title: Usermaven (Actions) Destination id: 643fdf094cfdbcf1bcccbc42 -private: true +beta: true --- - - {% include content/plan-grid.md name="actions" %} - - [Usermaven](https://www.usermaven.com){:target="_blank"} is an all-in-one analytics solution for online businesses looking to unlock growth and make data-driven decisions - without spending hours on setup. @@ -25,23 +18,15 @@ Usermaven (Actions) provides the following benefits: - **No 3rd party tool is involved.** Move the data directly from Segment to Usermaven without a 3rd party tool to facilitate the data sync. - **Track events, identify users and companies.** You can track events, identify users and companies in Usermaven using Actions-based destinations. - ## Getting started 1. From the Segment web app, click **Catalog**, then click **Destinations**. -2. Search for "usermaven" in the Destinations Catalog, and select the destination. -3. Click **Configure Usermaven**. +2. Search for "Usermaven (Actions)" in the Destinations Catalog, and select the destination. +3. Click **Configure Usermaven (Actions)**. 4. Select an existing Source to connect to Usermaven (Actions). 5. Go to the [Usermaven App](https://app.usermaven.com){:target="_blank"}, and navigate to **Workspace Settings** > **General Settings** and copy the **API Key**. 6. Enter the "API Key" in the "Usermaven (Actions)" destination settings in Segment. - {% include components/actions-fields.html %} - - diff --git a/src/engage/audiences/linked-audiences.md b/src/engage/audiences/linked-audiences.md index 64967b3dec..2936dc5c02 100644 --- a/src/engage/audiences/linked-audiences.md +++ b/src/engage/audiences/linked-audiences.md @@ -58,9 +58,9 @@ Optionally, select a folder to add this audience. ### Maintaining Linked Audiences -After creating your Linked Audience, you will be brought to the Overview page with the Linked Audience in a disabled state. On the Overview page, you can view relevant audience information, such as Profiles in Audience, Run Schedule, Latest run, Next compute. You can edit or delete your Linked Audience. +After creating your Linked Audience, you will be brought to the Overview page with the Linked Audience in a disabled state. On the Overview page, you can view relevant audience information, such as Profiles in audience, Run schedule, Latest run, and Next run. -If you edit an audience with configured activation events, you should disable or delete impacted events for your audience to successfully compute. Events are impacted if they reference entities that are edited or removed from the audience definition. +You can also delete Linked Audiences from the menu options or edit your Linked Audience in the Builder tab. If you edit an audience with configured activation events, you should disable or delete impacted events for your audience to successfully compute. Events are impacted if they reference entities that are edited or removed from the audience definition. You can also clone your linked audience to the same space from the List and Overview pages. Cloning a linked audience creates a new linked audience in the builder create flow with the same conditions as the linked audience that was cloned. @@ -68,27 +68,34 @@ You can also clone your linked audience to the same space from the List and Over The linked audiences builder sources profile trait and event keys from the data warehouse. This data must be synced to the data warehouse through [Profiles Sync](/docs/unify/profiles-sync/overview/) before you can reference it in the linked audience builder. If there is a profile trait that exists in the Segment Profile that hasn’t successfully synced to the data warehouse yet, it will be grayed out so that it can’t be selected. -The linked audience builder also returns a subset of available entity property key values, event property and context key values, and profile trait key values that you can select in the input field drop-down so that you don’t need to type in the exact value that you want to filter on.If you don’t see the value you’re looking for, you can manually enter it into the input field. Segment displays +The linked audience builder also returns a subset of available entity property key values, event property and context key values, and profile trait key values that you can select in the input field drop-down so that you don’t need to type in the exact value that you want to filter on. If you don’t see the value you’re looking for, you can manually enter it into the input field. +Segment displays: * the first 100 unique string entity property values from the data warehouse. - * If you want to opt out of displaying entity property values from the data warehouse, contact Segment Support. * the top 65 event property and context key values. * the top 65 profile trait key values. -You can only create nested entity conditions up to six levels in depth. For example, an entity condition that queries for relationships between Profiles, Accounts, Credit Cards, and Transactions has four levels of depth. +You can duplicate your conditions in the audience builder into the same condition group.You can only create nested entity conditions up to six levels in depth. For example, an entity condition that queries for relationships between Profiles, Accounts, Credit Cards, and Transactions has four levels of depth. As you're building your Linked Audience, you can choose from the following conditions: -| Profiles Conditions | Description | +| Conditions | Description | |---------------------------|---------------------------------------| -| with entity | Creates a condition that filters profiles associated with entity relationships defined in the [Data Graph](/docs/unify/data-graph/). With this condition, you can navigate the full, nested entity relationships, and filter your audience on entity column values. The event condition type supports these configurations: at least: supports 1 or greater, exactly: supports 0 or greater, at most: supports 0 or greater* *When filtering by 0, you can’t filter on by entity properties or on additional nested entities. -| without entity | Creates a condition that filters profiles that are not associated with entity relationships defined in the [Data Graph](/docs/unify/linked-profiles/data-graph/). +| with entity | Creates a condition that filters profiles associated with entity relationships defined in the [Data Graph](/docs/unify/linked-profiles/data-graph/). With this condition, you can navigate the full, nested entity relationships, and filter your audience on entity column values.| +| without entity | Creates a condition that filters profiles that are not associated with entity relationships defined in the [Data Graph](/docs/unify/linked-profiles/data-graph/). With this condition, you can navigate the full, nested entity relationships, and filter your audience on entity column values.| | with [ trait](/docs/unify/#enrich-profiles-with-traits) | Creates a condition that filters profiles with a specific trait. | | without [ trait](/docs/unify/#enrich-profiles-with-traits)| Creates a condition that filters profiles without a specific trait.| | part of [audience](/docs/glossary/#audience) | Creates a condition that filters profiles that are part of an existing audience. | | not part of [audience](/docs/glossary/#audience) | Creates a condition that filters profiles that are not part of an existing audience. | -| with [event](/docs/glossary/#event) | Creates a condition that filters profiles that have a specific event in their event history. You can also filter on event property values. The event condition type supports these configurations: at least: supports 1 or greater, exactly: supports 0 or greater, at most: supports 0 or greater| -| without [event](/docs/glossary/#event) | Creates a condition that filters profiles that do not have a specific event in their event history. You can also filter on event property values. You can also duplicate your conditions in the audience builder into the same condition group.| +| with [event](/docs/glossary/#event) | Creates a condition that filters profiles that have a specific event in their event history. You can also filter on event property values.| +| without [event](/docs/glossary/#event) | Creates a condition that filters profiles that do not have a specific event in their event history. You can also filter on event property values.| + +The entity and event condition type supports these configurations: +at least: supports 1 or greater, +exactly: supports 0 or greater, +at most: supports 0 or greater. + +*When filtering by 0, you can’t filter on by entity properties or on additional nested entities. #### Operator Selection @@ -102,7 +109,7 @@ You can create audience definitions using either `AND` or `OR` operators across If you have defined entity conditions in your audience definition, you will see a “Matched Entities” tab in the audience preview to help you understand what entities qualified a user to be a part of an audience. -This information appears when you click the user profile generated from the audience preview. The contextual information encompasses entity relationships as well as entity column values that were used as filtering criteria in the audience definition. By default, Segment includes the entity ID.The data being returned is truncated - 10 entities at each level, 6 levels of depth. If you want to opt out of this functionality, contact Segment Support. +This information appears when you click the user profile generated from the audience preview. The contextual information encompasses entity relationships as well as entity column values that were used as filtering criteria in the audience definition. By default, Segment includes the entity ID. The data being returned is truncated - 10 entities at each level, 6 levels of depth. If you want to opt out of this functionality, contact Segment Support. ![A screenshot of the Entity Explorer.](/docs/engage/images/entity_explorer.png) @@ -110,13 +117,11 @@ This information appears when you click the user profile generated from the audi **Event Conditions** -When filtering on event properties, you can dynamically reference the value of another profile trait, or enter a constant value. These operators support dynamic references: -equals, not equals, less than, greater than, less than or equal, greater than or equal, contains, does not contain, starts with, ends with. +When filtering on event properties, you can dynamically reference the value of another profile trait, or enter a constant value. These operators support dynamic references: equals, not equals, less than, greater than, less than or equal, greater than or equal, contains, does not contain, starts with, ends with. **Entity Conditions** -When filtering on entity properties, you can dynamically reference the value of another entity column (from the same entity branch at the same level or above it), profile trait, or enter a constant value. -You can only dynamically reference properties of the same data type. Dynamic references are only supported for certain operators depending on the data type: +When filtering on entity properties, you can dynamically reference the value of another entity column (from the same entity branch at the same level or above it), profile trait, or enter a constant value.You can only dynamically reference properties of the same data type. Dynamic references are only supported for certain operators depending on the data type: NUMBER data type: equals, not equals, less than, greater than, less than or equal, greater than or equal STRING data type: equals, not equals, contains, does not contain, starts with, ends with TIMESTAMP data type: equals, not equals, less than, greater than, less than or equal, greater than or equal diff --git a/src/engage/trait-activation/id-sync.md b/src/engage/trait-activation/id-sync.md index 2808e835ff..ad2db82f35 100644 --- a/src/engage/trait-activation/id-sync.md +++ b/src/engage/trait-activation/id-sync.md @@ -4,7 +4,7 @@ beta: true plan: engage-foundations --- -Use ID Sync to select identifiers and a sync strategy when you send Audience or Journeys data to your destinations. Configure how you send identifiers, which provides more control over the data you send downstream. +Use ID Sync to select identifiers and a sync strategy when you send Audience or Journeys data to your destinations or destination functions. Configure how you send identifiers, which provides more control over the data you send downstream. On this page, you'll learn how to configure and begin using ID Sync. @@ -18,7 +18,7 @@ To set up ID Sync with [Audiences](/docs/engage/audiences/): 1. Navigate to **Engage** > **Audiences**. 2. [Create a new Audience](/docs/engage/audiences/). From the **Select Destination** tab in the Audience builder, select your destination. -- If you don't see any destinations to add, you'll need to [add the destination](/docs/connections/destinations/add-destination/#adding-a-destination) to your Engage space first. +- If you don't see any destinations to add, you'll need to [add the destination](/docs/connections/destinations/add-destination/#adding-a-destination) or [destination function](docs/connections/functions/destination-functions/#create-a-destination-function) to your Engage space first. - For existing audiences, you'll find your connected destination on the Audience Overview page. 3. In the **Event Settings** section, you'll see two options: **Default Setup** and **Customized Setup**. To use ID Sync, select [**Customized Setup**](#customized-setup). @@ -27,7 +27,7 @@ To set up ID Sync with [Audiences](/docs/engage/audiences/): You can configure ID Sync with Journeys as you're creating or editing your journey in the [builder](/docs/engage/journeys/build-journey/). 1. From a journey step, select the destination you're going to use with ID Sync. -2. On the Connection Settings tab, select **Customized Setup** and use the corresponding [steps below](#customized-setup) to customize which identifiers you want to map downstream to your destination. +2. On the Connection Settings tab, select **Customized Setup** and use the corresponding [steps below](#customized-setup) to customize which identifiers you want to map downstream to your destination. ### Default setup @@ -41,7 +41,7 @@ With Customized setup, you can choose which identifiers you want to map downstre 1. Using **Customized Setup**, click **+ Add Identifier** and add the identifiers: - **Segment**: Choose your identifiers from Segment. -- **Destination**: Choose which identifiers you want to map to from your destination. If the destination doesn't contain the property, then outgoing events may not be delivered to your destination. +- **Destination**: Choose which identifiers you want to map to from your destination. If the destination doesn't contain the property, then outgoing events may not be delivered. - *Facebook Custom Audiences* and *Google Ads Remarketing Lists* display a dropdown for you to choose available identifiers. 2. Add an ID strategy. - This is a strategy for a particular identifier which sends either the `last added`, `first added`, or `all` identifiers to your destination. @@ -51,23 +51,22 @@ With Customized setup, you can choose which identifiers you want to map downstre - Segment recommends using ID Sync with new audiences. - ID sync configuration changes apply to new data flowing after about five minutes. Changes don't apply to active or running syncs. -- ID Sync used on existing audience destinations doesn't resync the entire audience. Only new data flowing into Segment follows your ID Sync configuration. +- ID Sync used on existing audience destinations or destination functions won't resync the entire audience. Only new data flowing into Segment follows your ID Sync configuration. - Segment doesn't maintain ID Sync history, which means that any changes are irreversible. - You can only select a maximum of three identifiers with an `All` strategy. ## FAQs -#### What's the difference between Trait Enrichment and ID Sync? +#### What's the difference between Trait Enrichment and ID Sync? -**Trait Enrichment** maps the traits data you've collected with Engage to use when syncing audiences and Journeys to destinations. +**Trait Enrichment** lets you map the traits data you've collected with Engage to use when syncing audiences and Journeys to destinations and destination functions. -**ID Sync** maps the identities data gathered for a profile for use when syncing audiences and Journeys to destinations. +**ID Sync** lets you map the identities data gathered for a profile for use when syncing audiences and Journeys to destinations and destination functions. #### How do syncs differ between audiences with ID Sync and audiences without ID Sync? Audiences without ID Sync aren't allowed to select any strategy, and by default will send all values of an identifier to the destination. Also, audiences without ID Sync don't send any custom identifiers that are present in your space. - #### Can I edit config once the audience has synced? -Yes, you can edit configuration in the Destination **Settings** tab at any time. However, changes will only take place in subsequent audience syncs, or in new audiences connected to the destination. +Yes, you can edit configuration in the Destination **Settings** tab at any time. However, changes will only take place in subsequent audience syncs, or in new audiences connected to the destination. \ No newline at end of file diff --git a/src/engage/trait-activation/index.md b/src/engage/trait-activation/index.md index 609af86651..583d89fa5a 100644 --- a/src/engage/trait-activation/index.md +++ b/src/engage/trait-activation/index.md @@ -7,9 +7,9 @@ redirect_from: - 'engage/trait-activation/trait-activation-setup' --- -Use Trait Activation to configure sync payloads that you send from Engage Audiences and Journeys to a Destination. Map traits from user profiles to Destinations, configure identifiers to sync, and choose a sync strategy that fits your use cases. +Use Trait Activation to configure sync payloads that you send from Engage Audiences and Journeys to a Destination or Destination Function. Map traits from user profiles to Destinations, configure identifiers to sync, and choose a sync strategy that fits your use cases. -Trait Activation includes both [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/) and [ID Sync](/docs/engage/trait-activation/id-sync/). With Trait Enrichment, use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations. Use ID Sync to select identifiers and a sync strategy for each identifier when syncing Engage Audiences to Destinations. +Trait Activation includes both [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/) and [ID Sync](/docs/engage/trait-activation/id-sync/). With Trait Enrichment, use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations or destination functions. Use ID Sync to select identifiers and a sync strategy for each identifier when syncing Engage Audiences to Destinations. ## Trait Activation setup @@ -26,7 +26,8 @@ Select your destination, view its Segment documentation, then follow the corresp |Destination | Type | | [Facebook Custom Audiences](/docs/connections/destinations/catalog/personas-facebook-custom-audiences/) | List | | [Google Ads Remarketing Lists](/docs/connections/destinations/catalog/adwords-remarketing-lists/#overview) | List | -| Trait Activation also supports all cloud-mode [Destination Actions](/docs/connections/destinations/actions/#available-actions-based-destinations). | | +| [Destination Actions](/docs/connections/destinations/actions/#available-actions-based-destinations). | Actions | +| [Destination Functions](/docs/connections/functions/destination-functions/#create-a-destination-function) | Function | ### Resyncs @@ -53,7 +54,7 @@ Trait Enrichment and ID Sync can help you: To learn more about Trait Activation, visit the following docs: -- Learn more about how to access Segment profile traits when you sync Audiences and Journeys to Destinations with [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/). +- Learn more about how to access Segment profile traits when you sync Audiences and Journeys to Destinations or Destination Functions with [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/). - Learn how to sync select identifiers and create a sync strategy with [ID Sync](/docs/engage/trait-activation/id-sync/). diff --git a/src/engage/trait-activation/trait-enrichment.md b/src/engage/trait-activation/trait-enrichment.md index 6d9545f966..7dfb354310 100644 --- a/src/engage/trait-activation/trait-enrichment.md +++ b/src/engage/trait-activation/trait-enrichment.md @@ -4,7 +4,7 @@ beta: true plan: engage-foundations --- -Use Trait Enrichment to access Segment profile traits when you sync Audiences and Journeys to Destinations. With Trait Enrichment, you can use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations. +Use Trait Enrichment to access Segment profile traits when you sync Audiences and Journeys to Destinations and Destination Functions. With Trait Enrichment, you can use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations. ## Set up Trait Enrichment @@ -14,7 +14,7 @@ Use the following steps to set up Trait Enrichment with Audiences or Journeys. > info "" > The setup steps you'll use for Trait Enrichment depend on the type of destination [you've connected](/docs/engage/trait-activation/trait-activation-setup/). > - For Facebook Custom Audiences and Google Adwords, [use these destination requirements](#destination-requirements). -> - If you're using Destination Actions, such as Salesforce Marketing Cloud, Braze Actions, or Salesforce Actions, use the [Destination Actions setup steps](#destination-actions-setup). +> - If you're using Destination Actions, like Salesforce Marketing Cloud, Braze Actions, or Salesforce Actions, or [Destination Functions](/docs/connections/functions/destination-functions/), use the [Destination Actions and Destination Functions setup steps](#destination-actions-and-destination-functions-setup). ### Set up Trait Enrichment with Audiences @@ -43,10 +43,10 @@ You can customize event settings at any time. ### Customized setup -With Customized setup, you can choose which traits you want to map to your destination. +With Customized setup, you can choose which traits you want to map to your destination or destination function. 1. Click **Customized Setup**, then click **Add Trait**. -2. Select all traits you want to sync to your destination, and click **Save**. +2. Select all traits you want to sync and click **Save**. - Use the **Segment** column to select traits from the Segment Spec. - Use the **Destination** column to select which traits you want to map to in your destination. By default, Segment attempts to find traits with matching names. 3. Click **Save** and finish building your audience or journey. @@ -122,14 +122,14 @@ Each trait you select must map to a Facebook key. Additionally, you can only map one trait per audience to Google as a phone number. -## Destination Actions setup +## Destination Actions and Destination Functions setup -If you're using [Destination Actions](/docs/connections/destinations/actions/), use the following steps to set up Trait Enrichment. +If you're using [Destination Actions](/docs/connections/destinations/actions/) or [Destination Functions](/docs/connections/functions/destination-functions/), use the following steps to set up Trait Enrichment. 1. Navigate to **Engage > Engage settings**. -2. Select the Destinations tab, then click **+ Add Destination**. Trait Activation supports all [Destination Actions](/docs/connections/destinations/actions/). -3. Enter your destination credentials. -4. Navigate to **Engage > Audiences**, and click **+ Create**. +2. Select the Destinations tab, then click **+ Add Destination**. Trait Activation supports all [Destination Actions](/docs/connections/destinations/actions/) and [Destination Functions](docs/connections/functions/destination-functions/). +3. Select your destination or function. +4. Navigate to **Engage > Audiences**, and click **+ New audience**. 5. From the Select Destinations screen in the Audience builder, select your destination. 6. Confirm that **Send Track** or **Send Identify** is toggled on. - Trait Enrichment supports Track and Identify calls. Follow the corresponding destination instructions to determine which event you'll need. @@ -151,7 +151,7 @@ After you add traits, configure how your selected traits will map to your destin - To update a trait field mapping for Identify calls, click on a field, and in the dropdown search bar enter `traits.` followed by your trait (for example, `traits.trait_1`). Segment sends traits you select for enrichment as traits in the `traits` object. - To update a trait field mapping for Track calls, click on a field, and in the dropdown search bar enter `properties.` followed by your trait (for example, `properties.trait_1`). Segment sends traits you select for enrichment as properties in the `properties` object. - Click **Use as an event variable** to add your trait. -4. Click **Save** and navigate back to Engage to finish building your Audience. +4. Click **Save** and navigate back to Engage to finish building your Audience. ## Best practices diff --git a/src/unify/data-graph/setup-guides/snowflake-setup.md b/src/unify/data-graph/setup-guides/snowflake-setup.md index 4902defdb3..52543af017 100644 --- a/src/unify/data-graph/setup-guides/snowflake-setup.md +++ b/src/unify/data-graph/setup-guides/snowflake-setup.md @@ -14,32 +14,35 @@ On this page, you'll learn how to connect your Snowflake data warehouse to Segme Log in to Snowflake with admin privileges to provide Segment Data Graph with the necessary permissions below. -> info "" -> Both Linked Events and Data Graph support Snowflake. ## Required connection settings within Segment Segment requires the following settings to connect to your Snowflake warehouse. -Connect Snowflake to the Data Graph +Connect Snowflake to Data Graph - **Account ID**: The Snowflake account ID that uniquely identifies your organization account. -- **Database Name**: The only database that Segment requires write access to in order to create tables for internal bookkeeping. This database is referred to as `segment_connection_db` in the script below. +- **Database**: The only database that Segment requires write access to in order to create tables for internal bookkeeping. This database is referred to as `segment_connection_db` in the script below. - **Warehouse**: The [warehouse](https://docs.snowflake.com/en/user-guide/warehouses){:target="_blank”} in your Snowflake account that you want to use for Segment to run the SQL queries. This warehouse is referred to as `segment_connection_warehouse` in the script below. - **Username**: The Snowflake user that Segment uses to run SQL in your warehouse. This user is referred to as `segment_connection_username` in the script below. -- **Password**: The password of the user above. This password is referred to as `segment_connection_password` in the script below. +- **Authentication**: There are 2 supported authentication methods: + 1. **Key Pair**: This is the recommended method of authentication. You would need to first create the user and assign it a key pair following the instructions in the [Snowflake docs](https://docs.snowflake.com/en/user-guide/key-pair-auth). Then, follow the Segment docs above to set up Snowflake permissions and set the `segment_connections_username` variable in the SQL script to the user you just created. + 2. **Password**: The password of the user above. This password is referred to as `segment_connection_password` in the script below. ## Set up Snowflake credentials Segment recommends setting up a new Snowflake user and only giving this user permissions to access the required databases and schemas. -### Create Segment user and internal database +### Step 1: Create Segment user and internal database -Use the following steps to set up your Snowflake credentials: +The first step is to create a new Segment role and grant it the appropriate permissions. Run the SQL code block below in your SQL worksheet in Snowflake. It executes the following commands: -- Create a new role and user for Segment Data Graph. +- Create a new role and user for Segment Data Graph. This new role will have access to only the datasets you want to access from the Segment Data Graph. - Grant the Segment user access to the warehouse of your choice. If you'd like to create a new warehouse, uncomment the SQL below. -- Create a new database for Segment Data Graph. Segment only requires write access to this one database to create a schema for internal bookkeeping, and to store checkpoint tables for the queries that are executed. Segment recommends creating an empty database for this purpose using the script below. This is also the database you'll be required to specify for the "Database Name" when connecting Snowflake with the Segment app. +- Create a new database for Segment Data Graph. **Segment only requires write access to this one database to create a schema for internal bookkeeping, and to store checkpoint tables for the queries that are executed**. Segment recommends creating an empty database for this purpose using the script below. This is also the database you'll be required to specify for the "Database Name" when connecting Snowflake with the Segment app. + +> info "" +> The variables specified at the top of the code block with the `SET` command are placeholders and should be updated. ``` -- ********** SET UP THE FOLLOWING WAREHOUSE PERMISSIONS ********** @@ -91,11 +94,11 @@ GRANT CREATE SCHEMA ON DATABASE identifier($segment_connection_db) TO ROLE iden ``` -### Grant access to other databases +### Step 2: Grant read-only access to other databases -Next, give the Segment user **read-only** access to all the other databases you want to use for Data Graph. You must grant access to the Profiles Sync database. +Next, give the Segment role **read-only** access to all the other databases you want to use for Data Graph including the **Profiles Sync database** -Run the SQL query below for **each** database you want to use for Data Graph: +Run the SQL query below for **each** database you want to use for Data Graph. **You may have to re-run this multiple times for each database you want to give access to**. ``` @@ -117,7 +120,7 @@ GRANT SELECT ON FUTURE MATERIALIZED VIEWS IN DATABASE identifier($linked_read_on ``` -### (Optional) Restrict Snowflake schema access +### (Optional) Step 3: Restrict Snowflake schema access If you want to restrict access to specific [Snowflake schemas and tables](https://docs.snowflake.com/en/user-guide/security-access-control-privileges#table-privileges){:target="_blank”}, run the following commands: @@ -143,7 +146,7 @@ GRANT SELECT ON FUTURE MATERIALIZED VIEWS IN SCHEMA identifier($linked_read_only ``` -### (If applicable) Update user acccess for Segment Reverse ETL schema +### (If applicable) Step 4: Update user acccess for Segment Reverse ETL schema > warning "" > This is only applicable if you choose to use an existing database as the Segment connection database that has also been used for Segment Reverse ETL. @@ -157,7 +160,7 @@ Add the Snowflake table permissions by running the following commands: ``` -- If you want to use an existing database that already has Segment Reverse ETL schemas, you’ll need to run some additional steps below to grant the role access to the existing schemas. -SET retl_schema = concat($segment_internal_database,'.__segment_reverse_etl'); +SET retl_schema = concat($segment_connection_db,'.__segment_reverse_etl'); GRANT USAGE ON SCHEMA identifier($retl_schema) TO ROLE identifier($segment_connection_role); @@ -167,7 +170,7 @@ GRANT SELECT,INSERT,UPDATE,DELETE ON ALL TABLES IN SCHEMA identifier($retl_schem ``` -### Confirm permissions +### Step 5: Confirm permissions To verify you have set up the right permissions for a specific table, log in with the username and password you created for `SEGMENT_CONNECTION_USERNAME` and run the following command to verify the role you created has the correct permissions. If this command succeeds, you should be able to view the respective table. @@ -179,6 +182,6 @@ set table_name = 'YOUR_DB.SCHEMA.TABLE'; USE ROLE identifier($segment_connection_role); USE DATABASE identifier($linked_read_only_database) ; SHOW SCHEMAS; -SELECT * FROM identifier($table) LIMIT 10; +SELECT * FROM identifier($table_name) LIMIT 10; ``` diff --git a/src/unify/images/snowflake-setup.png b/src/unify/images/snowflake-setup.png index 697e9024c1..788e338653 100644 Binary files a/src/unify/images/snowflake-setup.png and b/src/unify/images/snowflake-setup.png differ