Default events are pre-defined user events that Insider One creates for your account. They are designed around the requirements of Insider One’s products and common user actions.
In addition to these defaults, you can define custom events to track actions not included in the default list or to cover specific business use cases.
The default events are categorized as:
Pageview Events
Default Pageview Events are fired based on the page type a user is on at that time. For example, when a user visits the home page, the Homepage View event is triggered, along with the respective event parameters. The default pageview events and their event parameters are as follows:
Homepage View: Session ID, source, URL, device type, and referrer.
Listing Page View: Session ID, taxonomy, source, URL, device type, and referrer.
Product Detail Page View: Product ID, name, taxonomy, currency, unit price, unit sale price, quantity, product image URL, session ID, unit size, source, URL, device type, and referrer.
Cart Page View: Product ID, name, taxonomy, currency, unit price, unit sale price, quantity, unit size, product image URL, session ID, event group ID, category, source, URL, device type, and referrer.
Purchase (Confirmation Page View): Product ID, name, taxonomy, currency, unit price, unit sale price, quantity, product image URL, session ID, shipping cost, voucher name, voucher discount, promotion name, promotion discount, event group ID, quantity, unit size, color, source, URL, device type, and referrer.
Other Pageview: Session ID, source, URL, device type, and referrer.
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
source | Source | Source of the event (e.g., email, web, etc.) | Web | String |
url | URL | URL of the page where the event is fired | Web | String |
device_type | Device Type | The type of device used to fire the event | Web | String |
referrer | Referrer | The referrer page of the page where the event is fired | Web | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
ta | Taxonomy | Taxonomy of the page where the event is fired | Web / Mobile | Strings |
source | Source | Source of the event (e.g., email, web, etc.) | Web | String |
url | URL | URL of the page where the event is fired | Web | String |
device_type | Device Type | The type of device used to fire the event | Web | String |
referrer | Referrer | The referrer page of the page where the event is fired | Web | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
pid | Product ID | Product ID | Web / Mobile | String |
na | Name | Product name | Web / Mobile | String |
ta | Taxonomy | Taxonomy of the product | Web / Mobile | Strings |
cu | Currency | Currency of the product | Web / Mobile | String |
up | Unit Price | Unit price of the product | Web / Mobile | Number |
usp | Unit Sale Price | Unit sale price of the product | Web / Mobile | Number |
qu | Quantity | Quantity of the product | Web / Mobile | Number |
piu | Product Image URL | Image URL of the product | Web / Mobile | String |
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
si | Unit Size | Unit size | Mobile | String |
source | Source | Source of the event (e.g., email, web, etc.) | Web | String |
url | URL | URL of the page where the event is fired | Web | String |
device_type | Device Type | The type of device used to fire the event | Web | String |
referrer | Referrer | The referrer page of the page where the event is fired | Web | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
pid | Product ID | Product ID | Web / Mobile | String |
na | Name | Product name | Web / Mobile | String |
ta | Taxonomy | Taxonomy of the product | Web / Mobile | Strings |
cu | Currency | Currency of the product | Web / Mobile | String |
up | Unit Price | Unit price of the product | Web / Mobile | Number |
usp | Unit Sale Price | Unit sale price of the product | Web / Mobile | Number |
qu | Quantity | Quantity of the product | Web / Mobile | Number |
piu | Product Image URL | Image URL of the product | Web / Mobile | String |
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
si | Unit Size | Unit size | Mobile | String |
e_guid | Event Group ID | Group ID of the event | Web / Mobile | String |
source | Source | Source of the event (e.g., email, web, etc.) | Web | String |
url | URL | URL of the page where the event is fired | Web | String |
device_type | Device Type | The type of device used to fire the event | Web | String |
referrer | Referrer | The referrer page of the page where the event is fired | Web | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
pid | Product ID | Product ID | Web / Mobile | String |
na | Name | Product name | Web / Mobile | String |
ta | Taxonomy | Taxonomy of the product | Web / Mobile | Strings |
cu | Currency | Currency of the product | Web / Mobile | String |
up | Unit Price | Unit price of the product | Web / Mobile | Number |
usp | Unit Sale Price | Unit sale price of the product | Web / Mobile | Number |
piu | Product Image URL | Image URL of the product | Web / Mobile | String |
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
sc | Shipping Cost | Shipping cost of the product | Web / Mobile | Number |
vn | Voucher Name | Voucher name | Web / Mobile | String |
vd | Voucher Discount | The discount applied by the voucher | Web / Mobile | Number |
pn | Promotion Name | Promotion name | Web / Mobile | String |
pd | Promotion Discount | Promotion discount | Web / Mobile | Number |
si | Unit Size | Unit size | Mobile | String |
qu | Quantity | Quantity of the product | Web / Mobile | Number |
e_guid | Event Group ID | Group ID of the event | Web / Mobile | String |
co | Color | Color of the product | Mobile | String |
source | Source | Source of the event (e.g., email, web, etc.) | Web | String |
url | URL | URL of the page where the event is fired | Web | String |
device_type | Device Type | The type of device used to fire the event | Web | String |
referrer | Referrer | The referrer page of the page where the event is fired | Web | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
source | Source | Source of the event (e.g., email, web, etc.) | Web | String |
url | URL | URL of the page where the event is fired | Web | String |
device_type | Device Type | The type of device used to fire the event | Web | String |
referrer | Referrer | The referrer page of the page where the event is fired | Web | String |
The currency event parameter is essential for accurate segmentation and personalization.
User Events
Default User Events are triggered by user actions. For example, if a user joins a lead collection campaign, the Lead Collected event is triggered. If they clear their cart, the Cart Cleared event is fired. The default user events and their event parameters are as follows:
Cart Cleared: Session ID
Item Added to Cart: Product ID, name, taxonomy, currency, unit price, unit sale price, stock, color, size, product image URL, session ID, shipping cost, voucher name, voucher discount, promotion name, promotion discount, event group ID, source, quantity, URL, device type, and referrer.
Item Removed from Cart: Product ID, name, taxonomy, currency, unit price, unit sale price, stock, color, size, product image URL, session ID, shipping cost, voucher name, voucher discount, promotion name, promotion discount, event group ID, source, URL, device type, and referrer.
Signup Completed: No event parameter
Lead Collected: Campaign ID
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
pid | Product ID | Product ID | Web / Mobile | String |
na | Name | Product name | Web / Mobile | String |
ta | Taxonomy | Taxonomy of the product | Web / Mobile | Strings |
cu | Currency | Currency of the product | Web / Mobile | String |
up | Unit Price | Unit price of the product | Web / Mobile | Number |
usp | Unit Sale Price | Unit sale price of the product | Web / Mobile | Number |
st | Stock | Stock of the product | Web / Mobile | Number |
piu | Product Image URL | Image URL of the product | Web / Mobile | String |
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
sc | Shipping Cost | Shipping cost of the product | Web / Mobile | Number |
vn | Voucher Name | Voucher name | Web / Mobile | String |
vd | Voucher Discount | The discount applied by the voucher | Web / Mobile | Number |
pn | Promotion Name | Promotion name | Web / Mobile | String |
pd | Promotion Discount | Promotion discount | Web / Mobile | Number |
si | Unit Size | Unit size | Mobile | String |
qu | Quantity | Quantity of the product | Web / Mobile | Number |
e_guid | Event Group ID | Group ID of the event | Web / Mobile | String |
co | Color | Color of the product | Mobile | String |
source | Source | Source of the event (e.g., email, web, etc.) | Web | String |
url | URL | URL of the page where the event is fired | Web | String |
device_type | Device Type | The type of device used to fire the event | Web | String |
referrer | Referrer | The referrer page of the page where the event is fired | Web | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
pid | Product ID | Product ID | Web / Mobile | String |
na | Name | Product name | Web / Mobile | String |
ta | Taxonomy | Taxonomy of the product | Web / Mobile | Strings |
cu | Currency | Currency of the product | Web / Mobile | String |
up | Unit Price | Unit price of the product | Web / Mobile | Number |
usp | Unit Sale Price | Unit sale price of the product | Web / Mobile | Number |
st | Stock | Stock of the product | Web / Mobile | Number |
piu | Product Image URL | Image URL of the product | Web / Mobile | String |
sid | Session ID | The ID of the session where the event is fired | Web / Mobile | String |
sc | Shipping Cost | Shipping cost of the product | Web / Mobile | Number |
vn | Voucher Name | Voucher name | Web / Mobile | String |
vd | Voucher Discount | The discount applied by the voucher | Web / Mobile | Number |
pn | Promotion Name | Promotion name | Web / Mobile | String |
pd | Promotion Discount | Promotion discount | Web / Mobile | Number |
si | Unit Size | Unit size | Mobile | String |
e_guid | Event Group ID | Group ID of the event | Web / Mobile | String |
co | Color | Color of the product | Mobile | String |
source | Source | Source of the event (e.g., email, web, etc.) | Web | String |
url | URL | URL of the page where the event is fired | Web | String |
device_type | Device Type | The type of device used to fire the event | Web | String |
referrer | Referrer | The referrer page of the page where the event is fired | Web | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
campaign_id | Campaign ID | ID of the campaign that collected the lead | Web | Number |
Mobile App Events
Default Mobile App Events are triggered by Mobile App campaigns and are based on users' interactions with these campaigns. For example, when a user sees an InApp campaign, the InApp Seen event is fired. The default mobile app events and their event parameters are as follows:
InApp Seen: InApp ID, variant ID, dismiss type, Journey ID, and Journey Name.
Push Delivered: Camp ID, camp type, deep links, dry run, image URL, message, title, variant ID, Journey ID, and Journey Name.
App Push Opened (push_session): Variant ID, camp type, camp ID, Journey ID, and Journey Name.
Mobile App Opened (session_start): No event parameter
Survey Result (survey_result): camp_id, variant_id, answer, crea, and question.
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
inapp_id | InApp ID | ID of the InApp seen by the user | Number |
variant_id | Variant ID | Variant ID of the InApp seen by the user | Number |
dismiss_type | Dismiss Type | The dismiss action the user takes on an InApp campaign | Number |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
camp_id | Camp ID | ID of the push campaign delivered to the user | Number |
camp_type | Camp Type | Type of the push campaign delivered to the user | Number |
deep_links | Deep Links | Deep links in the push campaign delivered to the user | String |
image_url | Image URL | Image URL of the push campaign delivered to the user | String |
message | Message | Message of the push campaign delivered to the user | String |
title | Title | Title of the push campaign delivered to the user | String |
variant_id | Variant ID | Variant ID of the push delivered to the user | Number |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
variant_id | Variant ID | Variant ID of the app push opened by the user | Number |
camp_type | Camp Type | Type of the push campaign opened by the user | Number |
camp_id | Camp ID | ID of the push campaign seen by the user | Number |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
camp_id | Camp ID | D of the push campaign delivered to the user | String |
variant_id | Variant ID | ID of the variant of the survey that the user participated in | String |
answer | Answer | The user's response to the survey | String |
question | Question | The survey question to which the user responded | String |
Email Events
Default Email Events are fired by Email campaigns and are based on users' interactions with these campaigns. For example, if a user clicks a link in an email campaign, the Email Click event is triggered.
In a journey, when the Email channel triggers email events, the Journey ID and Journey Name are included as parameters in those events, such as the Email Delivered event. However, the Campaign ID, Campaign Name, and Variant ID are not included in these events, as they are not relevant to journey-triggered emails. In contrast, once a promotional bulk email campaign is launched and sent to users, the Campaign ID, Campaign Name, and Variant ID are included as event parameters.
The default email events and their event parameters are as follows:
Email Delivered: Email campaign ID, campaign name, variant ID, subject, user agent, IP address, Journey ID, and Journey Name.
Email Sent: Email campaign ID, campaign name, variant ID, subject, user agent, IP address, Journey ID, and Journey Name.
Email Open: Email campaign ID, campaign name, variant ID, subject, user agent, IP address, machine open, human open, Journey ID, and Journey Name.
Email Click: Email campaign ID, campaign name, variant ID, subject, user agent, IP address, URL, URL offset index, URL offset type, Journey ID, and Journey Name.
Email Bounce: Email campaign ID, campaign name, variant ID, subject, IP address, reason, type, Journey ID, and Journey Name.
Email Block: Email campaign ID, campaign name, variant ID, subject, IP address, reason, type, Journey ID, and Journey Name.
Email Spam Report: Email campaign ID, campaign name, variant ID, subject, user agent, IP address, Journey ID, and Journey Name.
Email Group Unsubscribe: Email campaign ID, campaign name, variant ID, subject, user agent, IP address, group ID, Journey ID, and Journey Name.
Email Group Resubscribe: Email campaign ID, campaign name, variant ID, subject, user agent, IP address, group ID, Journey ID, and Journey Name.
Email Unsubscribe: Email campaign ID, campaign name, variant ID, subject, unsubscribe type, user agent, IP address, Journey ID, and Journey Name.
Email Resubscribe: Email campaign ID, campaign name, variant ID, subject, user agent, IP address, Journey ID, and Journey Name.
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the email campaign delivered to a user within a given time period | Number |
campaign_name | Campaign Name | Name of the email campaign delivered to a user within a given time period | String |
variant_id | Variant ID | Variant ID of the email campaign delivered to a user within a given time period | Number |
subject | Subject | Subject of the delivered email campaign | String |
user_agent | User Agent | The user agent responsible for the event. This is usually a web browser. | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device used. | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the email campaign opened by a user within a given time period | Number |
campaign_name | Campaign Name | Name of the email campaign opened by a user within a given time period | String |
variant_id | Variant ID | Variant ID of the email campaign opened by a user within a given time period | Number |
subject | Subject | Subject of the opened email campaign | String |
user_agent | User Agent | The user agent responsible for the event. This is usually a web browser. | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device they are using. | String |
machine_open | Machine Open | Indicates if the email is opened by a machine. | Boolean |
human_open | Human Open | Indicates if the email is opened by a human. | Boolean |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign. | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign. | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the email campaign clicked by a user within a given time period | Number |
campaign_name | Campaign Name | Name of the email campaign clicked by a user within a given time period | String |
variant_id | Variant ID | Variant ID of the email campaign clicked by a user within a given time period | Number |
subject | Subject | Subject of the clicked email campaign | String |
user_agent | User Agent | The user agent responsible for the event. This is usually a web browser. | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device user. | String |
url | URL | URL of the email campaign clicked by a user within a given time period. | String |
url_offset_index | URL Offset Index | The index number of the same link in an email. This tells you which of the identical links was clicked. Links are indexed beginning at 0. | Number |
url_offset_type | URL Offset Type | The type of link can be either text, HTML, or a header. | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the bounced email campaign | Number |
campaign_name | Campaign Name | Name of the bounced email campaign | String |
variant_id | Variant ID | Variant ID of the bounced email campaign | Number |
subject | Subject | Subject of the bounced email campaign | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device used. | String |
reason | Reason | The reason why the email campaign is bounced. | String |
type | Type | Type of the email bounce | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the campaign whose recipient's address is blocked | Number |
campaign_name | Campaign Name | Name of the campaign whose recipient's address is blocked | String |
variant_id | Variant ID | Variant ID of the campaign whose recipient's address is blocked | Number |
subject | Subject | Subject of the blocked email campaign | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device used. | String |
reason | Reason | The reason why the email campaign is blocked | String |
type | Type | Type of the email block | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the email campaign marked as spam | Number |
campaign_name | Campaign Name | Name of the campaign marked as spam | String |
variant_id | Variant ID | Variant ID of the campaign marked as spam | Number |
subject | Subject | Subject of the email campaign reported as spam | String |
user_agent | User Agent | The user agent responsible for the event. This is usually a web browser. | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device used. | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the email campaign whose category users partially unsubscribe from | Number |
campaign_name | Campaign Name | Name of the email campaign whose category users partially unsubscribe from | String |
variant_id | Variant ID | Variant ID of the email campaign whose users partially unsubscribe from | Number |
subject | Subject | Subject of the email campaign group unsubscribed from | String |
user_agent | User Agent | The user agent responsible for the event. This is usually a web browser. | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device used. | String |
group_id | Group ID | Group ID of the email campaign unsubscribed from | Number |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the email campaign whose category users resubscribe from | Number |
campaign_name | Campaign Name | Name of the email campaign whose category users resubscribe from | String |
variant_id | Variant ID | Variant ID of the email campaign whose category users partially resubscribed from | Number |
subject | Subject | Subject of the email campaign group resubscribed from | String |
user_agent | User Agent | The user agent responsible for the event. This is usually a web browser. | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device used. | String |
group_id | Group ID | Group ID of the email campaign resubscribed from | Number |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey ID when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the email campaign marked as global unsubscribe by users | Number |
campaign_name | Campaign Name | Name of the email campaign marked as a global unsubscribe by users | String |
variant_id | Variant ID | Variant ID of the email campaign marked as a global unsubscribe by users | Number |
subject | Subject | Subject of the email campaign unsubscribed from | String |
unsubscribe_type | Unsubscribe Type | Unsubscribe type of the user. If it happens via list unsubscribe, it is written as “list-unsubscribe”. If via the list custom unsubscribe or default unsubscribe tag, it is written as “unsubscribe link”. | String |
user_agent | User Agent | The user agent responsible for the event. This is usually a web browser. | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device used. | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey ID when the campaign is a journey campaign | String |
Event Parameter | Display Name | Definition | Type |
|---|---|---|---|
email_campaign_id | Email Campaign ID | ID of the email campaign marked as resubscribed by users | Number |
campaign_name | Campaign Name | Name of the email campaign marked as resubscribed by users | String |
variant_id | Variant ID | Variant ID of the email campaign marked as resubscribed by users | Number |
subject | Subject | Subject of the email campaign resubscribed from | String |
user_agent | User Agent | The user agent responsible for the event. This is usually a web browser. | String |
ip_address | IP Address | IP address of the recipient who engaged with the email. This can help determine the recipient’s geographic location or the device used. | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | String |
Architect Events
Default Architect Events are fired by the Architect journeys and are based on users' interactions with these campaigns. For example, if a user enters a journey, the Journey Enter event is triggered. The default Architect events are as follows:
Journey Enter: Journey ID, name, and reason.
Journey Exit: Journey ID, name, and reason.
Journey Product Action: Action code, campaign ID, journey ID, and channel code.
Journey Enter Reasons
The following can be the value for the reason parameter:
Unified
The same user enters the journey as two different user profiles, gets unified while still in the journey, and continues the journey as one unified user.
User A becomes eligible to enter a journey and then gets unified with user B. In this case, user A becomes user B in Insider One's Unified Customer Database, which means that user B enters the journey as it is unified.
Natural: The user was eligible to enter the journey naturally.
Journey Exit Reasons
The following can be the value for the reason parameter:
Exited: The user fulfilled any of the Exit Criteria and exited the journey.
Completed: The user reached the end of a path and completed the journey.
Dropped: The user was unreachable from the channel element and was dropped from the journey.
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
journey_id | Journey ID | ID of the journey users entered. Used in the Events segment and Exit Criteria | Misc. | Number |
name | Name | Name of the journey users entered. Used in the Events segment and Exit Criteria | Misc. | String |
reason | Reason | The reason for the Journey Enter event. The values can be natural or unified. | Misc. | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
journey_id | Journey ID | ID of the journey users exited. Used to connect journeys and allow users to start a journey when they exit another one. | Misc. | Number |
name | Name | Name of the journey users exited. Used to connect journeys and allow users to start a journey when they exit another one. | Misc. | String |
reason | Reason | The reason for the Journey Exit event. The values can be exited, completed, or dropped. | Misc. | String |
event_code | Event Code | A mix of channel code and campaign ID to identify the channel element that the user exited or dropped from. It is in the format of “[Channel Code]:[Campaign ID]”. Campaign ID can be found in the inner pages of channel elements. For further information, refer to How to Export Journey User Data. | Misc. | String |
Web Push Events
Default Web Push Events are fired by the Web Push campaigns and are based on users' interactions with these campaigns. For example, if a user clicks a Web Push notification, the Web Push Click event is triggered. The default Web Push events and their event parameters are as follows:
Web Push View: Variant ID, Campaign ID, and Campaign Name
Web Push Click: Variant ID, Campaign ID, and Campaign Name
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the Web Push notification viewed by a user | Web | Number |
camp_id | Campaign ID | Campaign ID of the Web Push notification viewed by a user | Web | Number |
camp_name | Campaign Name | Campaign Name of the Web Push notification viewed by a user | Web | String |
Event Parameter | Display Name | Definition | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the Web Push notification clicked by a user | Web | Number |
camp_id | Campaign ID | Campaign ID of the Web Push notification clicked by a user | Web | Number |
camp_name | Campaign Name | Campaign Name of the Web Push notification clicked by a user | Web | String |
WhatsApp Events
Default WhatsApp Events are fired by the WhatsApp campaigns and are based on users' interactions with these campaigns. For example, if a user replies to a WhatsApp message with the second button, the WhatsApp Reply Second Button event is triggered.
The default WhatsApp events and their event parameters are as follows:
WhatsApp Click: Variant ID, Campaign Name, Journey ID, Journey Name, and URL.
WhatsApp Delivered: Variant ID, Campaign Name, Journey ID, and Journey Name.
WhatsApp Reply: Variant ID, Campaign Name, Journey ID, and Journey Name.
WhatsApp Reply First Button: Variant ID, Campaign Name, Journey ID, Journey Name, and Card.
WhatsApp Reply Second Button: Variant ID, Campaign Name, Journey ID, Journey Name, and Card.
WhatsApp Reply Third Button: Variant ID, Campaign Name, Journey ID, Journey Name, and Card.
WhatsApp Reply Other Reply: Variant ID, Campaign Name, Journey ID, and Journey Name.
WhatsApp Unsubscribe: Variant ID, Campaign Name, Journey ID, and Journey Name.
If only the identifier is used and the user unsubscribes after receiving the latest journey message, the journey parameters are recorded.
WhatsApp Read: Variant ID, Journey ID, and Journey Name.
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp campaign clicked by the user | Web | Integer |
campaign_name | Campaign Name | Name of the WhatsApp campaign clicked by the user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
url | URL | URL of the WhatsApp message clicked by the user | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp campaign delivered to the user | Web | Integer |
campaign_name | Campaign Name | Name of the WhatsApp campaign delivered to the user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp campaign replied to by the user | Web | Integer |
campaign_name | Campaign Name | Name of the WhatsApp campaign replied to by the user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp message’s first button clicked by the user | Web | Integer |
campaign_name | Campaign Name | Campaign name of the WhatsApp message whose first button was clicked by the user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
card | Card | Card identifier of the WhatsApp message’s first carousel card replied to by the user | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp message’s second button clicked by the user | Web | Integer |
campaign_name | Campaign Name | Campaign name of the WhatsApp message whose second button was clicked by the user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
card | Card | Card identifier of the WhatsApp message’s second carousel card replied to by the user | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp message’s third button clicked by the user | Web | Integer |
campaign_name | Campaign Name | Campaign name of the WhatsApp message whose third button was clicked by the user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
card | Card | Card identifier of the WhatsApp message’s third carousel card replied to by the user | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp campaign replied to by a user using the other option | Web | Integer |
campaign_name | Campaign Name | Campaign name of the WhatsApp campaign replied to by a user using the other option | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp campaign unsubscribed by a user | Web | Integer |
campaign_name | Campaign Name | Campaign name of the WhatsApp campaign unsubscribed by a user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of the WhatsApp campaign read by a user | Web | Integer |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
SMS Events
Default SMS Events are fired by the SMS campaigns and are based on users' interactions with these campaigns. For example, if a user clicks a URL in the SMS message, the SMS Click event is triggered. The default SMS events and their event parameters are as follows:
SMS Click: Variant ID, Campaign Name, Journey ID, and Journey Name.
SMS Delivered: Variant ID, Campaign Name, Journey ID, and Journey Name.
SMS Unsubscribe: Variant ID, Campaign Name, Journey ID, and Journey Name.
SMS Subscribe: Variant ID, Campaign Name, Journey ID, and Journey Name.
SMS Undelivered: Variant ID, Campaign Name, Reason Type, Journey ID, and Journey Name.
SMS Reply: Variant ID, Campaign Name, Reason Type, Journey ID, and Journey Name.
SMS Campaigns: Variant ID
SMS Drop: Variant ID, Campaign Name, Reason Type, Journey ID, and Journey Name.
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of an SMS clicked by a user | Web | Integer |
campaign_name | Campaign Name | Campaign name of an SMS clicked by a user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of an SMS delivered to a user | Web | Integer |
campaign_name | Campaign Name | Campaign name of an SMS delivered to a user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of an SMS unsubscribed by a user | Web | Integer |
campaign_name | Campaign Name | Campaign name of an SMS unsubscribed by a user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of an SMS subscribed to by a user | Web | Integer |
campaign_name | Campaign Name | Campaign name of an SMS subscribed to by a user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of an SMS undelivered to a user | Web | Integer |
campaign_name | Campaign Name | Campaign name of an SMS undelivered to a user | Web | String |
reason_type | Reason Type | Reason why an SMS was undelivered to a user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of an SMS clicked by a user | Web | Integer |
campaign_name | Campaign Name | Campaign name of an SMS clicked by a user | Web | String |
reason_type | Reason Type | Reason why an SMS was undelivered to a user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of an SMS campaign | Web | Integer |
Event Parameter | Display Name | Description | Source | Type |
|---|---|---|---|---|
variant_id | Variant ID | Variant ID of an SMS clicked by a user | Web | Integer |
campaign_name | Campaign Name | Campaign name of an SMS clicked by a user | Web | String |
reason_type | Reason Type | Reason why an SMS was undelivered to a user | Web | String |
journey_id | Journey ID | Journey ID when the campaign is a journey campaign | Web | String |
journey_name | Journey Name | Journey name when the campaign is a journey campaign | Web | String |
Onsite Events
Default Onsite Events are fired by the Web Templates, InStory, Onsite Experiment, Category Optimizer, and Notification Center campaigns and are based on users' interactions with these campaigns. For example, if a user clicks a Web Templates campaign, the Onsite Click event is triggered. The default Onsite events and their event parameters are as follows:
Onsite Impression: Variant ID, Campaign ID, Campaign Type, Source Platform
Onsite Click: Variant ID, Campaign ID, Campaign Type, Source Platform
Event Parameter | Display Name | Definition |
|---|---|---|
variant_id | Variant ID | Variant ID of the campaign viewed by a user |
camp_id | Campaign ID | Campaign ID of the campaign viewed by a user |
camp_type | Campaign Type | Campaign type of the campaign viewed by a user 1: Onsite Experiment 0: Web Templates, InStory, Category Optimizer, and Notification Center |
source_platform | Source Platform | The platform on which the user viewed the campaign |
Event Parameter | Display Name | Definition |
|---|---|---|
variant_id | Variant ID | Variant ID of the campaign click by a user |
camp_id | Campaign ID | Campaign ID of the campaign clicked by a user |
camp_type | Campaign Type | Campaign type of the campaign clicked by a user 1: Onsite Experiment 0: Web Templates, InStory, Category Optimizer, and Notification Center |
source_platform | Source Platform | The platform on which the user clicked the campaign |
Agent One Events
Agent One automatically sends a set of built-in events to the InOne platform whenever specific interactions occur during a conversation. These events are collected in the Unified Customer Database (UCD) and can be used for segmentation, journey triggers, and cross-channel personalization in Architect.
These events are sent from Agent One to UCD automatically. No additional setup is required on the bot flow side. You must have identifier configuration in place for correct user matching (see the channel notes below).
cx_conversation_start: Channel Type, Channel Name, Assistant Name, Department Name, URL, and Message.
cx_conversation_ended: Channel Type, Channel Name, Assistant Name, AI Agent Name, URL, Conversation Duration, Department Name, Ended By, Is Timeout, Human Agent ID, Conversation Tags, and Human Agent Tags.
conversation_rating: Channel Type, Channel Name, Assistant Name, AI Agent Name, Department Name, Human Agent ID, Type, Rating Score, and Vote Comment.
human_agent_handover: Channel Type, Channel Name, Assistant Name, AI Agent Name, Department Name, and Human Agent ID.
ai_agent_action_trigger: Channel Type, Channel Name, Assistant Name, AI Agent Name, Name, Type, Is Action Success, and Session ID.
knowledge_base_response: Channel Type, Channel Name, Assistant Name, AI Agent Name, Source Name, Knowledge Base Name, Document Name, URL, and Session ID.
human_agent_tag_assignment: Channel Type, Channel Name, Assistant Name, Department Name, Human Agent ID, and Human Agent Tags.
ai_agent_recommendation: Channel Type, Channel Name, Assistant Name, AI Agent Name, Product ID, Product Name, Currency, Unit Price, Unit Sale Price, URL, Product Image URL, Locale, and Session ID.
ai_agent_recommendation_click: Product ID, Product Name, URL, Product Image URL, Currency, Unit Price, Unit Sale Price, Channel Type, Channel Name, Assistant Name, AI Agent Name, and Locale.
This event is fired when a user starts a new conversation session on any supported channel.
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
channel_type | Channel Type | Channel where conversation started (e.g., Webchat, WhatsApp) | String | Yes | Yes |
channel_name | Channel Name | Name of the channel as defined in the platform | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant handling the conversation | String | Yes | Yes |
department_name | Department Name | Department assigned to the conversation | String | Yes | Yes |
url | URL | Page URL where the chat was started | String | Yes | No |
message | Message | The first message sent by the user (max 500 characters) | String | No | Yes |
This event is fired when a conversation session ends, regardless of the reason (user exit, timeout, agent resolution).
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
channel_type | Channel Type | Channel where conversation ended | String | Yes | Yes |
channel_name | Channel Name | Name of the channel | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant | String | Yes | Yes |
ai_agent_name | AI Agent Name | Name of the AI agent that handled the conversation | String | Yes | Yes |
url | URL | Page URL where the conversation took place | String | Yes | No |
conversation_duration | Conversation Duration | Total duration of the conversation in seconds | Integer | Yes | Yes |
department_name | Department Name | Department that handled the conversation | String | Yes | Yes |
ended_by | Ended By | Who ended the conversation: BOT, CLIENT, or HUMAN AGENT | String | Yes | Yes |
is_timeout | Is Timeout | Whether the conversation ended due to timeout | Boolean | Yes | Yes |
human_agent_id | Human Agent ID | ID of the live support agent, if the conversation involved one | String | Yes | Yes |
conversation_tags | Conversation Tags | Tags assigned to the conversation by the assistant, comma-separated | String | Yes | Yes |
human_agent_tags | Human Agent Tags | Tags assigned by the human agent, comma-separated | String | Yes | Yes |
This event is fired when a user submits a satisfaction rating at the end of a conversation.
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
channel_type | Channel Type | Channel where the rating was submitted | String | Yes | Yes |
channel_name | Channel Name | Name of the channel | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant | String | Yes | Yes |
ai_agent_name | AI Agent Name | Name of the AI agent that received the rating | String | Yes | Yes |
department_name | Department Name | Department that handled the conversation | String | Yes | Yes |
human_agent_id | Human Agent ID | ID of the live agent, if the conversation involved one | String | Yes | Yes |
type | Type | Rating widget used: CSAT or NPS | String | Yes | Yes |
rating_score | Rating Score | Numeric score submitted by the user | Integer | Yes | Yes |
vote_comment | Vote Comment | Optional free-text comment submitted alongside the rating | String | Yes | Yes |
This event is fired when the AI agent transfers the conversation to a human live support agent.
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
channel_type | Channel Type | Channel where handover occurred | String | Yes | Yes |
channel_name | Channel Name | Name of the channel | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant | String | Yes | Yes |
ai_agent_name | AI Agent Name | Name of the AI agent that initiated the handover | String | Yes | Yes |
department_name | Department Name | Target department for the handover | String | Yes | Yes |
human_agent_id | Human Agent ID | ID of the live agent who received the conversation | String | Yes | Yes |
This event is fired when the AI agent triggers a configured action (e.g., an API call, an exit action).
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
channel_type | Channel Type | Channel where the action was triggered | String | Yes | Yes |
channel_name | Channel Name | Name of the channel | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant | String | Yes | Yes |
ai_agent_name | AI Agent Name | Name of the AI agent that triggered the action | String | Yes | Yes |
na | Name | Name of the triggered action | String | Yes | Yes |
type | Type | Type of the action (e.g. CALL_API, EXIT) | String | Yes | Yes |
is_action_success | Is Action Success | Whether the action completed successfully | Boolean | Yes | Yes |
sid | Session ID | Session ID of the conversation | String | Yes | Yes |
This event is fired when the AI agent generates a response using a knowledge base source. One event is sent per source document used in the response.
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
channel_type | Channel Type | Channel where the knowledge base was used | String | Yes | Yes |
channel_name | Channel Name | Name of the channel | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant | String | Yes | Yes |
ai_agent_name | AI Agent Name | Name of the AI agent that used the knowledge base | String | Yes | Yes |
source_name | Source Name | Name of the data collection (source group) used | String | Yes | Yes |
knowledge_base_name | Knowledge Base Name | Name of the knowledge base | String | Yes | Yes |
document_name | Document Name | File name of the specific document retrieved | String | Yes | Yes |
url | URL | Source URL of the document used to generate the answer | String | Yes | Yes |
sid | Session ID | Session ID of the conversation | String | Yes | Yes |
This event is fired when a human agent assigns one or more tags to a conversation. If no tags are assigned, this event is not sent.
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
channel_type | Channel Type | Channel where the tag was assigned | String | Yes | Yes |
channel_name | Channel Name | Name of the channel | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant | String | Yes | Yes |
department_name | Department Name | Department of the agent assigning tags | String | Yes | Yes |
human_agent_id | Human Agent ID | ID of the agent assigning tags | String | Yes | Yes |
human_agent_tags | Human Agent Tags | Tags assigned by the human agent, comma-separated | String | Yes | Yes |
This event is fired when the AI agent recommends a product to the user (Shopping Agent feature). One event is sent per product shown. Products without a price are skipped.
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
channel_type | Channel Type | Channel where the recommendation was shown | String | Yes | Yes |
channel_name | Channel Name | Name of the channel | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant | String | Yes | Yes |
ai_agent_name | AI Agent Name | Name of the AI agent showing the product | String | Yes | Yes |
pid | Product ID | Unique ID of the recommended product | String | Yes | Yes |
na | Product Name | Name of the recommended product | String | Yes | Yes |
cu | Currency | Currency code (e.g. TRY, USD) | String | Yes | Yes |
up | Unit Price | Regular (full) price of the product | Float | Yes | Yes |
usp | Unit Sale Price | Sale/discounted price of the product (only sent when a discount applies) | Float | Yes | Yes |
url | URL | Link to the product detail page | String | Yes | Yes |
piu | Product Image URL | Image URL of the product | String | Yes | Yes |
locale | Locale | Language and region locale (e.g. en_US) | String | Yes | Yes |
sid | Session ID | Session ID of the conversation | String | Yes | Yes |
This event is fired when a user clicks on a product recommended by the AI agent. The event is automatically enriched with full product details and conversation context on the backend — only the product ID is sent from the frontend.
Event Parameter | Display Name | Description | Type | WebChat | |
|---|---|---|---|---|---|
pid | Product ID | ID of the product the user clicked | String | Yes | Yes |
na | Product Name | Name of the clicked product | String | Yes | Yes |
url | URL | Product page URL navigated to after the click | String | Yes | Yes |
piu | Product Image URL | Image URL of the clicked product | String | Yes | Yes |
cu | Currency | Currency code (e.g., TRY, USD) | String | Yes | Yes |
up | Unit Price | Regular (full) price of the product | String | Yes | Yes |
usp | Unit Sale Price | Sale/discounted price of the product | String | Yes | Yes |
channel_type | Channel Type | Channel where the click occurred | String | Yes | Yes |
channel_name | Channel Name | Name of the channel | String | Yes | Yes |
assistant_name | Assistant Name | Name of the AI assistant | String | Yes | Yes |
ai_agent_name | AI Agent Name | Name of the AI agent | String | Yes | Yes |
locale | Locale | Language and region locale (e.g., en_US) | String | Yes | Yes |
Channel Notes for Agent One
For WebChat, all events and parameters are fully supported. The url parameter captures the exact page URL where the conversation took place, making it useful for page-level segmentation and journey triggers.
For WhatsApp,
All events are supported.
url (page URL) is not collected. WhatsApp conversations have no associated web URL. This applies to cx_conversation_start and cx_conversation_ended only; product URLs in recommendation events are still collected.
Identifier matching requires phone number setup. Events are attributed to the correct UCD profile via insider_id. If a user's phone number is not registered as an identifier, the event may be sent anonymously or may not match an existing profile. Ensure the phone number is configured as a UCD identifier.
For new WhatsApp users with no existing profile, a new UCD profile is created using the phone number.