View source for ATC/Current/SDK/Record

{{Article
|Standalone=No
|DisplayName=record
|Platform=PureEngage, PureConnect, PureCloud
|TocName=record
|ComingSoon=No
|Dimension=DevTracking
|Context=Learn how to use the <tt>record</tt> method to capture website events.
|Section={{Section
|sectionHeading=Description
|Type=Structured
|alignment=Vertical
|gif=No
|structuredtext=The <tt>record</tt> method records custom website events.
|fullwidth=No
|Status=No
}}{{Section
|sectionHeading=Signature
|Type=Structured
|alignment=Vertical
|gif=No
|structuredtext=<tt>ac('record', eventName, [customAttributes], [options])</tt>
|fullwidth=No
|Status=No
}}{{Section
|sectionHeading=Arguments
|Type=Structured
|alignment=Vertical
|gif=No
|structuredtext=*[[#eventName|eventName]]
*[[#customAttributes|customAttributes]]
*[[#options|options]]
|fullwidth=No
|Status=No
}}{{Section
|sectionHeading=eventName
|Type=Structured
|anchor=eventName
|alignment=Vertical
|gif=No
|structuredtext=*Description: name of the custom event
*Type: string
*Status: required
|fullwidth=No
|Status=No
}}{{Section
|sectionHeading=customAttributes
|Type=Structured
|anchor=customAttributes
|alignment=Vertical
|gif=No
|structuredtext=*Description: adds extra information to <tt>pageview</tt> event
*Type: object
*Status: optional
*Restrictions: a flat object with properties of type string, number, or boolean
|fullwidth=No
|Status=No
}}{{Section
|sectionHeading=options
|Type=Structured
|alignment=Vertical
|gif=No
|structuredtext=*Description: Used for additional configuration
*Type: object
*Status: optional
*Properties:

{{{!}} class="wikitable"
{{!}}-
{{!}}{{!}}'''Name'''
{{!}}{{!}}'''Description'''
{{!}}{{!}}'''Type'''
{{!}}{{!}}'''Status'''
{{!}}{{!}}'''Default'''
{{!}}-
{{!}}{{!}}traitsMapper
{{!}}{{!}}used to map custom attributes to traits. For more information, see {{Link-SomewhereInThisVersion|manual=SDK|topic=Traits_mapper|display text=Traits Mapper.}}
{{!}}{{!}}traitsMapper
{{!}}{{!}}<br />
{{!}}{{!}}<br />
{{!}}-
{{!}}{{!}}callback
{{!}}{{!}}called once beacon is sent
{{!}}{{!}}function
{{!}}{{!}}optional
{{!}}{{!}}<br />
{{!}}-
{{!}}{{!}}callbackTimeout
{{!}}{{!}}ms to wait for beacon to send
{{!}}{{!}}number
{{!}}{{!}}optional
{{!}}{{!}}<br />
{{!}}}
|fullwidth=No
|Status=No
}}
}}