Salesforce CRM-anslutning

Översikt overview

Salesforce CRM är en populär CRM-plattform (Customer Relationship Management) och stöder profiltyperna som beskrivs nedan:

  • Leads - Ett lead är namnet på en person eller ett företag som kan (eller inte) vara intresserad av de produkter eller tjänster som du säljer.
  • Kontakter - En kontakt är en person med vilken en av dina representanter har upprättat en relation och har kvalificerats som en potentiell kund.

Det här Adobe Experience Platform målet använder Salesforce composite API, som har stöd för båda profiltyperna som beskrivs ovan.

När du aktiverar segment kan du välja mellan leads eller kontakter och uppdatera attribut och målgruppsdata till Salesforce CRM.

Salesforce CRM använder OAuth 2 med lösenordsbeviljande som autentiseringsmekanism för att kommunicera med Salesforce REST API. Instruktioner för autentisering till din Salesforce CRM-instans finns längre ned i avsnittet Autentisera till mål.

Användningsfall use-cases

Som marknadsförare kan ni leverera personaliserade upplevelser till era användare, baserat på attribut från deras Adobe Experience Platform-profiler. Du kan bygga målgrupper utifrån dina offlinedata och skicka dessa målgrupper till Salesforce CRM för att uppdatera CRM-medlemskapet så snart som målgrupper och profiler uppdateras i Adobe Experience Platform.

Förhandskrav prerequisites

Förutsättningar i Experience Platform prerequisites-in-experience-platform

Innan du aktiverar data till Salesforce CRM-målet måste du ha ett schema, en datamängd och segment som skapats i Experience Platform.

Förutsättningar i Salesforce CRM prerequisites-destination

Observera följande krav i Salesforce CRM för att kunna exportera data från plattformen till ditt Salesforce-konto:

Du måste ha ett Salesforce-konto prerequisites-account

Gå till sidan Salesforce utvärderingsversion om du vill registrera och skapa ett Salesforce-konto, om du inte redan har ett.

Konfigurera en ansluten app i Salesforce prerequisites-connected-app

Först måste du konfigurera en Salesforce ansluten app i ditt Salesforce-konto, om du inte redan har en. Salesforce CRM utnyttjar den anslutna appen för att ansluta till Salesforce.

Aktivera sedan OAuth Settings for API Integration för Salesforce connected app. Mer information finns i Salesforce-dokumentationen.

Se även till att de omfattningar som nämns nedan är markerade för Salesforce connected app.

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

Kontrollera slutligen att password-anslaget är aktiverat i ditt Salesforce-konto. Om du behöver hjälp kan du läsa dokumentationen för Salesforce OAuth 2.0-användarnamn-lösenord för särskilda scenarier .

IMPORTANT
Om din Salesforce-kontoadministratör har begränsat åtkomsten till betrodda IP-intervall måste du kontakta dem för att få Experience Platform IP:ns tillåtslista. Mer information finns i dokumentationen för Salesforce Begränsa åtkomst till betrodda IP-intervall för ett anslutet program om du behöver ytterligare hjälp.

Skapa anpassade fält i Salesforce prerequisites-custom-field

När du aktiverar målgrupper till målet Salesforce CRM måste du ange ett värde i fältet Mapping ID för varje aktiverad målgrupp i steget Målgruppsschema.

Salesforce CRM kräver det här värdet för att kunna läsa och tolka målgrupper som kommer från Experience Platform korrekt och för att uppdatera deras målgruppsstatus inom Salesforce. Se Experience Platform-dokumentationen för schemafältgruppen Information om målgruppsmedlemskap om du behöver vägledning om målgruppsstatus.

För varje målgrupp som du aktiverar från Platform till Salesforce CRM måste du skapa ett anpassat fält av typen Text Area (Long) i Salesforce. Du kan definiera längden på fälttecknen i valfri storlek mellan 256 och 131 072 tecken beroende på ditt företags behov. Mer information om anpassade fälttyper finns på dokumentationssidan Salesforce Anpassade fälttyper. Se även Salesforce-dokumentationen för att skapa anpassade fält om du behöver hjälp med att skapa fält.

