Salesforce CRM anslutning

Översikt overview

Salesforce CRM är en populär CRM-plattform (Customer Relationship Management) som stöder de profiltyper 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.

Detta Adobe Experience Platform mål utnyttjar Salesforce composite API, som har stöd för båda profiltyperna som beskrivs ovan.

När aktivera segmentkan du välja mellan antingen 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 hur du autentiserar Salesforce CRM -instansen är längre ned, i Autentisera till mål -avsnitt.

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örutsättningar prerequisites

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

Innan du aktiverar data till Salesforce CRM-målet måste du ha en schema, a datauppsättningoch segment som Experience Platform.

Krav Salesforce CRM prerequisites-destination

Observera följande krav i Salesforce CRMför att exportera data från Platform till ditt Salesforce-konto:

Du måste ha en Salesforce konto prerequisites-account

Gå till Salesforce testversion för att registrera och skapa en Salesforce om du inte redan har ett konto.

Konfigurera en ansluten app i Salesforce prerequisites-connected-app

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

Nästa, aktivera OAuth Settings for API Integration för Salesforce connected app. Se Salesforce dokumentation för vägledning.

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

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

Slutligen måste du se till att password anslaget är aktiverat i Salesforce konto. Se Salesforce OAuth 2.0-användarnamn-lösenord för specialscenarier dokumentation om du behöver hjälp.

IMPORTANT
Om Salesforce kontoadministratören har begränsat åtkomsten till betrodda IP-intervall, du måste kontakta dem för att få IP-adresser för Experience Platform tillåtslista. Se Salesforce Begränsa åtkomst till betrodda IP-intervall för ett anslutet program dokumentation om du behöver ytterligare vägledning.

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

När målgrupper aktiveras för Salesforce CRM mål måste du ange ett värde i Mapping ID för varje aktiverad målgrupp, i Målgruppsschema steg.

Salesforce CRM kräver att det här värdet läser och tolkar målgrupper som kommer från Experience Platform korrekt och uppdaterar deras målgruppsstatus inom Salesforce. Se dokumentationen för Experience Platform för Schemafältgrupp för målgruppsmedlemskapsdetaljer om ni behöver vägledning om målgruppsstatus.

För varje målgrupp som du aktiverar från Platform till Salesforce CRMmåste du skapa ett anpassat fält av typen Text Area (Long) inom Salesforce. Du kan definiera längden på fälttecknen i valfri storlek mellan 256 och 131 072 tecken beroende på ditt företags behov. Se Salesforce Anpassade fälttyper dokumentationssida för mer information om anpassade fälttyper. Se även Salesforce dokumentation till 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 (_) tecken som avgränsare.
Inom Salesforce du måste skapa anpassade fält med en Field Name som exakt matchar värdet som anges i Mapping ID för varje aktiverat plattformssegment. På skärmbilden nedan visas ett anpassat fält med namnet crm_2_seg. Lägg till crm_2_seg as Mapping ID för att fylla målgrupper från Experience Platform i detta anpassade fält.

Ett exempel på hur du skapar anpassade fält i Salesforce, Steg 1 - Välj datatyp, visas nedan:
Skärmbild för användargränssnittet i Salesforce 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 det anpassade fältet, visas nedan:
Skärmbild för användargränssnittet i Salesforce som visar hur du skapar anpassade fält, steg 2 - Ange information för anpassade fält.

TIP
  • Att skilja mellan anpassade fält som används för plattformsanvändare och andra anpassade fält inom Salesforce du kan inkludera ett identifierbart prefix eller suffix när du skapar det anpassade fältet. I stället för test_segment, använda Adobe_test_segment eller test_segment_Adobe
  • Om du redan har andra anpassade fält skapade i Salesforcekan 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 före en ny Mapping ID kan användas.

Samla Salesforce CRM autentiseringsuppgifter gather-credentials

Anteckna nedanstående innan du autentiserar dig för Salesforce CRM mål:

Autentiseringsuppgifter
Beskrivning
Exempel
Username
Dina Salesforce användarnamn för konto.
Password
Dina Salesforce kontolösenord.
Security Token
Dina Salesforce säkerhetstoken som du senare lägger till i slutet av din Salesforce Lösenord för att skapa en sammanfogad sträng som ska användas som Password när autentiserar mot målet.
Se Salesforce dokumentation till återställa din säkerhetstoken om du vill lära dig hur du genererar om det från Salesforce om du inte har säkerhetstoken.
Custom Domain
Dina Salesforce domänprefix.
Se Salesforce dokumentation om du vill veta hur du får fram det här värdet från Salesforce gränssnitt.
Om Salesforce domänen är
d5i000000isb4eak-dev-ed.my.salesforce.com,
du behöver d5i000000isb4eak-dev-ed som värdet.
Client ID
Din Salesforce Consumer Key.
Se Salesforce dokumentation om du vill veta hur du får fram det här värdet från Salesforce gränssnitt.
Client Secret
Din Salesforce Consumer Secret.
Se Salesforce dokumentation om du vill veta hur du får fram det här värdet från Salesforce gränssnitt.

Guardrails guardrails

Salesforce balanserar transaktionsbelastningen genom att införa gräns för antal och tidsgräns för begäranden. Se API-begärandegränser och allokeringar för mer information.

Om Salesforce kontoadministratören har infört IP-begränsningar, du måste lägga till Experience Platform IP-adresser till Salesforce kontots betrodda IP-intervall. Se Salesforce Begränsa åtkomst till betrodda IP-intervall för ett anslutet program dokumentation om du behöver ytterligare vägledning.

