DokumentationGenStudioHandbok för utökningsmöjligheter

Experience Selector MFE i Salesforce

Senast uppdaterad: 14 maj 2026

Skapat för:

  • Developer

I det här avsnittet beskrivs hur kunder och implementerare kan distribuera och köra GenStudio for Performance Marketing Experience Selector Microfront (MFE) i en Salesforce-organisation. Det omfattar administratörssteg (ingen kod), utvecklarsteg (distribuera och konfigurera) och säkerhetsrelaterade inställningar som Content Security Policy (CSP).

Allmänna MFE-integreringsalternativ, konfigurationsegenskaper och exempel på ramverk finns i GenStudio Experience Selector MFE.

Vad den här integreringen gör

https://video.tv.adobe.com/v/3491083?captions=swe&learn=on

Lightning Web Component (LWC) sfgsmfe läser in UMD-paketet för Adobe Experience Selector och återger det i ett <dialog> så att användare kan välja en upplevelse från GenStudio for Performance Marketing.

Integreringen kan även

  • Förhandsgranska och avkoda: Visa den valda nyttolasten som JSON, avkodad HTML och en sanerad HTML-förhandsvisning inuti LWC.
  • E-postmallar (valfritt): Ett Create Email Template-flöde i Salesforce kan anropa Apex (EmailTemplateController.createEmailTemplate) för att infoga en EmailTemplate-post (HTML, ämne och mapp).

Skriptet Experience Selector för GenStudio for Performance Marketing läses in från Adobe värdbaserade URL på experience.adobe.com, inte från en statisk Salesforce-resurs i den vanliga implementeringen.

Förutsättningar

  • Salesforce-organisation: En sandlåda eller produktionsorganisation där du kan distribuera metadata och använda Lightning App Builder.

  • Salesforce CLI: Salesforce CLI (sf) installeras och autentiseras, till exempel:

    code language-bash 
    sf org login web --alias <your-org-alias>

  • Behörigheter: Användare som skapar e-postmallar måste ha tillgång till målmappen för e-postmallar och rättigheter för att kunna skapa mallar enligt dina organisationsprofiler. Apex kör with sharing.

  • Adobe/GenStudio: Ditt Adobe IMS-organisations-ID och SUSI clientId måste matcha din Adobe-konfiguration (se Konfigurera integreringsvärden).

  • Webbläsare/CSP: Salesforce måste tillåta inläsning av skript från https://experience.adobe.com (se Konfigurera skyddsprofil för innehåll och Adobe URL).

Distribuera paketet (utvecklare)

Projektet använder Salesforce DX-layout, standardpaketkatalogen är force-app.

  1. Distribuera källan till målorganisationen från projektets rot:

    code language-bash 
    sf project deploy start --source-dir force-app --target-org <your-org-alias>

  2. Bekräfta att distributionen slutförs utan fel.

  • force-app/main/default/lwc/sfgsmfe - LWC-paket (HTML, JS, CSS, meta).
  • force-app/main/default/classes/EmailTemplateController.cls - Apex för att skapa mallar.

Svaret kan också innehålla statiska resurser (reactApp, sfgsmfe_react). Den aktuella GenStudio for Performance Marketing-inläsaren i sfgsmfe.js använder Adobe CDN-URL:en för standalone.js; Statiska resurser krävs inte för den inläsningssökvägen om du inte ändrar implementeringen.

Lägga till komponenten på en Lightning-sida (admin)

Komponenten sfgsmfe visas för:

  • Appsidor för Lightning
  • Hemsidor
  • Spela in sidor
  • Tabbar (via en Lightning-sida på en anpassad flik)

