DocumentatieExperience PlatformHandleiding voor bestemmingen

Salesforce CRM verbinding

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Gebruiker

Overzicht overview

Salesforce CRMis een populair platform van het Beheer van de Verhouding van de Klant (CRM) en steunt de types van hieronder beschreven profielen:

  • Leads- een lood is de naam van een persoon of een bedrijf die (of niet) in de producten of de diensten kan geinteresseerd zijn u verkoopt.
  • Contacten- een contact is een individu met wie één van uw vertegenwoordigers een verhouding heeft gevestigd en als potentiële klant gekwalificeerd.

Dit Adobe Experience Platform doelhefboomwerkingen Salesforce composite API, die beide hierboven beschreven soorten profielen steunt.

Wanneer het activeren van segmenten, kunt u tussen of lood of contacten en updatekenmerken en publieksgegevens in Salesforce CRM selecteren.

Salesforce CRM gebruikt OAuth 2 met de Verlening van het Wachtwoord als authentificatiemechanisme om met Salesforce REST API te communiceren. De instructies om aan uw Salesforce CRM instantie voor authentiek te verklaren zijn verder hieronder, in voor authentiek verklaren aan bestemmingssectie.

Gebruiksscenario’s use-cases

Als markeerteken kunt u uw gebruikers een persoonlijke ervaring bieden op basis van kenmerken uit hun Adobe Experience Platform-profielen. U kunt publiek van uw off-line gegevens bouwen en deze toehoorders naar Salesforce CRM verzenden, om het lidmaatschap van CRM bij te werken zodra het publiek en de profielen in Adobe Experience Platform worden bijgewerkt.

Vereisten prerequisites

Vereisten in Experience Platform prerequisites-in-experience-platform

Alvorens gegevens aan de bestemming van Salesforce CRM te activeren, moet u a schema, a dataset, en segmentenhebben die in Experience Platform worden gecreeerd.

Vereisten in Salesforce CRM prerequisites-destination

Houd rekening met de volgende voorwaarden in Salesforce CRM om gegevens van Platform naar uw Salesforce-account te exporteren:

U moet een Salesforce -account hebben prerequisites-account

Ga naar de Salesforce proefpagina om een Salesforce rekening te registreren en tot stand te brengen, als u niet reeds hebt.

Een verbonden app configureren binnen Salesforce prerequisites-connected-app

Eerst, moet u a Salesforce verbonden appbinnen uw Salesforce rekening vormen, als u niet reeds hebt. Salesforce CRM gebruikt de verbonden toepassing om verbinding te maken met Salesforce .

Schakel vervolgens OAuth Settings for API Integration in voor de Salesforce connected app . Raadpleeg de Salesforcedocumentatie voor hulp.

Ook, zorg ervoor dat het hieronder vermelde werkingsgebiedvoor Salesforce connected app wordt geselecteerd.

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

Tot slot moet u ervoor zorgen dat de password -subsidie is ingeschakeld binnen uw Salesforce -account. Verwijs naar Salesforce OAuth 2.0 de stroom van het gebruikerswachtwoord voor Speciale Scenario'sals u begeleiding nodig hebt.

IMPORTANT
Als uw Salesforce accountbeheerder toegang tot vertrouwde op IP waaiers heeft beperkt, moet u hen contacteren om Experience Platform IPgevoegd op lijst van gewenste personen te krijgen. Verwijs naar Salesforce Beperk Toegang tot Vertrouwde IP Waaier voor een Verbonden Appdocumentatie als u extra begeleiding nodig hebt.

Aangepaste velden maken binnen Salesforce prerequisites-custom-field

Wanneer het activeren van publiek aan de Salesforce CRM bestemming, moet u een waarde op het Mapping ID gebied voor elk geactiveerd publiek, in de planningsstap van het Publiek invoeren.

Salesforce CRM vereist deze waarde om het publiek dat vanuit het Experience Platform binnenkomt correct te lezen en te interpreteren en om de status van het publiek in Salesforce bij te werken. Verwijs naar de documentatie van het Experience Platform voor het schemagroep van de Details van het Lidmaatschap van het Publiekals u begeleiding op publiekstoestanden nodig hebt.

Voor elk publiek dat u activeert van Platform tot Salesforce CRM, moet u een aangepast veld maken van het type Text Area (Long) within Salesforce . U kunt de veldtekenlengte van een willekeurige grootte tussen 256 en 131.072 tekens definiëren volgens uw zakelijke vereisten. Zie de Salesforce de documentatiepagina van de Types van Gebied van de Douanevoor extra informatie over de types van douanegebied. Ook verwijs de Salesforce documentatie aan creeer douanegebiedenals u hulp op gebiedsverwezenlijking nodig hebt.

