(API) Salesforce Marketing Cloud verbinding
Overzicht overview
(API) Salesforce Marketing Cloud (voorheen bekend als ExactTarget) is een digitale marketingsuite waarmee u reizen kunt maken en aanpassen voor bezoekers en klanten om hun ervaring aan te passen.
Vergeleken met Salesforce Marketing Cloud Account Engagement dat meer gericht is op B2B de (API) Salesforce Marketing Cloud doel is ideaal voor B2C gebruik van gevallen met kortere transactionele besluitvormingscycli. U kunt grotere datasets consolideren die het gedrag van uw doelpubliek vertegenwoordigen om marketing campagnes aan te passen en te verbeteren door contacten, vooral van datasets buiten voorrang te geven en te segmenteren Salesforce. Opmerking: Experience Platform heeft ook een verbinding voor de Salesforce Marketing Cloud Account Engagement.
Dit Adobe Experience Platform doel gebruikt de Salesforce Marketing Cloud update contacten API, waarmee u contactpersonen toevoegen en contactgegevens bijwerken voor uw bedrijfsbehoeften na het activeren van hen binnen een nieuw Salesforce Marketing Cloud segment.
Salesforce Marketing Cloud gebruikt OAuth 2 met de Referenties van de Cliënt als authentificatiemechanisme om met te communiceren Salesforce Marketing Cloud API. Instructies voor verificatie aan uw Salesforce Marketing Cloud de instantie is verder onderaan, in de Verifiëren voor bestemming sectie.
Gebruiksscenario’s use-cases
Om u te helpen beter begrijpen hoe en wanneer u het (API) Salesforce Marketing Cloud doel, hier is een geval van steekproefgebruik dat de klanten van Adobe Experience Platform kunnen oplossen door deze bestemming te gebruiken.
E-mails verzenden naar contactpersonen voor marketingcampagnes use-case-send-emails
De verkoopafdeling van een platform van de huishuur wil een marketing e-mail aan een gericht klantenpubliek uitzenden. Het marketing team van het platform kan nieuwe contacten toevoegen/bestaande contacten bijwerken (en hun e-mailadres) door Adobe Experience Platform, bouwt publiek van hun eigen off-line gegevens en verzendt deze publiek naar Salesforce Marketing Cloud, die vervolgens kan worden gebruikt om de marketingcampagne per e-mail te verzenden.
Vereisten prerequisites
Vereisten in Experience Platform prerequisites-in-experience-platform
Voordat u gegevens activeert naar de (API) Salesforce Marketing Cloud doel, u moet een schema, gegevensset, en segmenten gemaakt in Experience Platform.
Vereisten in (API) Salesforce Marketing Cloud prerequisites-destination
Houd rekening met de volgende voorwaarden om gegevens van Platform naar uw Salesforce Marketing Cloud account:
U hebt een Salesforce Marketing Cloud account prerequisites-account
A Salesforce Marketing Cloud account met een abonnement op de Marketing Cloud Engagement Het product is verplicht verder te gaan.
Uitstrekken tot Salesforce Ondersteuning als u geen Salesforce Marketing Cloud -account of uw account ontbreekt het Marketing Cloud Engagement productabonnement.
Kenmerken maken binnen Salesforce Marketing Cloud prerequisites-attribute
Wanneer het publiek wordt geactiveerd naar de (API) Salesforce Marketing Cloud doel, moet u een waarde in invoeren Mapping ID veld voor elk geactiveerd publiek, in de Publiek schema stap.
Salesforce 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 Marketing Cloud. 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, moet u een kenmerk van het type hebben Text
gekoppeld aan de Email Demographics gegevensextensie binnen Salesforce Marketing Cloud. Gebruik de Salesforce Marketing Cloud Contact Builder om kenmerken te maken. Zie de Salesforce Marketing Cloud documentatie aan kenmerken maken als u richtlijnen nodig hebt voor het maken van kenmerken.
De namen van kenmerkvelden worden gebruikt voor de (API) Salesforce Marketing Cloud doelveld tijdens het Mapping stap. U kunt het veldteken definiëren met maximaal 4000 tekens, afhankelijk van uw zakelijke vereisten. Zie de Salesforce Marketing Cloud Gegevenstypen gegevensextensies Documentatiepagina voor aanvullende informatie over kenmerktypen.
Een voorbeeld van het scherm van de gegevensontwerper in Salesforce Marketing Cloud, waarin u het kenmerk wilt toevoegen, wordt hieronder weergegeven:
Een weergave van een Salesforce Marketing Cloud Email Data kenmerkgroep met kenmerken die overeenkomen met de publieksstatus in het dialoogvenster Email Demographics de gegevensextensie wordt hieronder weergegeven :
De (API) Salesforce Marketing Cloud doel gebruikt Salesforce Marketing Cloud Search Attribute-Set Definitions REST API om de gegevensextensies en de bijbehorende gekoppelde kenmerken dynamisch op te halen, zoals gedefinieerd in Salesforce Marketing Cloud.
Deze worden weergegeven in het dialoogvenster Target field selectievenster wanneer u de toewijzing in de workflow naar publiek naar doel activeren.
salesforce_mc_segment_1
. Wanneer u een publiek activeert naar deze bestemming, voegt u salesforce_mc_segment_1
als Mapping ID om het publiek te vullen van Experience Platform in dit kenmerk.Een voorbeeld van het maken van kenmerken in Salesforce Marketing Cloud, wordt hieronder weergegeven:
- Neem bij het maken van het kenmerk geen spatietekens op in de veldnaam. Gebruik in plaats daarvan het onderstrepingsteken
(_)
als scheidingsteken. - Een onderscheid maken tussen kenmerken die worden gebruikt voor het publiek van het platform en andere kenmerken binnen Salesforce Marketing Cloudkunt u een herkenbaar voor- of achtervoegsel opnemen voor de kenmerken die worden gebruikt voor Adobe-segmenten. In plaats van
test_segment
, gebruikAdobe_test_segment
oftest_segment_Adobe
. - Als u al andere kenmerken hebt gemaakt in Salesforce Marketing Cloud, kunt u de zelfde naam gebruiken zoals het segment van het Platform, om het publiek in gemakkelijk te identificeren Salesforce Marketing Cloud.
Gebruikersrollen en machtigingen toewijzen binnen Salesforce Marketing Cloud prerequisites-roles-permissions
Als Salesforce Marketing Cloud steunt douanerollen afhankelijk van uw gebruik-geval, zou uw gebruiker de relevante rollen moeten worden toegewezen om uw attributen binnen bij te werken Salesforce Marketing Cloud. Hieronder ziet u een voorbeeld van rollen die aan een gebruiker zijn toegewezen:
Afhankelijk van welke rollen uw Salesforce Marketing Cloud gebruiker is toegewezen, zou u ook toestemmingen aan moeten toewijzen Salesforce Marketing Cloud gegevensextensie die is gekoppeld aan de velden die u wilt bijwerken.
Aangezien deze bestemming toegang tot vereist data extension
, moet u ze toestaan. Bijvoorbeeld voor de Email
data extension u moet toestaan zoals hieronder getoond:
Om het niveau van toegang te beperken, kunt u individuele toegang ook met voeten treden door korrelige voorrechten te gebruiken.
Zie de Marketing Cloud Roles en Marketing Cloud Roles and Permissions pagina's voor gedetailleerde begeleiding.
Gather Salesforce Marketing Cloud geloofsbrieven gather-credentials
Noteer de onderstaande items voordat u deze verifieert voor de (API) Salesforce Marketing Cloud bestemming.
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,u moet verstrekken
mcq4jrssqdlyc4lph19nnqgzzs84
als de waarde.Guardrails guardrails
-
Salesforce stelt bepaalde tarieflimieten.
- Zie de Salesforce Marketing Cloud documentatie om eventuele limieten aan te pakken die u tijdens de uitvoering kunt tegenkomen en fouten te reduceren.
- Zie de Salesforce Marketing Cloud Prijs voor betrokkenheid pagina naar Download de vergelijkingstabel van de Volledige Uitgave als een pdf waarin de limieten worden beschreven die in uw plan worden opgelegd.
- De API-overzicht pagina details extra limieten.
- Vernieuwen hier voor een pagina waarop deze gegevens worden gesorteerd.
-
Het aantal aangepaste velden toegestaan per object varieert afhankelijk van uw Salesforce Edition.
-
Zie de Salesforce documentatie voor aanvullende richtsnoeren.
-
Als u de limiet voor aangepaste velden toegestaan per object binnen Salesforce Marketing Cloud u zult moeten
- Oudere kenmerken verwijderen voordat u nieuwe kenmerken toevoegt in Salesforce Marketing Cloud.
- Werk of verwijder om het even welk geactiveerd publiek in de bestemmingen van het Platform bij die deze oudere attributennamen als waarde gebruiken die voor Mapping ID tijdens de publieksplanning stap.
-
Ondersteunde identiteiten supported-identities
(API) Salesforce Marketing Cloud ondersteunt de activering van identiteiten die in de onderstaande tabel worden beschreven. Meer informatie over identiteiten.
Ondersteunde doelgroepen supported-audiences
In deze sectie wordt beschreven welke soorten publiek u naar dit doel kunt exporteren.
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 segmentstatus in Salesforce Marketing Cloud wordt bijgewerkt met de corresponderende publieksstatus van Platform, gebaseerd op de Mapping ID waarde die tijdens de publieksplanning stap.
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 (API) Salesforce Marketing Cloud. U kunt de locatie ook onder de Email marketing 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 Marketing Cloud geloofsbrieven voor eventuele richtsnoeren.
Als uw domein bijvoorbeeld
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,u moet verstrekken
mcq4jrssqdlyc4lph19nnqgzzs84
als de waarde.Client ID
.Client 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.
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.
{width="100" modal="regular"}
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 (API) Salesforce Marketing Cloud 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.
Uw XDM-velden op de juiste wijze toewijzen aan de (API) Salesforce Marketing Cloud de bestemmingsgebieden, volg de hieronder stappen.
-
Hoewel de namen van uw kenmerken overeenkomen Salesforce Marketing Cloud account, de toewijzingen voor beide
contactKey
enpersonalEmail.address
zijn verplicht. -
De integratie met de Salesforce Marketing Cloud API is onderworpen aan een pagineringsgrens van hoeveel attributen Experience Platform van Salesforce kan terugwinnen. Dit betekent tijdens de Mapping stap, kan het schema van het doelgebied een maximum van 2000 attributen van uw rekening Salesforce tonen.
-
In de Mapping stap, selecteren Add new mapping. Er verschijnt 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 attributes en selecteer een kenmerk in de gegevensextensies die zo nodig worden weergegeven. De (API) Salesforce Marketing Cloud doel gebruikt Salesforce Marketing Cloud Search Attribute-Set Definitions REST API om de gegevensextensies en de bijbehorende gekoppelde kenmerken dynamisch op te halen, zoals gedefinieerd in Salesforce Marketing Cloud. Deze worden weergegeven in het dialoogvenster Target field popup wanneer u opstelling toewijzing in de publiek actief maken, workflow.
-
Herhaal deze stappen om de volgende toewijzingen tussen uw XDM-profielschema en (API) Salesforce Marketing Cloud:
table 0-row-3 1-row-3 2-row-3 3-row-3 Bronveld Doelveld Verplicht IdentityMap: contactKey
Identity: salesforceContactKey
Mandatory
xdm: personalEmail.address
Attribute: Email Address
van de Salesforce Marketing Cloud Email Addresses gegevensextensie.Mandatory
, bij het toevoegen van nieuwe contactpersonen.xdm: person.name.firstName
Attribute: First Name
van het gewenste Salesforce Marketing Cloud gegevensextensie.- -
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, moet u het publiek van het Platform aan de attributes in Salesforce Marketing Cloud.
Om dit te doen, selecteer elk segment, dan ga naam van de attributen van in Salesforce Marketing Cloud in de (API) Salesforce Marketing Cloud Mapping ID veld. Zie de Kenmerk maken binnen Salesforce Marketing Cloud voor begeleiding en beste praktijken bij het maken van kenmerken in Salesforce Marketing Cloud.
Als uw Salesforce Marketing Cloud kenmerk is salesforce_mc_segment_1
geeft u deze waarde op in het dialoogvenster (API) Salesforce Marketing Cloud Mapping ID om het publiek te vullen van Experience Platform in dit kenmerk.
Een voorbeeldkenmerk van Salesforce Marketing Cloud wordt hieronder weergegeven:
Een voorbeeld dat de plaats van wijst (API) Salesforce Marketing Cloud Mapping ID wordt hieronder weergegeven:
Zoals getoond de (API) Salesforce Marketing Cloud Mapping ID moet exact overeenkomen met de waarde die is opgegeven binnen Salesforce Marketing Cloud FIELD NAME.
Herhaal deze sectie voor elk geactiveerd platformsegment.
Een typisch voorbeeld op basis van de bovenstaande afbeelding zou kunnen zijn.
| (API) Salesforce Marketing Cloud segmentnaam | Salesforce Marketing Cloud FIELD NAME | (API) Salesforce Marketing Cloud Mapping ID | | — | — | — | | salesforce mc publiek 1 | salesforce_mc_segment_1
| salesforce_mc_segment_1
| | salesforce mc publiek 2 | salesforce_mc_segment_2
| salesforce_mc_segment_2
|
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.
-
Aanmelden bij de Salesforce Marketing Cloud website. Navigeer vervolgens naar de Audience Builder > Contact Builder > All contacts > Email en controleer of de profielen van het publiek zijn toegevoegd.
-
Navigeer naar de Email en controleert u of de kenmerkwaarden voor het profiel van de doelgroep zijn bijgewerkt. Als dit lukt, kunt u zien dat elke publieksstatus in Salesforce Marketing Cloud werd bijgewerkt met de overeenkomstige publieksstatus van Platform, gebaseerd op Mapping ID de waarde die in de publieksplanning stap.
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 verplaatsen van gebeurtenissen naar de Salesforce-Marketing Cloud 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 (API) Salesforce Marketing Cloud doel komt exact overeen met de naam van het kenmerk dat u hebt gemaakt in Salesforce Marketing Cloud. Zie de Kenmerk maken binnen Salesforce Marketing Cloud 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 Marketing Cloud accountbeheerder om toe te voegen IP-adressen van Experience Platforms aan uw Salesforce Marketing Cloud de vertrouwde op IP van rekeningen waaiers. Zie de Salesforce Marketing Cloud IP Adressen voor Opname op Lijsten van gewenste personen in Marketing Cloud documentatie als u extra begeleiding nodig hebt.
Aanvullende bronnen additional-resources
- Salesforce Marketing Cloud API
- Salesforce Marketing Cloud documentatie verklaren hoe de contacten met de gespecificeerde informatie worden bijgewerkt.
Changelog changelog
Deze sectie vangt de functionaliteit en de significante documentatieupdates aan deze bestemmingsschakelaar worden aangebracht die.
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto | ||
---|---|---|
Releasedatum | Type bijwerken | Beschrijving |
Oktober 2023 | Documentatie bijwerken |
|
April 2023 | Documentatie bijwerken |
|
Februari 2023 | Documentatie bijwerken | We hebben de Vereisten in (API) Salesforce-Marketing Cloud om een verwijzingskoppeling op te nemen die Salesforce Marketing Cloud Engagement is een verplicht abonnement om deze bestemming te gebruiken. |
Februari 2023 | Functionaliteitsupdate | We hebben een probleem opgelost waarbij een onjuiste configuratie in de bestemming ertoe leidde dat een verkeerd gevormde JSON naar Salesforce werd gestuurd. Dit heeft ertoe geleid dat sommige gebruikers hoge aantallen identiteiten ontbrak bij activering zagen. (PLATIR-26299) |
Januari 2023 | Documentatie bijwerken |
|
Oktober 2022 | Eerste release | Oorspronkelijke doelversie en documentatie publiceren. |