Så här lägger du till komponenten:

  1. Öppna App Manager i Setup.
  2. Skapa en New Lightning App (eller öppna en befintlig app som du vill utöka).
    Den nya Lightning-appen modal {width="80%" modal="regular"}
  3. Öppna appen och välj Edit.
    Modulen Redigera Lightning-app {width="80%" modal="regular"}
  4. Skapa en New Page (eller redigera en befintlig Lightning-sida).
    Den nya sidan modal {width="60%" modal="regular"}
  5. I Lightning App Builder drar du sfgsmfe -komponenten till layouten.
  6. Save, Activate och tilldela sidan till rätt Lightning-app, profiler och appsynlighet så att avsedda användare kan öppna den.

Konfigurera skyddsprofil för innehåll och Adobe URL

LWC injerar en <script>-tagg vars src pekar på Adobe UMD-paket, till exempel:

https://experience.adobe.com/solutions/GenStudio-experience-selector-mfe/static-assets/resources/@genstudio/experience-selector/umd/standalone.js

Du måste konfigurera Salesforce så att detta ursprung tillåts för skriptinläsning enligt organisationens CSP- och Lightning-säkerhetsinställningar.

Om skriptet inte kan läsas in:

  1. Öppna webbläsarens utvecklingsverktyg.
  2. Kontrollera om flikarna Console och Network innehåller blockerade förfrågningar eller CSP-överträdelser.
  3. Lägg till eller justera Trusted URLs (och eventuella relaterade inställningar för din Salesforce-version) för https://experience.adobe.com, efter aktuell Salesforce-dokumentation för Lightning.
    Salesforce CSP - tillförlitliga platser {width="80%" modal="regular"}

Konfigurera integreringsvärden (utvecklare/implementering)

Flera värden har angetts i LWC JavaScript för sfgsmfe. Kunderna byter vanligtvis ut dessa mot varandra.

Värde
Beskrivning
folderId
Salesforce-mapp-ID (00l...) för e-postmallar där nya mallar skapas. Krävs för Apex. mappen måste finnas och vara tillgänglig för den användare som körs.
imsOrg
Adobe IMS-organisationsidentifierare skickades till GenStudioExperienceSelector.renderExperienceSelectorWithSUSI.
susiConfig.clientId
Klient-ID för Adobe SUSI för Experience Selector-appregistrering.
GenStudio script.src
URL för UMD standalone.js-paketet; uppdatera om Adobe publicerar en ny sökväg.

Skapande av e-postmall mappar GenStudio-fält till mallen (till exempel ämne från experienceFields). Justera mappningar i LWC om innehållsmodellen skiljer sig åt.

Mer information om renderExperienceSelectorWithSUSI och relaterade alternativ finns i Konfigurationsegenskaper i avsnittet Experience Selector MFE.

Apex: EmailTemplateController

EmailTemplateController.createEmailTemplate normalt:

  • Validerar mallnamnet, mapp-ID och HTML som inte är tomt.
  • Skapar en EmailTemplate med TemplateType = 'custom', HtmlValue, Subject, Body och mapptilldelning.
  • Ytfel i den lokala lagringsplatsen till och med AuraHandledException.

Drifttips:

  • Respektera DeveloperName-unika regler och namngivningsregler i organisationen.
  • Bekräfta mapp-ID:t och att användaren kan skapa EmailTemplate-poster i den mappen.
  • Använd Salesforce felsökningsloggar när det inte går att hitta det exakta felet i DML.

Checklista för validering

Bekräfta objekten i den här listan efter distribution och konfiguration för en säker validering av integreringen:

  1. Distributionen slutförs utan fel.
  2. Användare kan öppna Lightning-sidan som innehåller sfgsmfe och se Experience Selector UI.
  3. Komponenten visar inget inläsningsfel. på fliken Nätverk returneras HTTP 200 för standalone.js.
  4. Select a GenStudio Experience öppnar körningen av väljaren och återanrop för markering.
  5. Create Email Template lyckas när du använder det flödet och mallen visas under den konfigurerade mappen i Setup.

Se även

recommendation-more-help
genstudio-for-performance-marketing-help-extensibility