IMPORTANT
Plaats geen spatietekens in de veldnaam. Gebruik in plaats daarvan het onderstrepingsteken (_) als scheidingsteken.
Binnen Salesforce moet u aangepaste velden maken met een Field Name die exact overeenkomt met de waarde die binnen Mapping ID is opgegeven voor elk geactiveerd platformsegment. In de onderstaande schermafbeelding ziet u bijvoorbeeld een aangepast veld met de naam crm_2_seg . Wanneer u een publiek activeert naar dit doel, voegt u crm_2_seg toe als Mapping ID om het publiek vanuit het Experience Platform te vullen met dit aangepaste veld.

Een voorbeeld van de verwezenlijking van het douanegebied in Salesforce, Stap 1 - selecteer het gegevenstype, wordt hieronder getoond:
het schermschot van Salesforce UI die de verwezenlijking van het douanegebied, Stap 1 toont - selecteer het gegevenstype.

Een voorbeeld van de verwezenlijking van het douanegebied in Salesforce, Stap 2 - ga de details voor het douanegebied in, wordt hieronder getoond:
het schermschot van Salesforce UI die de verwezenlijking van het douanegebied, Stap 2 toont - ga de details voor het douanegebied in.

TIP
  • Als u onderscheid wilt maken tussen aangepaste velden die worden gebruikt voor het publiek Platform en andere aangepaste velden binnen Salesforce , kunt u bij het maken van het aangepaste veld een herkenbaar voorvoegsel of achtervoegsel toevoegen. Gebruik bijvoorbeeld Adobe_test_segment of test_segment_Adobe in plaats van test_segment .
  • Als u al andere aangepaste velden hebt gemaakt in Salesforce , kunt u dezelfde naam gebruiken als het platformsegment om het publiek gemakkelijk te identificeren in Salesforce .
NOTE
  • De voorwerpen in Salesforce zijn beperkt tot 25 Externe gebieden, zie {de Attributen van het Gebied van 0} Douane 🔗.
  • Deze beperking houdt in dat u op elk gewenst moment maximaal 25 Experience Platforms publieksleden actief kunt hebben.
  • Als u deze limiet binnen Salesforce hebt bereikt, moet u de aangepaste kenmerken uit Salesforce verwijderen die zijn gebruikt om de publieksstatus op te slaan tegen oudere doelgroepen in het Experience Platform voordat een nieuwe Mapping ID kan worden gebruikt.

Salesforce CRM gebruikersgegevens verzamelen gather-credentials

Noteer de onderstaande items voordat u de verificatie uitvoert naar het doel van Salesforce CRM :

Credentials
Beschrijving
Voorbeeld
Username
Uw Salesforce gebruikersnaam van de account.
Password
Wachtwoord voor uw Salesforce account.
Security Token
Uw Salesforce veiligheidstoken dat u later aan het eind van uw Salesforce Wachtwoord zult toevoegen om een samengevoegde koord tot stand te brengen dat als Password moet worden gebruikt wanneer het voor authentiek verklaren aan de bestemming.
Verwijs naar de Salesforce documentatie om uw veiligheidstokenterug te stellen leren hoe te om het van de Salesforce interface opnieuw te produceren als u niet het Symbolische van de Veiligheid hebt.
Custom Domain
Het domeinvoorvoegsel Salesforce .
Zie de Salesforce documentatieleren hoe te om deze waarde uit de Salesforce interface te verkrijgen.
Als uw Salesforce domein
is d5i000000isb4eak-dev-ed.my.salesforce.com,
u d5i000000isb4eak-dev-ed als waarde zult nodig hebben.
Client ID
Uw Salesforce Consumer Key .
verwijs naar de Salesforce documentatieom te leren hoe te om deze waarde uit de Salesforce interface te verkrijgen.
Client Secret
Uw Salesforce Consumer Secret .
verwijs naar de Salesforce documentatieom te leren hoe te om deze waarde uit de Salesforce interface te verkrijgen.

Guardrails guardrails

In Salesforce worden transactieladingen in evenwicht gebracht door verzoek-, tarief- en time-outlimieten op te leggen. Verwijs naar de Limieten en Toewijzingen van het API- Verzoekvoor details.

