Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

This data connector is in Beta. For more information, contact support@treasuredata.com.


Commerce Cloud connects the customer journey and drives success from anywhere with customer-centric commerce built for every industry.

...

What can you do with this Integration?

...

hiddentrue

Include a bulleted list (at least two bullets) of what the customer can do with the integration. 

PRD Use Cases Example

Use Cases

...

As a marketing operator, I want to incrementally send segmented users attributes to Braze, where I can easily create the segments based on these information for targeting correct consumers.

...

As a data engineer, I want to automatically map the custom Ids of the consumers to Braze unidentified users so that I can facilitate multiple marketing tools on the marketing campaign

...

  • Salesforce Commerce Cloud Import Integration will provide the following abilities:

    • Authenticate using API Client via OAuth.

    • Ingest customer information for a specific list

    • Ingest of Customer resources, for example:

      • customer information

      • name, gender, email

    • Ingest Product resource, for example:

      • a list of products

      • product information

    • Ingest Inventory and Product Inventories resource, for example:
      • list of inventories
      • product inventory allocation
      • product inventory stock level 
      • product inventory ID
    • Ingest Category and Product Assignments resource, for example:
      • category information
      • product belongs to each category
    • Ingest Store resources, for example:

      • all stores

      • store information including id, address, postal code, country, inventory id

    • Ingest Catalog resources, for example:
      • catalog info
      • assigned product counts

...

  • Basic Knowledge of Treasure Data

  • Basic knowledge of Treasure Data CLI

  • Basic knowledge of Salesforce Commerce Cloud
  • Basic knowledge of Open Commerce Cloud API
  • Commerce Cloud Account Manager System Access

...

Limitations

  • The application secret should not contain the %  character. Due to an internal issue with the SFCC authentication server, any secret the contains the % character, is not able to authenticate.
  • Incremental loading is only supported for Creation Date, not Modified Date
  • Large A large volume of data may cause low performance
  • In preview mode, the connector does not support generating the detailed data preview because of time restrictions on fetching the data preview.
  • An Inventory List with no product is still inserted as one record, the properties belong to the Product Inventory List and will be null.

About Incremental Data

...

Loading  


Excerpt Include
About Incremental Loading
About Incremental Loading
nopaneltrue

...


Create the API Client on Commerce Cloud Account Manager System

These steps are necessary to create the credentials that are needed to define the authentication for your integration.


Numbered Headings
start-numbering-with1

...

start-numbering-ath5
Navigate to the Salesforce Cloud Commerce UI and login. For example, Account Manager UI

...

.

Image Added


Select API Client.

Image Modified

...

Select Add API Client

...

.

Image Modified

...

Type values for:
    • Display Name

...

    • Password

...

    • Confirm Password

...

...

Select Access Control

...

6. On Organizations choose your organization

7. On Roles section, click Add button

8. In Assign Roles dialog, choose appropriate role (in this case is Sandbox API User) then click Add

Image Removed

9. After role is added, click on the marked icon in below image

Image Removed

...

to enable it.
In the Organizations area, select your organization.
In the Roles area, select Add.
Select the appropriate role. For example, Sandbox API User.

Image Added

Select Add.
After the role is added, select all the sandboxes associated with it.

Image Added

Select Add.
Scroll down to Open ID Connect

...

.
Add Default Scopes:
    • mail
    • roles
    • tenantFilter
    • profile

...

Add Redirect URI. For example:

https://admin.us01.dx.commercecloud.salesforce.com/oauth2-redirect.html

...

Scroll totheToken Endpoint Auth Methodsection

...

.
Select client_secret_basic.

...

Select JWT for Access Token Format

...

.

...

Image Modified

...

Select Save.

You

...

are taken back to theAPI Clientscreen.

Image Modified

...



Write down or save in a secure location the API Client ID and Password.

...

These are used as Authentication credentials to integrate with your SFCC instance.

Page properties
hiddentrue

Step 2: How to enable API Client to access Data API

...


Enable the API Client to Access the Data API

These steps enable your API Client to be used with the Data API and Salesforce B2C Commerce Cloud connector.

Numbered Headings
start-numbering-ath5
Open Business Manager. For example:

https://{YOUR_INSTANCE_URL}.commercecloud.salesforce.com/on/demandware.store/Sites-Site/default/ViewApplication-DisplayWelcomePage

...

...

Select Administration.
Select Open Commerce API Settings.

