Difference between revisions of "ATC/Current/SDK/Init"

From Genesys Documentation
Jump to: navigation, search
(Published)
m (Text replacement - "Genesys Cloud" to "Genesys Cloud CX")
 
(4 intermediate revisions by one other user not shown)
Line 8: Line 8:
 
|Platform=PureConnect, GenesysCloud, GenesysEngage-cloud
 
|Platform=PureConnect, GenesysCloud, GenesysEngage-cloud
 
|Section={{Section
 
|Section={{Section
−
|sectionHeading=About web messaging
 
−
|anchor=WebMessaging
 
 
|alignment=Vertical
 
|alignment=Vertical
−
|structuredtext={{BarbFeatureTemp|Feature=Web messaging}}This article only applies to customers using web chat. If you are a Genesys Cloud 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. To use web messaging, you configure tracking through the [https://developer.mypurecloud.com/api/webmessaging/messengersdk/ Messenger JavaScript SDK] instead of deploying a tracking snippet.
+
|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
 
|Status=No
 
}}{{Section
 
}}{{Section
Line 17: Line 15:
 
|alignment=Vertical
 
|alignment=Vertical
 
|structuredtext=The <tt>init</tt> method initializes the Journey JavaScript SDK.
 
|structuredtext=The <tt>init</tt> method initializes the Journey JavaScript SDK.
−
 
+
{{NoteFormat|For GDPR compliance, obtain a customer's consent before you call the <tt>init</tt> method. For more information about how to use {{MINTYDOCSPRODUCT}} in a GDPR-compliant manner, see {{#mintydocs_link:manual=AdminGuide|topic=GDPR|link text=GDPR}}. |1}}
−
 
 
−
{{NoteFormat|For GDPR compliance, be sure to obtain a customer's consent before you call the <tt>init</tt> method. For more information about how to use {{MINTYDOCSPRODUCT}} in a GDPR-compliant manner, see {{#mintydocs_link:manual=AdminGuide|topic=GDPR|link text=GDPR}}. |1}}
 
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
Line 36: Line 32:
 
|anchor=organizationID
 
|anchor=organizationID
 
|alignment=Vertical
 
|alignment=Vertical
−
|structuredtext=*Description: your organization's unique ID. {{Link-SomewhereInThisVersion|manual=SDK|topic=Init|anchor=FindOrgRegion|display text=Find your organization ID}}
+
|structuredtext=*'''Description:''' Your organization's unique ID. {{Link-SomewhereInThisVersion|manual=SDK|topic=Init|anchor=FindOrgRegion|display text=Find your organization ID}}
−
*Type: string
+
*'''Type:''' String
−
*Status: required
+
*'''Status:''' Required
  
 
<br /><br />
 
<br /><br />
Line 48: Line 44:
 
|structuredtext={{NoteFormat|For detailed explanations of how you can use these options to configure tracking, see {{Link-SomewhereInThisVersion|manual=SDK|topic=Configure_advanced_tracking}}.|2}}
 
|structuredtext={{NoteFormat|For detailed explanations of how you can use these options to configure tracking, see {{Link-SomewhereInThisVersion|manual=SDK|topic=Configure_advanced_tracking}}.|2}}
  
−
*Description: configures the Journey JavaScript SDK with its region and other known default options.
+
*'''Description:''' Configures the Journey JavaScript SDK with its region and other known default options.
−
*Type: object
+
*'''Type:''' Object
−
*Status: required
+
*'''Status:''' Required
−
*Properties:
+
*'''Properties:''' See the following table.
  
 
{{{!}} class="wikitable" style="width: 1150px;" data-mce-style="width: 1150px;"
 
{{{!}} class="wikitable" style="width: 1150px;" data-mce-style="width: 1150px;"
Line 68: Line 64:
 
{{!}}-
 
{{!}}-
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}cookieDomain
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}cookieDomain
−
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Sets a custom cookie domain
+
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Sets a custom cookie domain.
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}String
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}String
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
Line 74: Line 70:
 
{{!}}-
 
{{!}}-
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}cookieExpires
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}cookieExpires
−
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Sets a time in seconds for a customer's cookie to expire
+
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Sets a time in seconds for a visitor's cookie to expire.
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}Number
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}Number
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
Line 80: Line 76:
 
{{!}}-
 
{{!}}-
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}cookiePrefix
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}cookiePrefix
−
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Sets a custom cookie prefix
+
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Sets a custom cookie prefix.
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}String
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}String
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
Line 98: Line 94:
 