IMPORTANT
Ta inte med blankstegstecken i fältnamnet. Använd i stället understrecket (_) som avgränsare.
Inom Salesforce måste du skapa anpassade fält med en Field Name som exakt matchar värdet som anges i Mapping ID för varje aktiverat plattformssegment. Skärmbilden nedan visar till exempel ett anpassat fält med namnet crm_2_seg. När du aktiverar en målgrupp på det här målet lägger du till crm_2_seg som Mapping ID för att fylla målgrupper från Experience Platform i det här anpassade fältet.

Ett exempel på hur du skapar anpassade fält i Salesforce, Steg 1 - Välj datatyp visas nedan:
Salesforce-användargränssnitt som visar hur du skapar anpassade fält, steg 1 - Välj datatyp.

Ett exempel på hur du skapar anpassade fält i Salesforce, Steg 2 - Ange information för anpassade fält visas nedan:
Salesforce-användargränssnitt som visar hur du skapar anpassade fält, steg 2 - Ange information för anpassade fält.

TIP
  • Om du vill skilja mellan anpassade fält som används för plattformsmålgrupper och andra anpassade fält i Salesforce kan du inkludera ett identifierbart prefix eller suffix när du skapar det anpassade fältet. Använd till exempel Adobe_test_segment eller test_segment_Adobe i stället för test_segment
  • Om du redan har andra anpassade fält skapade i Salesforce kan du använda samma namn som plattformssegmentet för att enkelt identifiera målgruppen i Salesforce.
NOTE
  • Objekt i Salesforce är begränsade till 25 externa fält, se Anpassade fältattribut.
  • Den här begränsningen innebär att du bara kan ha högst 25 medlemskap för Experience Platform som är aktiva när som helst.
  • Om du har nått den här gränsen i Salesforce måste du ta bort de anpassade attribut från Salesforce som användes för att lagra målgruppsstatusen mot äldre målgrupper inom Experience Platform innan en ny Mapping ID kan användas.

Samla in inloggningsuppgifter för Salesforce CRM gather-credentials

Observera objekten nedan innan du autentiserar till målet Salesforce CRM:

Autentiseringsuppgifter
Beskrivning
Exempel
Username
Användarnamn för ditt Salesforce-konto.
Password
Lösenordet för ditt Salesforce-konto.
Security Token
Din Salesforce-säkerhetstoken som du senare lägger till i slutet av ditt Salesforce-lösenord för att skapa en sammanfogad sträng som ska användas som Password vid autentisering till målet.
Läs Salesforce-dokumentationen för att återställa din säkerhetstoken och lär dig hur du återskapar den från Salesforce-gränssnittet om du inte har säkerhetstoken.
Custom Domain
Domänprefixet Salesforce.
Läs Salesforce dokumentationen om du vill veta hur du hämtar det här värdet från gränssnittet Salesforce.
Om din Salesforce-domän är
d5i000000isb4eak-dev-ed.my.salesforce.com,
du behöver d5i000000isb4eak-dev-ed som värde.
Client ID
Din Salesforce Consumer Key.
Mer information om hur du hämtar det här värdet från gränssnittet Salesforce finns i Salesforce dokumentationen.
Client Secret
Din Salesforce Consumer Secret.
Mer information om hur du hämtar det här värdet från gränssnittet Salesforce finns i Salesforce dokumentationen.

Guardrails guardrails

Salesforce balanserar transaktionsinläsningar genom att införa gräns för antal begäranden, frekvens och tidsgräns. Mer information finns i API-begäransgränser och allokeringar.

Om din Salesforce-kontoadministratör har infört IP-begränsningar måste du lägga till Experience Platform IP-adresser i Salesforce-kontonas betrodda IP-intervall. Mer information finns i dokumentationen för Salesforce Begränsa åtkomst till betrodda IP-intervall för ett anslutet program om du behöver ytterligare hjälp.

IMPORTANT
När du aktiverar segment måste du välja mellan typerna Kontakt eller Lead. Ni måste se till att era målgrupper har rätt datamappning beroende på vilken typ som valts.

