• Features
  • API Docs
  • Help Center
  • Log in
  • Sign Up
  • Features
  • API Docs
  • Help Center
  • Log in
  • Sign Up

Custom Events

232 views November 19, 2020 0

What is an Event?

An event is a data point that represents an interaction between a user and your product. Events can be a wide range of interactions.

For example, a music service might track a new user signing up for an account or a user playing a song as an event.

Before you start

Here are some things to know before you begin this process.

  • First of all, you must register a custom event in the Smart Sender system.
  • SmartSender was intended to be used with a single list, so when you assign events to contacts remember that you can import the file only for the Default Contact List.
  • If your contact already has a Special Custom Source, we’ll assign it automatically.
  • Events and their properties are immutable, meaning they cannot be changed.
  • If you imported two similar events, duplicate events will be saved in the Event Log and you cannot delete them.

Create custom events by making a custom event within SmartSender.

Custom events allow you to define a group of users based on existing events and properties, and then segment that group.

Registration a Custom Event

  1. Navigate to the “Events” page (Menu ->Components > Events)
  2. Click “Add Event” button
  3. Enter Event name (must be entered in Latin, Camel case, numbers, dashes, underscore, without spaces)
  4. Fill in input fields with valid data
  5. Mark checkbox “Conversion” if you want, that event will use in the “Performance” report.
  6. Click “Save” button

Event properties are important, as they provide the necessary context to break down and filter your event data and answer meaningful questions.
For example, when a new user signs up and you track that action as an event, the type of plan they signed up with can be collected as a property of the “Sign-Up” event. If a user plays a song, the title of the song can be collected as a property of the “Song Play” event.

Let’s go see how to add registered events to contacts.

Prepare import file

  1. Navigate to the “Events” page (Menu ->Components > Events)
  2. Select the “Import” tab
  3. Download example of file import excel format
  4. Fill in input fields with valid data
Import file header Description and format requirements.
date Date when the event occurred. Format 
time Time when the event occurred. Format 
dateTime Date and time when the event occurred. Format DateTime: ISO8601
Defaults:
If the time and date of the events are empty, we put down the date and time of adding the event to the SmartSender system.
eventId Unique EventId that is already registered in SmartSender system.
eventName Unique EventName that is already registered in SmartSender system.
contact The ’email’ address, ‘userId’ or ‘phoneNumber’ of the recipient stored in the corresponding contactList.
value Value in ‘ENUM_STRING’ format correspondingly
currency (EUR, USD)
WARNING: Please use only latin uppercase format. No numbers or other symbols allowed.
ipAddress IP address is an identifying number that is associated with a specific computer or computer network.
userAgent A browser’s user agent string identify which browser is used, what version, and on which operating system.
Example: “Mozilla/5.0 (X11; Linux x86_64)”, “AppleWebKit/537.36 (KHTML, like Gecko)”, “Chrome/85.0.4183.121”,  “Safari/537.36”
httpReferer Optional HTTP header field that identifies the address of the webpage which is linked to the resource being requested.
utmSource Traffic source
For example: Direct, Adwords, website
utmMedium Traffic type
It can be contextual advertising, social media advertising, 
banner advertising, advertising on price aggregators, retargeting sites, 
CPA networks, email newsletters.
utmCampaign Advertising campaigns
name of the ad campaign
utmContent This tag is filled arbitrarily, banner text
utmTerm Keyword
Manually set a keyword,  specified a dynamic parameter, which will be replaced by a keyword.

Import a Custom Event 

  1. Navigate to the “Events” page (Menu ->Components > Events)
  2. Select the “Import” tab
  3. Click “Choose File” button
  4. Select your import file to upload.
  5. Click the “Import” button
  6. For large files it will take some time to get imported Events for contacts, You can watch the loading process on your screen. Please wait till the end of the file validation and then you may leave the page. We will take care of your Events from that point.
  7. All results can be viewed in the Event Log 

You can manage events via API

 

Similar posting
  • Contact Sources
  • Tags
  • Variables
Company
  • About us
  • Team
  • YouTube
  • Facebook
  • Google Business
Legal
  • Terms of Use
  • Privacy Policy
  • Anti-Spam Policy
  • Cookie Statement
Resources
  • Api Documentation
  • FAQ
  • Knowledge Base
  • SmartSender Blog
  • Marketplace

We use cookies to make SmartSender’s website a better place. Cookies help to provide a more personalized experience for you, and web analytics for us. To learn more, and to see a full list of cookies we use, check out our Cookie Policy (baked goods not included).

got it