{{!}}-
 
{{!}}-
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}canonicalLink
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}canonicalLink
−
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Uses canonical links
+
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Uses canonical links.
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}Boolean
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}Boolean
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
Line 104: Line 100:
 
{{!}}-
 
{{!}}-
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}globalTraitsMapper
 
{{!}} style="width: 210.535px;" data-mce-style="width: 210.535px;"{{!}}globalTraitsMapper
−
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Maps custom attributes to traits For more information, see {{Link-SomewhereInThisVersion|manual=SDK|topic=Traits_mapper|display text=Traits Mapper.}}
+
{{!}} style="width: 783.465px;" data-mce-style="width: 783.465px;"{{!}}Maps custom attributes to traits. For more information, see {{Link-SomewhereInThisVersion|manual=SDK|topic=Traits_mapper|display text=Traits Mapper.}}
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}Array
 
{{!}} style="width: 42px;" data-mce-style="width: 42px;"{{!}}Array
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
 
{{!}} style="width: 62px;" data-mce-style="width: 62px;"{{!}}Optional
Line 116: Line 112:
 
|Media=Image
 
|Media=Image
 
|image=InitOrgIDRegionID.png
 
|image=InitOrgIDRegionID.png
−
|structuredtext=Go to '''Genesys Cloud''' > '''Admin''' > '''Tracking Snippet'''.
+
|structuredtext=Go to '''Genesys Cloud CX''' > '''Admin''' > '''Tracking Snippet'''.
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
Line 122: Line 118:
 
|anchor=RegionNamesIDs
 
|anchor=RegionNamesIDs
 
|alignment=Vertical
 
|alignment=Vertical
−
|structuredtext=The following table lists the available region names and corresponding Ids.
+
|structuredtext=The following table lists the available region names and corresponding IDs.
 
{{{!}} class="wikitable"
 
{{{!}} class="wikitable"
 
{{!}}+
 
{{!}}+

Latest revision as of 21:27, November 9, 2021

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

Learn how to use the init method to initialize 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.

Description

The init method initializes the Journey JavaScript SDK.

Important
For GDPR compliance, obtain a customer's consent before you call the init method. For more information about how to use Genesys Predictive Engagement in a GDPR-compliant manner, see GDPR.

Signature

ac('init', organisationId, options)

Arguments

organizationId



options

Tip
For detailed explanations of how you can use these options to configure tracking, see Advanced tracking with cookies.
  • Description: Configures the Journey JavaScript SDK with its region and other known default options.
  • Type: Object
  • Status: Required
  • Properties: See the following table.
Name Description Type Status Default
region Your organization's region. Find your region ID String Required  
cookieDomain Sets a custom cookie domain. String Optional Highest level domain possible
cookieExpires Sets a time in seconds for a visitor's cookie to expire. Number Optional 31536000 (1 year)
cookiePrefix Sets a custom cookie prefix. String Optional  
autoLink An array of domains whose outbound links will be modified to contain tracking information. For an example, see Configure advanced tracking. Array of strings Optional  
allowedLinkers An array of domains whose inbound referral will set tracking information. For an example, see Configure advanced tracking. Array of strings Optional  
canonicalLink Uses canonical links. Boolean Optional False
globalTraitsMapper Maps custom attributes to traits. For more information, see Traits Mapper. Array Optional  

Find your org ID and region ID

Go to Genesys Cloud CX > Admin > Tracking Snippet.

Region names and IDs

The following table lists the available region names and corresponding IDs.

Region name ID
Americas (US West) usw2
Americas (US East) use1
Americas (Canada) cac1
EMEA (Dublin) euw1
EMEA (London) euw2
EMEA (Frankfurt) euc1
Asia Pacific (Tokyo) apne1
Asia Pacific (Seoul) apne2
Asia Pacific (Sydney) apse2
Retrieved from "https://all.docs.genesys.com/ATC/Current/SDK/Init (2025-06-19 06:43:51)"
Comments or questions about this documentation? Contact us for support!