Image Modified

...


Select Type as Data.

Image Modified

...

The configuration for Data API

...

appears.

Type or copy the following into the text field:
Code Block
{ "_v": "21.6", "clients": [ { "client_id": "your_api_client_id", "resources": [ { "methods": [ "get", "post", "put", "patch", "delete" ], "read_attributes": "(**)", "write_attributes": "(**)", "resource_id": "/**" } ] } ] }
For Select Context choose Global (organization-wide).

Image Modified

...

Select Save.
Wait for at least 3 minutes

...

.

Your API Client is ready to be used with Data

...

API and Salesforce B2C Commerce Cloud connector.

...

details

hiddentrue

Use the TD Console to Create Your Connection

...

Numbered Headings
start-numbering-with1
start-numbering-ath5
Open Open TD Console.
Navigate to to Integrations Hub   >  Catalog.
Search for and select Salesforce B2C Commerce Cloud.

Choose Create Authentication.

The following dialog opens:

Enter


Type or select the required information:
ParameterDescription

API Client ID

Key which you got after create your application on Commerce Cloud's Account Manager Application.

API Client Password

The password for your API Client when you create on Commerce Cloud's Account Manager Application.

Base URI

URL for accessing your Business Manager Application. Example value https://xxxx.commercecloud.salesforce.com/

Enter
Type a name for your connection.

Select Continue.



Transfer Your Data to Treasure Data

...

Numbered Headings
start-numbering-with1
start-numbering-ath5

After creating the authenticated connection, you are automatically taken to Authentications.


Search for the connection you created. 

Select New Source.
Type a name for your Source in the Data Transfer field.

Select Next.

The Source Table dialog opens.

Edit the following parameters:

Parameters DescriptionDescription of Data Types
Data Type
*
The data objects that you want to ingest into Treasure Data:

Customers From List

The customer info from a specific customer list


Products

Product info of Salesforce Commerce Cloud account


Categories and Product Assignments

Product category info and products belong to each category


Inventory Lists and Product Inventories

Inventory list and product in each inventory list


StoresStore info, location, and inventory belongs to stores

CatalogsProduct catalog info and count of products for each catalog 
Customer List IDThe customer List ID you want to import customer information from
Incremental loadingSelect to ingest only newly created data since the previous ingestion.
Created FromThe specific time you would like to ingest the data (YYYYMMDDHH format).
Select Next.

The Data Settings page can be modified for your needs or you can skip the page.

Optionally, edit the following parameters:


Select Next.

...

Data

...

Target

...

Description

...

Customers From List

...

The customer info from a specific customer list

...

Products

...

Product info of Salesforce Commerce Cloud account

...

Categories and Product Assignments

...

Product category info and products belong to each category

...

Inventory Lists and Product Inventories

...

Inventory list and product in each inventory list

...

Data Preview 

Limitation 

...


Numbered Headings

Excerpt Include
Data Preview
Data Preview
nopaneltrue

...

Numbered Headings

Excerpt Include
Data Placement
Data Placement
nopaneltrue

Available Configuration

Configuration name

Type

Available when

Required

Sample value

Description

base_url

STRING

default

yes

https://xxxx.example.com

SFCC’s instance base url

catalog_id

STRING

target = categories

no

test

Catalog’s ID

client_id

STRING

default

yes

abcdef

Application’s ID

client_secret

STRING

default

yes

abcdef

Application’s Secret

customer_list_id

STRING

target = customers

yes if target = customers

test

Customer List Id

incremental

BOOLEAN

target = customers

target = products

target = catalog

no

true

Ingest incremental or not

initial_retry_wait

LONG

default

no

1

First wait time when retrying (in seconds)

inventory_list_id

STRING

target = inventory_lists

no

test

Inventory List’s ID

last_value

STRING

target = customers

target = products

target = catalog

no

2021-05-25T02:49:29.000Z

The timestamp to start ingest data

levels

LONG

target = categories

yes if target = categories

0

Level of sub-category to ingest when target = categories

maximum_retries

LONG

default

no

5

Maximum number of retry

maximum_retry_wait

LONG

default

no

120

Max wait time when retrying (in seconds)

site_id

STRING

target = products

target = stores

yes if target = stores

test

The Site ID

target

ENUM (customers , stores , categories , products , catalogs , inventory_lists )

default

yes

customers

Target data type to ingest


Sample Configuration

Customers

...