CampaignEvents
OCP App SDK / CampaignEvents
Class: CampaignEvents
Defined in: src/app/lib/CampaignEvents.ts:12
A class to help batch and send campaign related events
Constructors
Constructor
Defined in: src/app/lib/CampaignEvents.ts:28
Parameters
identifierField
string
the name of the identifier field used to target the user. The identifier value provided to a campaign event must be for this identifier field name.
tracking
Partial<CampaignTracking>
Campaign tracking information to be included on every event. Use an empty {} if you plan to provide different tracking info for each event, otherwise a complete CampaignTracking object.
type?
string
Returns
CampaignEvents
Properties
tracking
Defined in: src/app/lib/CampaignEvents.ts:30
Campaign tracking information to be included on every event. Use an empty {} if you plan to provide different tracking info for each event, otherwise a complete CampaignTracking object.
Methods
click()
Defined in: src/app/lib/CampaignEvents.ts:100
Send a campaign click event
Parameters
identifier
string
the identifier value / target identifier value related to this event
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
delivery()
Defined in: src/app/lib/CampaignEvents.ts:80
Send a campaign delivery event
Parameters
identifier
string
the identifier value / target identifier value related to this event
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
disengage()
Defined in: src/app/lib/CampaignEvents.ts:120
Send a campaign disengage event
Parameters
identifier
string
the identifier value / target identifier value related to this event
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
engage()
Defined in: src/app/lib/CampaignEvents.ts:110
Send a campaign engage event
Parameters
identifier
string
the identifier value / target identifier value related to this event
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
event()
Defined in: src/app/lib/CampaignEvents.ts:58
Send a campaign related event
Parameters
identifier
string
the identifier value / target identifier value related to this event
action
the campaign action
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
flush()
Defined in: src/app/lib/CampaignEvents.ts:45
Flush all API batches. You MUST flush before your task exists if you generated any events.
Returns
Promise<void>
hardBounce()
Defined in: src/app/lib/CampaignEvents.ts:132
Send a campaign hard bounce event, which means you were unable to deliver AND the identifier is definitely no longer reachable. E.g., an invalid address.
Parameters
identifier
string
the identifier value / target identifier value related to this event
reason
string
a human readable reason for the hard bounce
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
open()
Defined in: src/app/lib/CampaignEvents.ts:90
Send a campaign open event
Parameters
identifier
string
the identifier value / target identifier value related to this event
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
optIn()
Defined in: src/app/lib/CampaignEvents.ts:201
Send a campaign related opt-in event, such as, when a customer re-subscribes or replies UNSTOP to an SMS. This is considered a consent opt-in for the identifier.
Parameters
identifier
string
the identifier value / target identifier value related to this event
reason
string
a human readable reason for the opt-in
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
optOut()
Defined in: src/app/lib/CampaignEvents.ts:179
Send a campaign related opt-out event, such as, when a customer unsubscribes or replies STOP to an SMS. Consent will be revoked on the identifier.
Parameters
identifier
string
the identifier value / target identifier value related to this event
reason
string
a human readable reason for the opt-out
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>
softBounce()
Defined in: src/app/lib/CampaignEvents.ts:155
Send a campaign soft bounce event, which means you were unable to deliver, but the identifier may still be reachable. E.g., the provider is temporarily unavailable.
Parameters
identifier
string
the identifier value / target identifier value related to this event
reason
string
a human readable reason for the soft bounce
ts?
the time of the event. If left blank, the recevied time will be used.
string | number | Date
data?
EventData
additional event data to add to the event
Returns
Promise<void>