Als uw Salesforce rekeningsbeheerder IP beperkingen heeft afgedwongen, zult u Experience Platform IP adressenaan uw Salesforce vertrouwde op IP waaiers van rekeningen moeten toevoegen. Verwijs naar Salesforce Beperk Toegang tot Vertrouwde IP Waaier voor een Verbonden Appdocumentatie als u extra begeleiding nodig hebt.

IMPORTANT
Wanneer het activeren van segmentenu tussen of contact of ** types van Lood moet selecteren. U moet ervoor zorgen dat uw publiek de juiste gegevenstoewijzing heeft op basis van het geselecteerde type.

Ondersteunde identiteiten supported-identities

Salesforce CRM ondersteunt het bijwerken van de identiteiten die in de onderstaande tabel worden beschreven. Leer meer over identiteiten.

Doelidentiteit
Beschrijving
Overwegingen
SalesforceId
De Salesforce CRM-id voor de contactpersoon of lead-id's die u exporteert of bijwerkt via uw segment.
Verplicht

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
  • U exporteert alle leden van een segment samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam) volgens uw veldtoewijzing.
  • Elke publieksstatus in Salesforce CRM wordt bijgewerkt met de overeenkomstige publieksstatus van Platform, die op de Mapping ID waarde wordt gebaseerd die tijdens de publiek wordt verstrekt diestap plant.
Exportfrequentie
Streaming
  • Streaming doelen zijn "altijd aan" API-verbindingen. Zodra een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over het stromen bestemmingen.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het leerprogramma van de bestemmingsconfiguratieworden beschreven. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Kies in Destinations > Catalog Zoeken naar Salesforce CRM . U kunt de locatie ook in de categorie CRM vinden.

Verifiëren voor bestemming authenticate

Als u voor verificatie bij het doel wilt zorgen, vult u de vereiste velden hieronder in en selecteert u Connect to destination . Verwijs naar de Gather Salesforce CRM geloofsbrievensectie voor om het even welke begeleiding.

Credentials
Beschrijving
Username
Uw Salesforce gebruikersnaam van de account.
Password
Een samengevoegde tekenreeks die bestaat uit het wachtwoord voor uw Salesforce -account dat is toegevoegd met uw Salesforce beveiligingstoken.
de samengevoegde waarde neemt de vorm van {PASSWORD}{TOKEN}.
Opmerking: gebruik geen accolades of spaties.
Bijvoorbeeld als uw Salesforce Wachtwoord MyPa$$w0rd123 is en Salesforce Beveiligingstoken TOKEN12345....0000 is, is de samengevoegde waarde die u in het Password veld zult gebruiken MyPa$$w0rd123TOKEN12345....0000 .
Custom Domain
Het domeinvoorvoegsel Salesforce .
Bijvoorbeeld als uw domein d5i000000isb4eak-dev-ed.my.salesforce.com is, moet u d5i000000isb4eak-dev-ed als waarde verstrekken.
Client ID
De Salesforce verbonden app Consumer Key .
Client Secret
De Salesforce verbonden app Consumer Secret .