Identiteter som stöds supported-identities

Salesforce CRM har stöd för uppdatering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.

Målidentitet
Beskrivning
Överväganden
SalesforceId
Identifieraren Salesforce CRM för de kontakt- eller lead-ID som du exporterar eller uppdaterar genom ditt segment.
Obligatoriskt

Exportera typ och frekvens export-type-frequency

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Objekt
Typ
Anteckningar
Exporttyp
Profile-based
  • Du exporterar alla medlemmar i ett segment, tillsammans med de önskade schemafälten (till exempel e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • Varje målgruppsstatus i Salesforce CRM uppdateras med motsvarande målgruppsstatus från Platform, baserat på värdet Mapping ID som tillhandahölls under steget målgruppsplanering.
Exportfrekvens
Streaming
  • Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på målgruppsutvärdering skickar anslutningsprogrammet uppdateringen nedströms till målplattformen. Läs mer om direktuppspelningsmål.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekursen för destinationskonfiguration. I arbetsflödet för att konfigurera mål fyller du i fälten som listas i de två avsnitten nedan.

I Destinations > Catalog söker du efter Salesforce CRM. Du kan också hitta den under kategorin CRM.

Autentisera till mål authenticate

Om du vill autentisera mot målet fyller du i de obligatoriska fälten nedan och väljer Connect to destination. Mer information finns i avsnittet Samla Salesforce CRM inloggningsuppgifter.

Autentiseringsuppgifter
Beskrivning
Username
Användarnamn för ditt Salesforce-konto.
Password
En sammanfogad sträng bestående av ditt Salesforce-kontolösenord har lagts till med din Salesforce-säkerhetstoken.
Det sammanfogade värdet har formen {PASSWORD}{TOKEN}.
Obs! Använd inga klammerparenteser eller mellanslag.
Om ditt Salesforce lösenord till exempel är MyPa$$w0rd123 och Salesforce säkerhetstoken är TOKEN12345....0000 är det sammanfogade värde som du kommer att använda i fältet Password MyPa$$w0rd123TOKEN12345....0000.
Custom Domain
Domänprefixet Salesforce.
Om din domän till exempel är d5i000000isb4eak-dev-ed.my.salesforce.com måste du ange d5i000000isb4eak-dev-ed som värde.
Client ID
Ditt Salesforce anslutna program Consumer Key.
Client Secret
Ditt Salesforce anslutna program Consumer Secret.

Skärmbild av användargränssnittet för plattformen som visar hur du autentiserar.

Om den angivna informationen är giltig visar gränssnittet Connected-status med en grön bockmarkering, och du kan sedan fortsätta till nästa steg.

Fyll i målinformation destination-details

Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.

  • Name: Ett namn som du känner igen det här målet med i framtiden.

  • Description: En beskrivning som hjälper dig att identifiera det här målet i framtiden.

  • Salesforce ID Type:

    • Välj Contact om de identiteter som du vill exportera eller uppdatera är av typen Kontakt.
    • Välj Lead om de identiteter som du vill exportera eller uppdatera är av typen Lead.

Skärmbild för plattformsgränssnitt som visar målinformationen.

Aktivera aviseringar enable-alerts

Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.

Välj Next när du är klar med att ange information för målanslutningen.

Aktivera målgrupper till det här målet activate

IMPORTANT
  • För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.
  • Om du vill exportera identiteter måste du ha View Identity Graph åtkomstkontrollbehörighet.
    Markera identitetsnamnområdet som är markerat i arbetsflödet för att aktivera målgrupper till mål. {width="100" modal="regular"}

Läs Aktivera profiler och målgrupper för att direktuppspela målgruppsexportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

Mappa överväganden och exempel mapping-considerations-example

Om du vill skicka målgruppsdata från Adobe Experience Platform till målet Salesforce CRM måste du gå igenom fältmappningssteget. Mappningen består av att skapa en länk mellan XDM-schemafälten (Experience Data Model) i ditt plattformskonto och motsvarande motsvarigheter från målmålet.

Attribut som anges i Target field ska namnges exakt så som beskrivs i tabellen för attributmappningar eftersom dessa attribut kommer att utgöra begärandetexten.

Attribut som anges i Source field följer inte någon sådan begränsning. Du kan mappa den baserat på dina behov, men kontrollera att indata-formatet är giltigt enligt Salesforce dokumentationen. Om indata inte är giltiga kommer uppdateringsanropet till Salesforce att misslyckas och dina kontakter/leads kommer inte att uppdateras.

Följ de här stegen för att mappa dina XDM-fält korrekt till målfälten för (API) Salesforce CRM:

  1. I steget Mapping väljer du Add new mapping så visas en ny mappningsrad på skärmen.
    Exempel på skärmbild för användargränssnittet för plattformen för Lägg till ny mappning.

  2. Välj kategorin Select attributes i fönstret Select source field och markera XDM-attributet eller välj Select identity namespace och välj en identitet.

  3. I fönstret Select target field väljer du Select identity namespace och sedan en identitet eller väljer Select custom attributes-kategori och väljer ett attribut eller definierar ett med hjälp av fältet Attribute name efter behov. Mer information om attribut som stöds finns i Salesforce CRM dokumentationen.

    • Upprepa de här stegen för att lägga till följande mappningar mellan XDM-profilschemat och (API) Salesforce CRM:

    Arbeta med kontakter

    • Om du arbetar med Kontakter i ditt segment kan du definiera mappningar för de fält som ska uppdateras genom att läsa objektreferensen i Salesforce för kontakt.

    • Du kan identifiera obligatoriska fält genom att söka efter ordet Obligatorisk, som anges i fältbeskrivningar i länken ovan.

    • Beroende på vilka fält du vill exportera eller uppdatera lägger du till mappningar mellan XDM-profilschemat och (API) Salesforce CRM:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Source Field Målfält Anteckningar
      IdentityMap: crmID Identity: SalesforceId Mandatory
      xdm: person.name.lastName Attribute: LastName Mandatory. Kontaktens efternamn är högst 80 tecken.
      xdm: person.name.firstName Attribute: FirstName Kontaktens förnamn är högst 40 tecken långt.
      xdm: personalEmail.address Attribute: Email Kontaktens e-postadress.
    • Ett exempel på hur du använder dessa mappningar visas nedan:

      Exempel på skärmbild för plattformsgränssnitt som visar målmappningar.

    Arbeta med leads

    • Om du arbetar med Leads i ditt segment kan du definiera mappningar för fälten som ska uppdateras genom att läsa objektreferensen i Salesforce för Lead .

    • Du kan identifiera obligatoriska fält genom att söka efter ordet Obligatorisk, som anges i fältbeskrivningar i länken ovan.

    • Beroende på vilka fält du vill exportera eller uppdatera lägger du till mappningar mellan XDM-profilschemat och (API) Salesforce CRM:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Source Field Målfält Anteckningar
      IdentityMap: crmID Identity: SalesforceId Mandatory
      xdm: person.name.lastName Attribute: LastName Mandatory. Ledningens efternamn är högst 80 tecken.
      xdm: b2b.companyName Attribute: Company Mandatory. Ledarens företag.
      xdm: personalEmail.address Attribute: Email Leadens e-postadress.
    • Ett exempel på hur du använder dessa mappningar visas nedan:

      Exempel på skärmbild för plattformsgränssnitt som visar målmappningar.

När du har angett mappningarna för målanslutningen väljer du Next.

Schemalägg målgruppsexport och exempel schedule-segment-export-example

När du utför steget Schemalägg målgruppsexport måste du manuellt mappa målgrupper som har aktiverats från Platform till deras motsvarande anpassade fält i Salesforce.

Det gör du genom att markera varje segment och sedan ange det anpassade fältnamnet från Salesforce i fältet Salesforce CRM Mapping ID. Mer information om hur du skapar anpassade fält i Salesforce finns i avsnittet Skapa anpassade fält i Salesforce.

Om det anpassade fältet Salesforce till exempel är crm_2_seg anger du det här värdet i Salesforce CRM Mapping ID för att fylla målgrupper från Experience Platform i det här anpassade fältet.

Ett exempel på ett anpassat fält från Salesforce visas nedan:
Salesforce Skärmbild i användargränssnittet med anpassat fält.

Ett exempel som anger platsen för Salesforce CRM Mapping ID visas nedan:
Exempel på skärmbild i användargränssnittet för plattformen som visar export av schemalagda målgrupper.

Som visas ovan matchar Salesforce Field Name exakt det värde som anges i Salesforce CRM Mapping ID.

Beroende på ditt användningssätt kan alla aktiverade målgrupper mappas till samma anpassade Salesforce-fält eller till olika Field Name i Salesforce CRM. Ett typiskt exempel baserat på bilden ovan kan vara.

Salesforce CRM segmentnamn
Salesforce Field Name
Salesforce CRM Mapping ID
crm_1_seg
crm_1_seg
crm_1_seg
crm_2_seg
crm_2_seg
crm_2_seg

Upprepa det här avsnittet för varje aktiverat plattformssegment.

Validera dataexport exported-data

Följ stegen nedan för att verifiera att du har konfigurerat målet korrekt:

  1. Välj Destinations > Browse för att navigera till listan över mål.
    Skärmbild för plattformsgränssnitt med bläddringsmål.

  2. Markera målet och validera att statusen är enabled.
    Skärmbild för plattformsgränssnitt med körning av måldataflöde.

  3. Växla till fliken Activation data och välj sedan ett publiknamn.
    Exempel på skärmbild för användargränssnittet för plattformen som visar aktiveringsdata för destinationer.

  4. Övervaka målgruppssammanfattningen och se till att antalet profiler motsvarar antalet som skapas inom segmentet.
    Exempel på skärmbild för plattformsgränssnitt som visar segment.

  5. Logga sedan in på Salesforce-webbplatsen och validera om profilerna från målgruppen har lagts till eller uppdaterats.

    Arbeta med kontakter

    • Om du har valt Kontakter i ditt plattformssegment går du till sidan Apps > Contacts.

      Salesforce CRM-skärmbild som visar sidan Kontakter med profilerna från segmentet.

    • Välj en kontakt och kontrollera om fälten har uppdaterats. Du kan se att varje målgruppsstatus i Salesforce CRM har uppdaterats med motsvarande målgruppsstatus från Platform, baserat på värdet Mapping ID som angavs under målgruppsplaneringen.

      Salesforce CRM-skärmbild som visar sidan Kontaktinformation med uppdaterade målgruppsstatusar.

    Arbeta med leads

    • Om du har valt Leads i ditt plattformssegment går du till sidan Apps > Leads.

      Salesforce CRM-skärmbild som visar sidan Leads med profilerna från segmentet.

    • Välj en lead och kontrollera om fälten har uppdaterats. Du kan se att varje målgruppsstatus i Salesforce CRM har uppdaterats med motsvarande målgruppsstatus från Platform, baserat på värdet Mapping ID som angavs under målgruppsplaneringen.

      Salesforce CRM-skärmbild som visar sidan Leadinformation med uppdaterade målgruppsstatusar.

Dataanvändning och styrning data-usage-governance

Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Datastyrningsöversikten.

Fel och felsökning errors-and-troubleshooting

Okända fel påträffades när händelser skickades till målet unknown-errors

  • När du kontrollerar ett dataflöde kan följande felmeddelande visas: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
    Skärmbild för plattformsgränssnitt visar ett fel.

    • Om du vill åtgärda det här felet kontrollerar du att Mapping ID som du angav i aktiveringsarbetsflödet till Salesforce CRM-målet exakt matchar värdet för den anpassade fälttyp som du skapade i Salesforce. Mer information finns i avsnittet Skapa anpassade fält i Salesforce.
  • När du aktiverar ett segment kan du få ett felmeddelande: The client's IP address is unauthorized for this account. Allowlist the client's IP address...

Ytterligare resurser additional-resources

Ytterligare användbar information från Salesforce-utvecklarportalen finns nedan:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6