IMPORTANT
När aktivera segment du måste välja mellan Kontakt eller Lead typer. 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
The Salesforce CRM identifierare 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 (t.ex. e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • Varje målgruppsstatus i Salesforce CRM uppdateras med motsvarande målgruppsstatus från Platform, baserat på Mapping ID det värde som anges under målgruppsplanering steg.
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 mål för direktuppspelning.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du View Destinations och Manage Destinations behörigheter för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

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

Inom Destinations > Catalog sök efter Salesforce CRM. Du kan även hitta den under CRM kategori.

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. Se Samla Salesforce CRM autentiseringsuppgifter för vägledning.
| Autentiseringsuppgifter | Beskrivning | | — | — | | Username | Dina Salesforce användarnamn för konto. | | Password | En sammanfogad sträng som består av Salesforce kontolösenordet har bifogats med Salesforce Säkerhetstoken.
Det sammanfogade värdet har formen av {PASSWORD}{TOKEN}.
Observera att du inte ska använda klammerparenteser eller mellanslag.
Om du till exempel Salesforce Lösenordet är MyPa$$w0rd123 och Salesforce Säkerhetstoken är TOKEN12345....0000, det sammanfogade värde som du kommer att använda i Password fältet är MyPa$$w0rd123TOKEN12345....0000. | | Custom Domain | Dina Salesforce domänprefix.
Om din domän till exempel är d5i000000isb4eak-dev-ed.my.salesforce.com måste du ange d5i000000isb4eak-dev-ed som värdet. | | Client ID | Dina Salesforce ansluten app Consumer Key. | | Client Secret | Dina Salesforce ansluten app Consumer Secret. |

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

Om den angivna informationen är giltig visas en Connected status med en grön bockmarkering kan du 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 användargränssnittet för plattformen 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 på prenumerera på destinationsvarningar med användargränssnittet.

När du är klar med informationen för målanslutningen väljer du Next.

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

IMPORTANT

Läs Aktivera profiler och målgrupper för att strömma målgruppernas exportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

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

Så här skickar du målgruppsdata från Adobe Experience Platform till Salesforce CRM mål 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 inte följer någon sådan begränsning. Du kan mappa den baserat på dina behov, men se till att indata-formatet är giltigt enligt Salesforce dokumentation. Om indata inte är giltiga anropas uppdateringsanropet till Salesforce kommer att misslyckas och dina kontakter/leads uppdateras inte.

Mappa XDM-fälten korrekt till (API) Salesforce CRM målfält, följ dessa steg:

  1. I Mapping steg, välja Add new mapping ​visas en ny mappningsrad på skärmen.
    Exempel på skärmbild för användargränssnittet för plattformen för att lägga till ny mappning.

  2. I Select source field väljer du Select attributes och välj XDM-attributet eller välj Select identity namespace och välj en identitet.

  3. I Select target field väljer du Select identity namespace och välj en identitet eller välj Select custom attributes och välj ett attribut eller definiera ett med Attribute name fält efter behov. Se Salesforce CRM dokumentation för vägledning om attribut som stöds.

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

    Arbeta med kontakter

    • Om du arbetar med Kontakter inom ditt segment, se objektreferensen i Salesforce för Kontakt för att definiera mappningar för de fält som ska uppdateras.

    • Du kan identifiera obligatoriska fält genom att söka efter ordet Obligatoriskt, som nämns 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: |Källfält|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 användargränssnittet för plattformen som visar målmappningar.

    Arbeta med leads

    • Om du arbetar med Leads inom ditt segment, se objektreferensen i Salesforce för Lead för att definiera mappningar för de fält som ska uppdateras.

    • Du kan identifiera obligatoriska fält genom att söka efter ordet Obligatoriskt, som nämns 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: |Källfält|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 användargränssnittet för plattformen 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 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 Salesforce CRM Mapping ID fält. Se Skapa anpassade fält i Salesforce för vägledning och bästa metoder för att skapa anpassade fält i Salesforce.

Om Salesforce anpassat fält är crm_2_seganger du det här värdet i dialogrutan Salesforce CRM Mapping ID för att fylla målgrupper från Experience Platform i detta anpassade fält.

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 för användargränssnittet för plattformen som visar export av schemalagda målgrupper.

Som visas ovan Salesforce Field Name matchar 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 Salesforce anpassat fält eller till annat Field Name in 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 destinationer.
    Skärmbild av användargränssnittet för plattformen med bläddringsmål.

  2. Markera målet och validera att statusen är enabled.
    Skärmbild av användargränssnittet för plattformen med körning av måldataflöde.

  3. Växla till Activation data väljer du ett målgruppsnamn.
    Skärmbild för användargränssnittet för plattformen 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 navigerar du till Apps > Contacts sida.

      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 uppdaterades med motsvarande målgruppsstatus från Platform, baserat på Mapping ID det värde som anges under målgruppsplanering.

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

    Arbeta med leads

    • Om du har valt Leads i ditt plattformssegment, navigera sedan till Apps > Leads sida.

      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 uppdaterades med motsvarande målgruppsstatus från Platform, baserat på Mapping ID det värde som anges under målgruppsplanering.

      Salesforce CRM, bild som visar sidan Leadinformation med uppdaterade målgruppsstatusar.

Dataanvändning och styrning data-usage-governance

Alla Adobe Experience Platform destinationerna är kompatibla med dataanvändningsprinciper när data hanteras. Detaljerad information om hur Adobe Experience Platform använder datastyrning, se Datastyrning - översikt.

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 användargränssnittet för plattformen visar ett fel.

    • Du kan åtgärda felet genom att kontrollera att Mapping ID som du angav i aktiveringsarbetsflödet för Salesforce CRM målet matchar exakt värdet för den anpassade fälttyp som du skapade i Salesforce. Se Skapa anpassade fält i Salesforce för vägledning.
  • 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-utvecklarportal är under:

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