Difference between revisions of "ATC/Current/SDK/Method reference"

From Genesys Documentation
Jump to: navigation, search
(Published)
 
(13 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
|Standalone=No
 
|Standalone=No
 
|DisplayName=Method reference
 
|DisplayName=Method reference
−
|Platform=PureEngage, PureConnect, PureCloud
 
 
|TocName=Method reference
 
|TocName=Method reference
−
|Context=View a list of all methods for {{MINTYDOCSPRODUCT}}.
+
|Context=View a list of methods available in the Journey JavaScript SDK.
 +
|ComingSoon=No
 +
|Platform=PureConnect, GenesysCloud, GenesysEngage-cloud
 
|Section={{Section
 
|Section={{Section
 +
|alignment=Vertical
 +
|structuredtext={{NoteFormat|1=This article only applies to customers using {{Link-AnywhereElse|product=ATC|version=Current|manual=AdminGuide|topic=About_web_chats|display text=web chat}}. If you are a Genesys Cloud CX customer, we encourage you to use the new {{Link-AnywhereElse|product=ATC|version=Current|manual=AdminGuide|topic=About_web_messaging|display text=web messaging}} feature to replace web chat.|2=}}<br />
 +
|Status=No
 +
}}{{Section
 
|sectionHeading=Initialization methods
 
|sectionHeading=Initialization methods
−
|Type=Structured
 
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=For more information about a method, including signature and arguments, click the method's name.
−
|structuredtext=For complete information about a method, including signature and arguments, click the method's name.
 
 
{{{!}} class="wikitable"
 
{{{!}} class="wikitable"
 
{{!}}-
 
{{!}}-
Line 17: Line 20:
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}{{#mintydocs_link:topic=Init|link text=init}}
 
{{!}}{{!}}{{#mintydocs_link:topic=Init|link text=init}}
−
{{!}}{{!}}Initializes the {{MINTYDOCSPRODUCT}} SDK
+
{{!}}{{!}}Initializes the Journey JavaScript SDK.
 +
{{!}}-
 +
{{!}}{{Link-SomewhereInThisVersion|manual=SDK|topic=initialized}}
 +
{{!}}Notifies when the Journey JavaScript SDK is initialized fully.
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}{{#mintydocs_link:topic=Destroy|link text=destroy}}
 
{{!}}{{!}}{{#mintydocs_link:topic=Destroy|link text=destroy}}
−
{{!}}{{!}}Stops all {{MINTYDOCSPRODUCT}} SDK activity and removes all tracking information
+
{{!}}{{!}}Stops all Journey JavaScript SDK activity and removes all tracking information.
 
{{!}}}
 
{{!}}}
−
|fullwidth=No
+
|Status=No
 +
}}{{Section
 +
|sectionHeading=Session methods
 +
|anchor=SessionMethods
 +
|alignment=Vertical
 +
|structuredtext=For more information about a method, including signature and arguments, click the method's name.
 +
{{{!}} class="wikitable"
 +
{{!}}-
 +
{{!}}{{!}}'''Method'''
 +
{{!}}{{!}}'''Description'''
 +
{{!}}-
 +
{{!}}{{!}}{{Link-SomewhereInThisVersion|manual=SDK|topic=api.session.getData}}
 +
{{!}}{{!}}Returns an object that contains session information.
 +
{{!}}-
 +
{{!}}{{!}}{{Link-SomewhereInThisVersion|manual=SDK|topic=api.session.getCustomerCookieId}}
 +
{{!}}{{!}}Returns a string that contains the customer cookie ID.
 +
{{!}}-
 +
{{!}}{{Link-SomewhereInThisVersion|manual=SDK|topic=api.session.getId}}
 +
{{!}}Returns a string containing session ID.
 +
{{!}}}<br />
 +
|Status=No
 
}}{{Section
 
}}{{Section
 
|sectionHeading=Tracking methods
 
|sectionHeading=Tracking methods
−
|Type=Unstructured
+
|anchor=TrackingMethods
−
|freetext=For complete information about a method, including signature and arguments, click the method's name.
+
|alignment=Vertical
 +
|structuredtext=For more information about a method, including signature and arguments, click the method's name.
 
{{{!}} class="wikitable"
 
{{{!}} class="wikitable"
 
{{!}}-
 
{{!}}-
Line 33: Line 60:
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}{{#mintydocs_link:topic=Pageview|link text=pageview}}
 
{{!}}{{!}}{{#mintydocs_link:topic=Pageview|link text=pageview}}
−
{{!}}{{!}}Tracks page views
+
{{!}}{{!}}Tracks page views.
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}{{#mintydocs_link:topic=Record|link text=record}}
 
{{!}}{{!}}{{#mintydocs_link:topic=Record|link text=record}}
−
{{!}}{{!}}Records custom website events
+
{{!}}{{!}}Records custom website events.
−
{{!}}-
 
−
{{!}}{{!}}{{#mintydocs_link:topic=Identify|link text=identify}}
 
−
{{!}}{{!}}Adds information to a customer
 
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}{{#mintydocs_link:topic=Forms:track|link text=forms:track}}
 
{{!}}{{!}}{{#mintydocs_link:topic=Forms:track|link text=forms:track}}
−
{{!}}{{!}} 
+
{{!}}{{!}} Captures when visitors complete web-based forms.
 
{{!}}}
 
{{!}}}
 +
|Status=No
 
}}{{Section
 
}}{{Section
−
|sectionHeading=Utility methods
+
|sectionHeading=Events methods
−
|Type=Structured
+
|anchor=EventsMethods
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=For more information about a method, including signature and arguments, click the method's name.
−
|structuredtext=For complete information about a method, click the method's name.
 
 
{{{!}} class="wikitable"
 
{{{!}} class="wikitable"
 
{{!}}-
 
{{!}}-
Line 55: Line 79:
 
{{!}}{{!}}'''Description'''
 
{{!}}{{!}}'''Description'''
 
{{!}}-
 
{{!}}-
−
{{!}}{{!}}
+
{{!}}{{!}}{{Link-SomewhereInThisVersion|manual=SDK|topic=on}}
−
 
+
{{!}}{{!}}Subscribes to notifications about a particular type of Journey JavaScript SDK activity.
−
{{Link-SomewhereInThisManual|topic=serialize}}<br />
 
−
{{!}}{{!}}Used for passing serialized data from a form.
 
 
{{!}}-
 
{{!}}-
−
{{!}}{{!}}{{Link-SomewhereInThisManual|topic=dom_-_ready}}<br />
+
{{!}}{{!}}{{Link-SomewhereInThisVersion|manual=SDK|topic=once}}
−
{{!}}{{!}}Allows you specify a function handler to run when the DOM has fully loaded.
+
{{!}}{{!}}Subscribes to notifications for first event for a particular type of Journey JavaScript SDK activity.
 
{{!}}-
 
{{!}}-
−
{{!}}{{!}}{{Link-SomewhereInThisManual|topic=debug}}<br />
+
{{!}}{{Link-SomewhereInThisVersion|manual=SDK|topic=off}}
−
{{!}}{{!}}Sends helpful messages to the console.
+
{{!}}Unsubscribes from notifications about a particular type of Journey JavaScript SDK activity.
 
{{!}}}
 
{{!}}}
−
|fullwidth=No
+
|Status=No
 
}}{{Section
 
}}{{Section
−
|sectionHeading=Visit API methods
+
|sectionHeading=Utility methods
−
|Type=Structured
+
|anchor=UtilityMethods
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=For more information about a method, click the method's name.
−
|structuredtext={{{!}} border="1"
+
{{{!}} class="wikitable"
 
{{!}}-
 
{{!}}-
−
!{{!}}Name
+
{{!}}{{!}}'''Method'''
−
!{{!}}Description
+
{{!}}{{!}}'''Description'''
 
{{!}}-
 
{{!}}-
−
{{!}}{{!}}<tt>ac('api.visit.get', callback)</tt>
+
{{!}}{{!}}
−
{{!}}{{!}}Performs an AJAX request to retrieve the session data from the<@@@TPL171654@@@>server. The object returned contains the most up-to-date data for the session. This is useful for monitoring live data, such as segment assigned IDs, outcome score progress, and last page viewed.
+
{{Link-SomewhereInThisManual|topic=serialize}}<br />
 +
{{!}}{{!}}Passes serialized data from a form.
 
{{!}}-
 
{{!}}-
−
{{!}}{{!}}<tt>ac('api.visit.cached', callback)</tt>
+
{{!}}{{!}}{{Link-SomewhereInThisManual|topic=dom_-_ready}}<br />
−
{{!}}{{!}}Retrieves the cached<@@@TPL171654@@@>session data from the browser local storage. If session data does not exist in local storage, a session will be requested via an AJAX request from<@@@TPL171654@@@>. This is practical for retrieving data that doesn't change for a session, such as the visit identifier, device details, location, referrer, and marketing campaign information.
+
{{!}}{{!}}Allows you to specify a function handler to run when the DOM has loaded fully.
 
{{!}}-
 
{{!}}-
−
{{!}}{{!}}<tt>ac('api.visit.getShortId', callback)</tt>
+
{{!}}{{!}}{{Link-SomewhereInThisManual|topic=debug}}<br />
−
{{!}}{{!}}This provides the same functionality as<tt>'api.visit.cached'</tt>, but only the 'shortId' is returned. The short ID is useful as a legible reference number that can be displayed on the website.
+
{{!}}{{!}}Sends helpful messages to the console.
−
{{!}}}
 
−
|fullwidth=No
 
−
}}{{Section
 
−
|sectionHeading=Customer API methods
 
−
|Type=Structured
 
−
|alignment=Vertical
 
−
|gif=No
 
−
|structuredtext={{{!}} border="1"
 
−
{{!}}-
 
−
!{{!}}Name
 
−
!{{!}}Description
 
−
{{!}}-
 
−
{{!}}{{!}}<tt>ac('api.customer.get', callback)</tt>
 
−
{{!}}{{!}}This performs an AJAX request to retrieve the visitor data from the<@@@TPL199248@@@>server.
 
 
{{!}}}
 
{{!}}}
−
|fullwidth=No
+
|Status=No
 
}}
 
}}
 
}}
 
}}

Latest revision as of 09:43, February 2, 2023

This topic is part of the manual Journey JavaScript SDK for version Current of Genesys Predictive Engagement.

View a list of methods available in the Journey JavaScript SDK.

Important
This article only applies to customers using web chat. If you are a Genesys Cloud CX customer, we encourage you to use the new web messaging feature to replace web chat.

Initialization methods

For more information about a method, including signature and arguments, click the method's name.

Method Description
init Initializes the Journey JavaScript SDK.
initialized Notifies when the Journey JavaScript SDK is initialized fully.
destroy Stops all Journey JavaScript SDK activity and removes all tracking information.

Session methods

For more information about a method, including signature and arguments, click the method's name.

Method Description
api.session.getData Returns an object that contains session information.
api.session.getCustomerCookieId Returns a string that contains the customer cookie ID.
api.session.getId Returns a string containing session ID.

Tracking methods

For more information about a method, including signature and arguments, click the method's name.

Method Description
pageview Tracks page views.
record Records custom website events.
forms:track  Captures when visitors complete web-based forms.

Events methods

For more information about a method, including signature and arguments, click the method's name.

Method Description
on Subscribes to notifications about a particular type of Journey JavaScript SDK activity.
once Subscribes to notifications for first event for a particular type of Journey JavaScript SDK activity.
off Unsubscribes from notifications about a particular type of Journey JavaScript SDK activity.

Utility methods

For more information about a method, click the method's name.

Method Description

serialize

 Passes serialized data from a form.
dom - ready
 Allows you to specify a function handler to run when the DOM has loaded fully.
debug
 Sends helpful messages to the console.
Retrieved from "https://all.docs.genesys.com/ATC/Current/SDK/Method_reference (2025-06-23 18:01:11)"
Comments or questions about this documentation? Contact us for support!