An Activity is an action of an individual Person, such as viewing a web page, submitting a form, or clicking a link. Each Activity is made up of components that describe unique aspects of the Activity. Those filterable Activity components are defined and described in the list below. The Activity Type is the only component that must be specified. All other Activity components, such as where the action took place, when it took place, information about the Person's browser, and more, are captured by default. To overwrite the value for those components captured by default, you must have Custom Data. When all of the individual Activity components are combined, an Activity is fully described. In Feathr, an Activity is also called a Breadcrumb.
You must also have Custom Data to create a custom field Activity component.
Activity Type <string>
The type of tracked activity. The standard options are ad view
, ad click
, page view
, page link click
, dashboard view
, dashboard link click
, email view
, email link click
, form submission
, and report view
. The value defaults to page_view
if no type is specified.
feathr("sprinkle", "page_view");
feathr("sprinkle", "form_submission");
feathr("sprinkle", "custom_flavor");
URL "loc_url": <string>
A full URL including protocol, hostname, path and query parameters. Represents the URL of the tracked activity.
feathr("sprinkle", <flavor>, {
"loc_url": "https://association.com/confirmation-page"
});
Date/Time
The date and time (UTC) an activity was logged.
Link Target "link_trgt": <string>
In the event the interaction is a click, this field logs the URL where the click redirects.
feathr("sprinkle", <flavor>, {
"link_trgt": "https://partner.com/a-different-page"
});
Referrer "rfr": <string>
The last page the user was at before the current interaction.
feathr("sprinkle", <flavor>, {
"rfr": "https://google.com"
});
Project "e_id": <number>
The project a tracked activity is associated with. This is a 24 digit number, and can be found in the URL after /projects/
while inside the target project.
feathr("sprinkle", <flavor>, {
"e_id": <project ID>
});
Campaign
The campaign a tracked activity is associated with.
Partner "p_id": <number>
The partner a tracked activity is associated with (Invites and Monetization) (sprinkle: p_id)
feathr("sprinkle", <flavor>, {
"p_id": <partner ID>
});
Platform "pform": <string>
The operating system that participated in producing a tracked activity.
feathr("sprinkle", <flavor>, {
"pform": "macos"
});
Browser "brow": <string>
The browser that participated in producing a tracked activity.
feathr("sprinkle", <flavor>, {
"brow": "chrome"
});
Tag "tag_id": <number>
The custom tag associated with a recorded activity (e.g., Static Tags).
feathr("sprinkle", <flavor>, {
"tag_id": <tag ID>
});
ISP "isp": <string>
The internet service provider of users. ISP can help you to filter and target universities and large companies.
feathr("sprinkle", <flavor>, {
"isp": "Cox Communications"
});
Screen Width "s_w": <number>
The screen width of the device that participated in producing a tracked activity in pixels (sprinkle: s_w)
feathr("sprinkle", <flavor>, {
"s_w": 1920
});
Screen Height "s_h": <number>
The screen height of the device that participated in producing a tracked activity in pixels.
feathr("sprinkle", <flavor>, {
"s_h": 1080
});
Browser Width "b_w": <number>
The viewport width of the browser that participated in producing a tracked activity in pixels (sprinkle: b_w)
feathr("sprinkle", <flavor>, {
"b_w": 1920
});
Browser Height "b_h": <number>
The viewport height of the browser that participated in producing a tracked activity in pixels.
feathr("sprinkle", <flavor>, {
"b_h": 946
});
Was Sent Email
Filters by devices that have been included in a send in an email marketing campaign.
Received Email
Filters by devices with confirmed receipt of an email in an email marketing campaign.
Opened Email
Filters by devices known to have opened an email in an email marketing campaign.
Clicked Email
Filters by devices that have clicked a link within an email in an email marketing campaign.
Hard Bounce
Filters by devices that couldn't receive a previous email from an email marketing campaign because of a permanent issue, like their email address being invalid or expired, or because of the email recipient's server blocking the message.
Soft Bounce
Filters by devices that couldn't receive a previous email because of some temporary issue like the recipient's mailbox being full, improperly configured, or not able to process the email because of it being too large.
Reported Email as Spam
Filters by devices whose users have marked an email from an email marketing campaign as spam.
Note: Feathr email marketing campaigns will exclude email addresses with any of the previous three activities by default.
UTM Source
A standard URL parameter used for tracking through Google Analytics. The utm_source
parameter (required) identifies which site sent the traffic, and is a required parameter. Example: utm_source=Google
.
UTM Medium
A standard URL parameter used for tracking through Google Analytics. The utm_medium
parameter identifies what type of link was used, such as cost per click or email. Example: utm_medium=cpc
.
UTM Term
A standard URL parameter used for tracking through Google Analytics. The utm_term
parameter identifies search terms. Example: utm_term=running+shoes
.
UTM Campaign
A standard URL parameter used for tracking through Google Analytics. The utm_campaign
parameter identifies a specific product promotion or strategic campaign. Example: utm_campaign=spring_sale
.
UTM Content
A standard URL parameter used for tracking through Google Analytics. The utm_content
parameter identifies what specifically was clicked to bring the user to the site, such as a banner ad or a text link. It is used for A/B testing and content-targeted ads. Examples: utm_content=logolink
or utm_content=textlink
Other UTM Types
Any other UTM types you might create and track are treated as Custom Parameters and require Custom Data.
Custom Activities <string>: <string>, <number>, or <string array>
Additional filterable fields can be added to your database with Custom Data.
feathr("sprinkle", <flavor>, {
"REG_CONFIRM": "FeathrCon 2021"
});
feathr("sprinkle", <flavor>, {
"CART_ITEMS": ["Membership", "Guest Speaker", "Shirt"],
"CART_VALUE": 750
});