Vous êtes ici :
Cartouche Marketing de parrainage pour Commerce
Le cartouche Marketing de parrainage contient des métadonnées et des pages HTML qui permettent de configurer vos préférences de programme de parrainage et d'exécuter le programme sur le site B2C Commerce. La cartouche doit être ajoutée à votre site B2C Commerce. Vous pouvez ajouter la cartouche uniquement aux sites dans lesquels SFRA 6.1.0 est installé et dans lesquels les paramètres de l'API Open Commerce (OCAPI) sont terminés.
Éditions requises
| Disponible avec : Lightning Experience |
| Disponible avec : Enterprise Edition, Performance Edition, Unlimited Edition et Developer Edition avec Marketing de parrainage |
Vous pouvez télécharger la cartouche Marketing de parrainage pour Commerce dans votre système local depuis GitHub.
Après avoir ajouté la cartouche à votre système local, utilisez une interface de ligne de commande (CLI) pour ajouter automatiquement la cartouche ou ajoutez-la manuellement à votre site B2C Commerce.
Prérequis à l'utilisation de la CLI pour ajouter la cartouche
- Obtenez les versions compatibles de :
- Node.js : 14.21.3
- npm : Version 6.14.18
- Téléchargez la SFRA (Store Front Reference Architecture) 6.2.0. Renommez le dossier en storefront-reference-architecture.
- Déplacez le dossier Referral que vous avez téléchargé vers le même dossier qui contient le dossier storefront-reference-architecture.
- Exécutez npm ci et npm run compile:js && npm run compile:scss && npm run compile:fonts pour le dossier SFRA.
- Déployez des sites de démonstration d'architecture de référence Storefront dans votre instance :
- Accédez à Administration | Développement de site | Importation et exportation de site .
- Sélectionnez Storefront Reference Architecture Demo Sites, puis cliquez sur Importer.
- Cliquez sur Déployer.
- Accordez à votre clé d'API l'accès à votre instance si vous ajoutez la cartouche manuellement.
Pour plus d'informations, consultez la section Octroi de l'accès à votre clé d'API à vos instances dans Salesforce Commerce Cloud CLI.
Ajout automatique de la cartouche
- Configurez les variables d'environnement suivantes dans votre site B2C Commerce :
Variable Description SFCC_OAUTH_CLIENT_ID L'ID client utilisé pour l'authentification. L'ID de client est disponible dans le Gestionnaire de compte. SFCC_OAUTH_CLIENT_SECRET Le secret client utilisé pour l'authentification. Le secret client est le mot de passe que vous avez créé en créant votre ID client. SFCC_HOSTNAME L'alias de votre sandbox. SFCC_CODE_VERSION La version de code pour laquelle vous souhaitez ajouter la cartouche. Vous trouverez la version de code de votre site sur Adminstration | Déploiement de code dans le Gestionnaire de compte. SFCC_SITE_IDS L'ID du site B2C Commerce auquel ajouter la cartouche. - Si dw.json est disponible dans votre dossier referral-marketing-for-commerce/src/sfcc, supprimez-le.
- Dans votre CLI, exécutez les commandes suivantes :
- npm ci
- npm run compile:js && npm run compile:scss
- npm run -s deploy:auto
export SFCC_OAUTH_CLIENT_ID=xxxxxxa1-xxx2-xxx3-xxx4-xxxxxxxxx5 && \
export SFCC_OAUTH_CLIENT_SECRET=samplepassword && \
export SFCC_HOSTNAME=sandbox-01-inside-the-realm.cloudkicks.net && \
export SFCC_CODE_VERSION=version1
export SFCC_SITE_IDS="sampleSiteID"
Pour Windows, voici un exemple de paramètre de variable d'environnement :set SFCC_OAUTH_CLIENT_ID=xxxxxxa1-xxx2-xxx3-xxx4-xxxxxxxxx5 &&
set SFCC_OAUTH_CLIENT_SECRET=samplepassword &&
set SFCC_HOSTNAME=sandbox-01-inside-the-realm.cloudkicks.net &&
set SFCC_CODE_VERSION=version1
set SFCC_SITE_IDS=sampleSiteID
Ajout manuel de la cartouche
- Assurez-vous que dw.json est disponible dans votre dossier referral-marketing-for-commerce/src/sfcc et contient les variables suivantes :
Variable Description client-id L'ID client utilisé pour l'authentification. L'ID de client est disponible dans le Gestionnaire de compte. hostname L'alias de votre sandbox. code-version La version de code pour laquelle vous souhaitez ajouter la cartouche. Vous trouverez la version de code de votre site sur Adminstration | Déploiement de code dans le Gestionnaire de compte. site-ids Facultatif. L'ID du site B2C Commerce auquel ajouter la cartouche. password Le mot de passe que vous recevez lorsque vous générez la clé d'accès pour Accès aux fichiers WebDav et UX Studio dans Business Manager. username Le nom d'utilisateur que vous utilisez pour vous connecter à Business Manager. - Dans votre CLI, exécutez les commandes suivantes :
- npm ci
- npm run compile:js && npm run compile:scss
- npm run -s deploy
- Authentifiez-vous si vous y êtes invité.
{
"client-id": "xxxxxxa1-xxx2-xxx3-xxx4-xxxxxxxxx5",
"hostname": "sandbox-01-inside-the-realm.cloudkicks.net",
"code-version": "version1",
"site-ids": "sampleSiteID",
"password": "yourpwd",
"username": "mevans@cloudkicks.net"
}Affichage de la cartouche sur le site B2C Commerce
- Accédez à Responsable de compte.
- Cliquez sur Administration | Sites | Gérer les sites .
- Ouvrez le site auquel vous avez ajouté la cartouche, puis cliquez sur Paramètres.
La cartouche est affichée dans le champ Cartouches.
Mise à jour de l'identifiant du service Web
La cartouche ajoute un service Web nommé b2ccrmsync.RefArch à votre site B2C Commerce. Vous devez mettre à jour l'identifiant du service Web avec la clé consommateur, le secret consommateur de l'application connectée et l'URL de rappel de l'application connectée.
/success par /token dans l'URL de rappel.