{het schermschot van het platform UI die tonen hoe te voor authentiek te verklaren.

Als de opgegeven gegevens geldig zijn, geeft de gebruikersinterface een Connected -status weer met een groen vinkje. Vervolgens kunt u verdergaan met de volgende stap.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.

  • Name: Een naam waarmee u dit doel in de toekomst herkent.

  • Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.

  • Salesforce ID Type:

    • Selecteer Contact als de identiteiten u wilt uitvoeren of bijwerken van type Contact zijn.
    • Selecteer Lead als de identiteiten u wilt uitvoeren of bijwerken van type Lood zijn.

{het schermschot van het platform UI die de bestemmingsdetails toont.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij het intekenen aan bestemmingsalarm gebruikend UI.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren activate

IMPORTANT

Lees activeer profielen en publiek aan het stromen publiek uitvoerbestemmingenvoor instructies bij het activeren van publiek aan deze bestemming.

Afbeeldingsoverwegingen en voorbeeld mapping-considerations-example

Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de Salesforce CRM -bestemming wilt verzenden, moet u de stap voor veldtoewijzing doorlopen. Toewijzing bestaat uit het maken van een koppeling tussen de schemavelden van uw Experience Data Model (XDM) in uw Platform-account en de bijbehorende equivalenten van de doelbestemming.

Kenmerken die in de Target field worden opgegeven, moeten een naam krijgen die exact overeenkomt met de beschrijving in de tabel met kenmerktoewijzingen, aangezien deze kenmerken de aanvraaginstantie vormen.

Kenmerken die in Source field worden opgegeven, volgen een dergelijke beperking niet. U kunt het in kaart brengen gebaseerd op uw behoefte, echter verzekeren het formaat van de inputgegevens geldig volgens de Salesforce documentatieis. Als de invoergegevens niet geldig zijn, mislukt de updateaanroep naar Salesforce en worden uw contactpersonen/leads niet bijgewerkt.

Voer de volgende stappen uit om uw XDM-velden correct toe te wijzen aan de (API) Salesforce CRM -doelvelden:

  1. In de stap Mapping selecteert u Add new mapping en ziet u een nieuwe toewijzingsrij op het scherm.
    {het screenshot voorbeeld van het platform UI voor Add nieuwe afbeelding.

  2. Kies in het venster Select source field de categorie Select attributes en selecteer het XDM-kenmerk of kies de categorie Select identity namespace en selecteer een identiteit.

  3. Kies in het venster Select target field de categorie Select identity namespace en selecteer een identiteit of kies Select custom attributes en selecteer een kenmerk of definieer een kenmerk met behulp van het veld Attribute name . Verwijs naar de Salesforce CRM documentatievoor begeleiding op gesteunde attributen.

    • Herhaal deze stappen om de volgende toewijzingen tussen uw XDM-profielschema en (API) Salesforce CRM toe te voegen:

    Werkend met Contacten

    • Als u met Contacten binnen uw segment werkt, verwijs naar de Verwijzing van Objecten in Salesforce voor Contactom afbeeldingen voor de gebieden te bepalen die moeten worden bijgewerkt.

    • U kunt verplichte gebieden identificeren door naar het woord Vereiste te zoeken, dat in gebiedsbeschrijvingen in de verbinding hierboven wordt vermeld.

    • Afhankelijk van de velden die u wilt exporteren of bijwerken, voegt u toewijzingen toe tussen het XDM-profielschema en (API) Salesforce CRM :

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Source-veld Doelveld Notities
      IdentityMap: crmID Identity: SalesforceId Mandatory
      xdm: person.name.lastName Attribute: LastName Mandatory. Achternaam van de contactpersoon mag maximaal 80 tekens bevatten.
      xdm: person.name.firstName Attribute: FirstName De voornaam van de contactpersoon mag maximaal 40 tekens bevatten.
      xdm: personalEmail.address Attribute: Email Het e-mailadres van de contactpersoon

    • Hieronder ziet u een voorbeeld waarin deze toewijzingen worden gebruikt:

      het schermschot van het Platform UI die de afbeeldingen van het Doel tonen.

    Werkend met Leads

    • Als u met Leads binnen uw segment werkt, verwijs naar de Verwijzing van Objecten in Salesforce voor Loodom afbeeldingen voor de gebieden te bepalen die moeten worden bijgewerkt.

    • U kunt verplichte gebieden identificeren door naar het woord Vereiste te zoeken, dat in gebiedsbeschrijvingen in de verbinding hierboven wordt vermeld.

    • Afhankelijk van de velden die u wilt exporteren of bijwerken, voegt u toewijzingen toe tussen het XDM-profielschema en (API) Salesforce CRM :

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Source-veld Doelveld Notities
      IdentityMap: crmID Identity: SalesforceId Mandatory
      xdm: person.name.lastName Attribute: LastName Mandatory. Achternaam van de lead mag maximaal 80 tekens bevatten.
      xdm: b2b.companyName Attribute: Company Mandatory. Het bedrijf van de leider.
      xdm: personalEmail.address Attribute: Email Het e-mailadres van de lead.

    • Hieronder ziet u een voorbeeld waarin deze toewijzingen worden gebruikt:

      het schermschot van het Platform UI die de afbeeldingen van het Doel tonen.

Wanneer u klaar bent met het opgeven van de toewijzingen voor uw doelverbinding, selecteert u Next .

Het publiek van het programma uitvoeren en voorbeeld schedule-segment-export-example

Wanneer het uitvoeren van de stap van de de publieksuitvoer van het Programmau moet publiek manueel in kaart brengen dat van Platform aan hun overeenkomstig douanegebied in Salesforce wordt geactiveerd.

Hiervoor selecteert u elk segment en voert u de aangepaste veldnaam in uit Salesforce in het veld Salesforce CRM Mapping ID . Verwijs naar creeer douanegebieden binnen Salesforce sectie voor begeleiding en beste praktijken bij het creëren van douanegebieden in Salesforce.

Als het aangepaste veld Salesforce bijvoorbeeld crm_2_seg is, geeft u deze waarde op in het veld Salesforce CRM Mapping ID om het publiek vanuit het Experience Platform te vullen met dit aangepaste veld.

Hieronder ziet u een voorbeeld van een aangepast veld uit Salesforce :
Salesforce UI-schermafbeelding met aangepast veld.

Hieronder ziet u een voorbeeld van de locatie van Salesforce CRM Mapping ID :
het screenshot voorbeeld van het Platform UI die het publiek van het Programma tonen uitvoer.

Zoals hierboven wordt weergegeven, komt Salesforce Field Name exact overeen met de waarde die is opgegeven binnen Salesforce CRM Mapping ID .

Afhankelijk van het gebruik dat u maakt, kunnen alle geactiveerde soorten publiek worden toegewezen aan hetzelfde Salesforce aangepaste veld of aan een ander Field Name in Salesforce CRM . Een typisch voorbeeld op basis van de bovenstaande afbeelding zou kunnen zijn.

Salesforce CRM segmentnaam
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

Herhaal deze sectie voor elk geactiveerd platformsegment.

Gegevens exporteren valideren exported-data

Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:

  1. Selecteer Destinations > Browse om naar de lijst met doelen te navigeren.
    het schermschot van het Platform UI die door Doelen toont.

  2. Selecteer het doel en bevestig dat de status enabled is.
    het schermschot van het Platform UI die de Looppas van Doelen Dataflow toont.

  3. Ga naar het tabblad Activation data en selecteer vervolgens een publieksnaam.
    het schermschot van het Platform UI die de Gegevens van de Activering van Doelen toont.

  4. Controleer het publieksoverzicht en zorg ervoor dat de telling van profielen aan de telling beantwoordt die binnen het segment wordt gecreeerd.
    het schermschot van het Platform UI die Segment toont.

  5. Tot slot meldt u zich aan bij de Salesforce-website en controleert u of de profielen van het publiek zijn toegevoegd of bijgewerkt.

    Werkend met Contacten

    • Als u Contacten binnen uw segment van het Platform hebt geselecteerd, navigeer aan Apps > Contacts pagina.

      het schermschot van CRM van Salesforce die de pagina van Contacten met de profielen van het segment tonen.

    • Selecteer a Contact en controleer als de gebieden worden bijgewerkt. U kunt zien dat elke publieksstatus in Salesforce CRM met de overeenkomstige publieksstatus van Platform werd bijgewerkt, dat op de Mapping ID waarde wordt gebaseerd die tijdens het publiek wordt verstrekt dieplant.

      het schermschot van CRM van Salesforce die de pagina van de Details van het Contact met bijgewerkte publieksstatussen tonen.

    Werkend met Leads

    • Als u Leads binnen uw segment van het Platform hebt geselecteerd, dan navigeer aan Apps > Leads pagina.

      het schermschot van CRM van Salesforce die de pagina van Leads met de profielen van het segment tonen.

    • Selecteer a Lood en controleer als de gebieden worden bijgewerkt. U kunt zien dat elke publieksstatus in Salesforce CRM met de overeenkomstige publieksstatus van Platform werd bijgewerkt, dat op de Mapping ID waarde wordt gebaseerd die tijdens het publiek wordt verstrekt dieplant.

      het schermschot van CRM van Salesforce die de pagina van Details van het Lood met bijgewerkte publieksstatussen toont.

Gegevensgebruik en -beheer data-usage-governance

Alle Adobe Experience Platform -doelen zijn compatibel met het beleid voor gegevensgebruik bij het verwerken van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform gegevensbeheer afdwingt, zie het overzicht van het Beleid van Gegevens.

Fouten en problemen oplossen errors-and-troubleshooting

Onbekende fouten aangetroffen tijdens het naar de bestemming duwen van gebeurtenissen unknown-errors

  • Bij het controleren van een gegevensstroomuitvoering kan het volgende foutbericht optreden: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
    {het schermschot van het platform UI die fout toont.

    • Om deze fout te corrigeren, controleert u of de Mapping ID die u in de activeringsworkflow hebt opgegeven voor het Salesforce CRM -doel exact overeenkomt met de waarde van het aangepaste veldtype dat u in Salesforce hebt gemaakt. Verwijs naar creeer douanegebieden binnen Salesforce sectie voor begeleiding.

  • Wanneer u een segment activeert, wordt mogelijk een foutbericht weergegeven: The client's IP address is unauthorized for this account. Allowlist the client's IP address...

Aanvullende bronnen additional-resources

De extra nuttige informatie van het de ontwikkelaarsportaal van Salesforceis hieronder:

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