Salesforce CRM verbinding
Overzicht overview
Salesforce CRM is een populair CRM-platform (Customer Relationship Management) dat de hieronder beschreven typen profielen ondersteunt:
- Leads - Een voorbeeld is de naam van een persoon of bedrijf die (of niet) geïnteresseerd kan zijn in de producten of diensten die u verkoopt.
- Contactpersonen - Een contactpersoon is een persoon met wie een van uw vertegenwoordigers een relatie tot stand heeft gebracht en gekwalificeerd is als potentiële klant.
Dit Adobe Experience Platform doel gebruikt de Salesforce composite API, die beide hierboven beschreven typen profielen ondersteunt.
Wanneer activeren, segmenten, kunt u tussen leads of contactpersonen selecteren en kenmerken en doelgegevens bijwerken in Salesforce CRM.
Salesforce CRM gebruikt OAuth 2 met de Verlening van het Wachtwoord als authentificatiemechanisme om met Salesforce REST API te communiceren. Instructies voor verificatie aan uw Salesforce CRM de instantie is verder onderaan, in de Verifiëren voor bestemming sectie.
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 een schema, gegevensset, en segmenten gemaakt in Experience Platform.
Vereisten in Salesforce CRM prerequisites-destination
Houd rekening met de volgende voorwaarden in Salesforce CRMom gegevens van Platform naar uw Salesforce-account te exporteren:
U hebt een Salesforce account prerequisites-account
Ga naar de Salesforce proefversie pagina om te registreren en een Salesforce account, als u er nog geen hebt.
Een verbonden app configureren binnen Salesforce prerequisites-connected-app
Eerst moet u een Salesforce verbonden app binnen uw Salesforce account, als u er nog geen hebt. Salesforce CRM gebruikt de verbonden toepassing om verbinding te maken met Salesforce.
Vervolgens inschakelen OAuth Settings for API Integration voor de Salesforce connected app. Zie de Salesforce documentatie voor richtsnoeren.
Zorg er ook voor dat de bereik hieronder vermeld worden geselecteerd voor Salesforce connected app.
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. Zie de Salesforce OAuth 2.0 de gebruikersnaam-Wachtwoord Stroom voor Speciale Scenarios documentatie als u hulp nodig hebt.
Aangepaste velden maken binnen Salesforce prerequisites-custom-field
Wanneer het publiek wordt geactiveerd naar de Salesforce CRM doel, moet u een waarde in invoeren Mapping ID veld voor elk geactiveerd publiek, in de Publiek schema stap.
Salesforce CRM vereist deze waarde om het publiek dat vanuit het Experience Platform binnenkomt, correct te lezen en te interpreteren en zijn publieksstatus binnen bij te werken Salesforce. Raadpleeg de documentatie bij het Experience Platform voor Publiek Lidmaatschap Details schema groep als u hulp over publieksstatus nodig hebt.
Voor elk publiek dat u activeert van Platform tot Salesforce CRMmoet u een aangepast veld van het type maken Text Area (Long)
binnen Salesforce. U kunt de veldtekenlengte van een willekeurige grootte tussen 256 en 131.072 tekens definiëren volgens uw zakelijke vereisten. Zie de Salesforce Aangepaste veldtypen Documentatiepagina voor aanvullende informatie over aangepaste veldtypen. Zie ook de Salesforce documentatie aan aangepaste velden maken als u hulp nodig hebt bij het maken van velden.
(_)
als scheidingsteken.Within Salesforce u moet aangepaste velden maken met een Field Name die exact overeenkomt met de waarde die is opgegeven binnen Mapping ID 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 deze bestemming, voegt u crm_2_seg
als Mapping ID om het publiek te vullen van Experience Platform tot dit aangepaste veld.Een voorbeeld van het maken van aangepaste velden in Salesforce, Stap 1 - selecteer het gegevenstype, wordt hieronder weergegeven:
Een voorbeeld van het maken van aangepaste velden in Salesforce, Stap 2 - ga de details voor het douanegebied in, wordt hieronder weergegeven:
- Een onderscheid maken tussen aangepaste velden die worden gebruikt voor doelgroepen van het platform en andere aangepaste velden binnen Salesforce u kunt een herkenbaar voor- of achtervoegsel opnemen wanneer u het aangepaste veld maakt. In plaats van
test_segment
, gebruikAdobe_test_segment
oftest_segment_Adobe
- Als u al andere aangepaste velden hebt gemaakt in Salesforce, kunt u de zelfde naam gebruiken zoals het segment van het Platform, om het publiek in gemakkelijk te identificeren Salesforce.
- Objecten in Salesforce zijn beperkt tot 25 externe velden. Zie Kenmerken van aangepast veld.
- 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 een ouder publiek in het Experience Platform voordat u een nieuwe account maakt Mapping ID kan worden gebruikt.
Gather Salesforce CRM geloofsbrieven gather-credentials
Noteer de onderstaande items voordat u deze verifieert voor de Salesforce CRM bestemming:
Username
Password
Security Token
Zie de Salesforce documentatie aan uw beveiligingstoken opnieuw instellen om te leren hoe u het kunt regenereren via de Salesforce interface als u niet het Symbolische van de Veiligheid hebt.
Custom Domain
Zie de Salesforce documentatie om te leren hoe u deze waarde kunt verkrijgen via de opdracht Salesforce interface.
d5i000000isb4eak-dev-ed
.my.salesforce.com,u hebt
d5i000000isb4eak-dev-ed
als de waarde.Client ID
Consumer Key
.Zie de Salesforce documentatie om te leren hoe u deze waarde kunt verkrijgen via de opdracht Salesforce interface.
Client Secret
Consumer Secret
.Zie de Salesforce documentatie om te leren hoe u deze waarde kunt verkrijgen via de opdracht Salesforce interface.
Guardrails guardrails
Salesforce saldeert transactieladingen door verzoek, tarief en onderbrekingsgrenzen op te leggen. Zie de Limieten en toewijzingen voor API-aanvragen voor meer informatie.
Als uw Salesforce de accountbeheerder heeft IP-beperkingen afgedwongen, u moet deze toevoegen IP-adressen van Experience Platforms aan uw Salesforce de vertrouwde op IP van rekeningen waaiers. Zie de Salesforce Toegang tot vertrouwde IP-bereiken beperken voor een verbonden app documentatie als u extra begeleiding nodig hebt.
Ondersteunde identiteiten supported-identities
Salesforce CRM ondersteunt het bijwerken van de identiteiten die in de onderstaande tabel worden beschreven. Meer informatie over identiteiten.
SalesforceId
Type en frequentie exporteren export-type-frequency
Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.
- U exporteert alle leden van een segment samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam), op basis van uw veldtoewijzing.
- Elke publieksstatus in Salesforce CRM wordt bijgewerkt met de corresponderende publieksstatus van Platform, gebaseerd op de Mapping ID waarde die tijdens de publieksplanning stap.
- 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. Meer informatie over streaming doelen.
Verbinden met de bestemming connect
Als u verbinding wilt maken met dit doel, voert u de stappen uit die in het dialoogvenster zelfstudie over doelconfiguratie. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.
Within Destinations > Catalog zoeken naar Salesforce CRM. U kunt de locatie ook onder de CRM categorie.
Verifiëren voor bestemming authenticate
Als u zich wilt verifiëren bij de bestemming, vult u de vereiste velden hieronder in en selecteert u Connect to destination. Zie de Gather Salesforce CRM geloofsbrieven voor eventuele richtsnoeren.
| Credentials | Beschrijving | | — | — | | Username | Uw Salesforce gebruikersnaam account. | | Password | Een samengevoegde tekenreeks die bestaat uit uw Salesforce accountwachtwoord toegevoegd aan uw Salesforce Beveiligingstoken.
De samengevoegde waarde bestaat uit: {PASSWORD}{TOKEN}
.
Nota, gebruik geen steunen of ruimten.
Als u bijvoorbeeld Salesforce Wachtwoord is MyPa$$w0rd123
en Salesforce Beveiligingstoken is TOKEN12345....0000
, de samengevoegde waarde die u in het dialoogvenster Password field is MyPa$$w0rd123TOKEN12345....0000
. | | Custom Domain | Uw Salesforce domeinprefix.
Als uw domein bijvoorbeeld d5i000000isb4eak-dev-ed
.my.salesforce.com, moet u d5i000000isb4eak-dev-ed
als de waarde. | | Client ID | Uw Salesforce verbonden app Consumer Key
. | | Client Secret | Uw Salesforce verbonden app Consumer Secret
. |
Als de verstrekte gegevens geldig zijn, geeft de interface een Connected Als u een groene markering hebt, 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 wilt herkennen.
-
Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.
-
Salesforce ID Type:
- Selecteren Contact als de identiteiten die u wilt exporteren of bijwerken van type zijn Contact.
- Selecteren Lead als de identiteiten die u wilt exporteren of bijwerken van type zijn Lood.
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. Zie de handleiding voor meer informatie over waarschuwingen abonneren op bestemmingen die het alarm gebruiken UI.
Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next.
Soorten publiek naar dit doel activeren activate
- Als u gegevens wilt activeren, hebt u de opdracht View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.
- Om te exporteren identiteiten, hebt u de View Identity Graph toegangsbeheermachtiging.
Lezen Profielen en doelgroepen activeren voor het streamen van doelgroepen voor het exporteren van bestanden voor instructies voor het activeren van het publiek naar deze bestemming.
Afbeeldingsoverwegingen en voorbeeld mapping-considerations-example
Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de Salesforce CRM doel, moet u door de stap van de gebiedstoewijzing gaan. 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 zijn opgegeven in het dialoogvenster Target field zou precies moeten worden genoemd zoals die in de lijst van attributenafbeeldingen wordt beschreven aangezien deze attributen de verzoeklichaam zullen vormen.
Kenmerken die zijn opgegeven in het dialoogvenster Source field zich niet aan een dergelijke beperking houden. U kunt deze toewijzen op basis van uw behoefte, maar zorg ervoor dat de indeling van de invoergegevens geldig is volgens de Salesforce documentatie. Als de invoergegevens niet geldig zijn, roept de update Salesforce mislukt en uw contactpersonen/leads worden niet bijgewerkt.
Uw XDM-velden op de juiste wijze toewijzen aan de (API) Salesforce CRM doelvelden, voer de volgende stappen uit:
-
In de Mapping stap, selecteren Add new mapping, ziet u een nieuwe toewijzingsrij op het scherm.
-
In de Select source field venster, kiest u de Select attributes en selecteer het XDM-kenmerk of kies de Select identity namespace en selecteer een identiteit.
-
In de Select target field venster, kiest u de Select identity namespace en selecteer een identiteit of kies Select custom attributes categorie en selecteer een kenmerk of definieer een met de Attribute name naar behoefte. Zie de Salesforce CRM documentatie voor richtsnoeren over ondersteunde kenmerken.
- Herhaal deze stappen om de volgende toewijzingen tussen uw XDM-profielschema en (API) Salesforce CRM:
Werken met contactpersonen
-
Als u met werkt Contactpersonen binnen uw segment, verwijs naar de Verwijzing van Objecten in Salesforce voor Contact om toewijzingen te definiëren voor de velden die moeten worden bijgewerkt.
-
U kunt verplichte velden identificeren door te zoeken naar het woord Vereist, die wordt genoemd in de veldbeschrijvingen in de bovenstaande koppeling.
-
Afhankelijk van de velden die u wilt exporteren of bijwerken, voegt u toewijzingen toe tussen uw XDM-profielschema en (API) Salesforce CRM: |Bronveld|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:
Werken met leads
-
Als u met werkt Leads binnen uw segment, verwijs naar de Verwijzing van Objecten in Salesforce voor Lood om toewijzingen te definiëren voor de velden die moeten worden bijgewerkt.
-
U kunt verplichte velden identificeren door te zoeken naar het woord Vereist, die wordt genoemd in de veldbeschrijvingen in de bovenstaande koppeling.
-
Afhankelijk van de velden die u wilt exporteren of bijwerken, voegt u toewijzingen toe tussen uw XDM-profielschema en (API) Salesforce CRM: |Bronveld|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:
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
Bij het uitvoeren van de Het exporteren van publiek plannen stap u moet publiek dat van Platform aan hun overeenkomstige douanegebied wordt geactiveerd manueel in kaart brengen Salesforce.
Om dit te doen, selecteer elk segment, dan ga de naam van het douanegebied van in Salesforce in de Salesforce CRM Mapping ID veld. Zie de Aangepaste velden maken binnen Salesforce voor richtlijnen en tips en trucs voor het maken van aangepaste velden in Salesforce.
Als uw Salesforce aangepast veld is crm_2_seg
geeft u deze waarde op in het dialoogvenster Salesforce CRM Mapping ID om het publiek te vullen van Experience Platform tot dit aangepaste veld.
Een voorbeeldveld van Salesforce wordt hieronder weergegeven:
Een voorbeeld dat de plaats van wijst Salesforce CRM Mapping ID wordt hieronder weergegeven:
Zoals hierboven getoond Salesforce Field Name komt exact overeen met de waarde die is opgegeven binnen Salesforce CRM Mapping ID.
Afhankelijk van uw gebruiksscenario kunnen alle geactiveerde doelgroepen aan hetzelfde worden toegewezen Salesforce aangepast veld of een ander veld 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:
-
Selecteren Destinations > Browse om naar de lijst met bestemmingen te navigeren.
-
Selecteer het doel en controleer of de status enabled.
-
Schakel over naar de Activation data en selecteert u vervolgens de naam van een publiek.
-
Controleer het publieksoverzicht en zorg ervoor dat de telling van profielen aan de telling beantwoordt die binnen het segment wordt gecreeerd.
-
Tot slot meldt u zich aan bij de Salesforce-website en controleert u of de profielen van het publiek zijn toegevoegd of bijgewerkt.
Werken met contactpersonen
-
Als u Contactpersonen binnen uw segment van het Platform, navigeer aan Apps > Contacts pagina.
-
Selecteer een Contact en controleer of de velden zijn bijgewerkt. U kunt zien dat elke publieksstatus in Salesforce CRM werd bijgewerkt met de overeenkomstige publieksstatus van Platform, gebaseerd op Mapping ID waarde die tijdens de publieksplanning.
Werken met leads
-
Als u Leads binnen uw segment van het Platform, dan navigeer aan Apps > Leads pagina.
-
Selecteer een Lood en controleer of de velden zijn bijgewerkt. U kunt zien dat elke publieksstatus in Salesforce CRM werd bijgewerkt met de overeenkomstige publieksstatus van Platform, gebaseerd op Mapping ID waarde die tijdens de publieksplanning.
-
Gegevensgebruik en -beheer data-usage-governance
Alles Adobe Experience Platform de bestemmingen zijn volgzaam met het beleid van het gegevensgebruik wanneer het behandelen van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform handhaaft gegevensbeheer, zie Overzicht van gegevensbeheer.
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.
- Om deze fout te bevestigen, verifieer dat Mapping ID die u in de activeringsworkflow aan de Salesforce CRM doel komt exact overeen met de waarde van het aangepaste veldtype dat u hebt gemaakt in Salesforce. Zie de Aangepaste velden maken binnen Salesforce voor richtsnoeren.
-
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...
- Neem contact op met uw Salesforce accountbeheerder om toe te voegen IP-adressen van Experience Platforms aan uw Salesforce de vertrouwde op IP van rekeningen waaiers. Zie de Salesforce Toegang tot vertrouwde IP-bereiken beperken voor een verbonden app documentatie als u extra begeleiding nodig hebt.
Aanvullende bronnen additional-resources
Aanvullende nuttige informatie uit de Salesforce Developer Portal is lager dan:
- Snel starten
- Een record maken
- Aangepaste aanbevelingen publiek
- Samengestelde bronnen gebruiken
- Deze bestemming gebruikt de Meerdere records bijwerken API in plaats van de Eén record bijwerken API-aanroep.