CampaignEvents
OCP App SDK / CampaignEvents
CampaignEvents
A class to help batch and send campaign related events
Index
Constructors
Properties
Methods
Constructors
constructor()
Signature
new CampaignEvents(identifierField: string, tracking: Partial<CampaignTracking>, type?: string): CampaignEvents;
Parameters
Name | Type | Description |
---|---|---|
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
Defined in: src/app/lib/CampaignEvents.ts:28
Properties
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.
Defined in: src/app/lib/CampaignEvents.ts:30
Methods
click()
Send a campaign click event
Signature
click(identifier: string, ts?: string | number | Date, data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:100
delivery()
Send a campaign delivery event
Signature
delivery(identifier: string, ts?: string | number | Date, data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:80
disengage()
Send a campaign disengage event
Signature
disengage(identifier: string, ts?: string | number | Date, data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:120
engage()
Send a campaign engage event
Signature
engage(identifier: string, ts?: string | number | Date, data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:110
event()
Send a campaign related event
Signature
event(
identifier: string,
action: CampaignAction,
ts?: string | number | Date,
data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
action | CampaignAction | the campaign action |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:58
flush()
Flush all API batches. You MUST flush before your task exists if you generated any events.
Signature
flush(): Promise<void>;
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:45
hardBounce()
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.
Signature
hardBounce(
identifier: string,
reason: string,
ts?: string | number | Date,
data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
reason | string | a human readable reason for the hard bounce |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:132
open()
Send a campaign open event
Signature
open(identifier: string, ts?: string | number | Date, data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:90
optIn()
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.
Signature
optIn(
identifier: string,
reason: string,
ts?: string | number | Date,
data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
reason | string | a human readable reason for the opt-in |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:201
optOut()
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.
Signature
optOut(
identifier: string,
reason: string,
ts?: string | number | Date,
data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
reason | string | a human readable reason for the opt-out |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:179
softBounce()
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.
Signature
softBounce(
identifier: string,
reason: string,
ts?: string | number | Date,
data?: EventData): Promise<void>;
Parameters
Name | Type | Description |
---|---|---|
identifier | string | the identifier value / target identifier value related to this event |
reason | string | a human readable reason for the soft bounce |
ts? | string | number | Date | the time of the event. If left blank, the recevied time will be used. |
data? | EventData | additional event data to add to the event |
Returns
Promise
<void
>
Defined in: src/app/lib/CampaignEvents.ts:155
Updated 2 months ago