(API) Salesforce Marketing Cloud verbinding
Overzicht overview
(API) Salesforce Marketing Cloud(voorheen bekend als ExactTarget) is een digitale marketingsuite waarmee u ritten kunt maken en aanpassen voor bezoekers en klanten om hun ervaring aan te passen.
Vergeleken met Salesforce Marketing Cloud Account Engagement die meer gericht op B2B marketing is, is de (API) Salesforce Marketing Cloud bestemming ideaal voor B2C gebruiksgevallen met kortere transactie besluitvormingscycli. U kunt grotere datasets consolideren die het gedrag van uw doelpubliek vertegenwoordigen om marketing campagnes aan te passen en te verbeteren door aan contacten voorrang te geven en te segmenteren, vooral van datasets buiten Salesforce. Nota, heeft het Experience Platform ook een verbinding voor Salesforce Marketing Cloud Account Engagement.
Dit Adobe Experience Platform bestemminggebruikt Salesforce Marketing Cloud updatecontactenAPI, die u toestaat om contacten toe te voegen en contactgegevens voor uw bedrijfsbehoeften bij te werken na hen binnen een nieuw Salesforce Marketing Cloud segment te activeren.
Salesforce Marketing Cloud gebruikt OAuth 2 met Client Credentials als het verificatiemechanisme om te communiceren met de Salesforce Marketing Cloud API. De instructies om aan uw Salesforce Marketing Cloud instantie voor authentiek te verklaren zijn verder hieronder, in voor authentiek verklaren aan bestemmingssectie.
Gebruiksscenario’s use-cases
Om u beter te helpen begrijpen hoe en wanneer u de (API) Salesforce Marketing Cloud bestemming zou moeten gebruiken, is hier een geval van het 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-mailadressen) door Adobe Experience Platform, publiek van hun eigen off-line gegevens bouwen, en deze publiek naar Salesforce Marketing Cloud verzenden, die dan kan worden gebruikt om de marketing campagne e-mail te verzenden.
Vereisten prerequisites
Vereisten in Experience Platform prerequisites-in-experience-platform
Alvorens gegevens aan de (API) Salesforce Marketing Cloud bestemming te activeren, moet u a schema, a datasethebben, en segmentendie in Experience Platform worden gecreeerd.
Vereisten in (API) Salesforce Marketing Cloud prerequisites-destination
Houd rekening met de volgende voorwaarden om gegevens van Platform naar uw Salesforce Marketing Cloud -account te exporteren:
U moet een Salesforce Marketing Cloud -account hebben prerequisites-account
Een Salesforce Marketing Cloud rekening met een abonnement op het Marketing Cloud Engagementproduct is verplicht te werk te gaan.
Bereik uit aan Salesforce Steunals u geen Salesforce Marketing Cloud rekening hebt of uw rekening het Marketing Cloud Engagement productabonnement mist.
Kenmerken maken binnen Salesforce Marketing Cloud prerequisites-attribute
Wanneer het activeren van publiek aan de (API) Salesforce Marketing Cloud bestemming, moet u een waarde op het Mapping ID gebied voor elk geactiveerd publiek, in de planningsstap van het Publiek invoeren.
Salesforce 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 Marketing Cloud 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 naar Salesforce , moet u een kenmerk van het type Text
hebben dat is gekoppeld aan de gegevensextensie Email Demographics in Salesforce Marketing Cloud . Gebruik Salesforce Marketing Cloud Contact Builder om kenmerken te maken. Verwijs naar de Salesforce Marketing Cloud documentatie om attributentot stand te brengen als u begeleiding bij het creëren van attributen nodig hebt.
De namen van kenmerkvelden worden tijdens de Mapping -stap gebruikt voor het doelveld van (API) Salesforce Marketing Cloud . U kunt het veldteken definiëren met maximaal 4000 tekens, afhankelijk van uw zakelijke vereisten. Zie de Salesforce Marketing Cloud de documentatiepagina van de Types van Gegevens van Uitbreidingen van Gegevens van Gegevens van de Uitbreidingen van Gegevensvoor extra informatie over attributentypes.
Een voorbeeld van het scherm van de gegevensontwerper in Salesforce Marketing Cloud, waarin u de attributen zult toevoegen wordt hieronder getoond:
Hieronder ziet u een weergave van een Salesforce Marketing Cloud Email Data -kenmerkgroep met kenmerken die overeenkomen met de publieksstatus in de Email Demographics -gegevensextensie:
De (API) Salesforce Marketing Cloud bestemming gebruikt Salesforce Marketing Cloud Search Attribute-Set Definitions REST APIom de gegevensuitbreidingen en hun verbonden die attributen dynamisch terug te winnen binnen Salesforce Marketing Cloud worden bepaald.
Deze worden getoond in het Target field selectievenster wanneer u opstelling de afbeeldingin het werkschema om publiek aan de bestemmingte activeren.
salesforce_mc_segment_1
. Wanneer u een publiek activeert naar dit doel, voegt u salesforce_mc_segment_1
toe als Mapping ID om het publiek vanuit het Experience Platform te vullen met dit kenmerk.Hieronder ziet u een voorbeeld van het maken van kenmerken in Salesforce Marketing Cloud :
- Neem bij het maken van het kenmerk geen spatietekens op in de veldnaam. Gebruik in plaats daarvan het onderstrepingsteken
(_)
als scheidingsteken. - Als u onderscheid wilt maken tussen kenmerken die worden gebruikt voor het publiek Platform en andere kenmerken binnen Salesforce Marketing Cloud , kunt u een herkenbaar voor- of achtervoegsel opnemen voor de kenmerken die worden gebruikt voor Adobe-segmenten. Gebruik bijvoorbeeld
Adobe_test_segment
oftest_segment_Adobe
in plaats vantest_segment
. - Als u al andere kenmerken hebt die in Salesforce Marketing Cloud zijn gemaakt, kunt u dezelfde naam gebruiken als het platformsegment om het publiek gemakkelijk te identificeren in Salesforce Marketing Cloud .
Gebruikersrollen en machtigingen toewijzen binnen Salesforce Marketing Cloud prerequisites-roles-permissions
Aangezien Salesforce Marketing Cloud aangepaste rollen ondersteunt, afhankelijk van uw gebruikscase, moet aan uw gebruiker de relevante rollen worden toegewezen om uw kenmerken binnen Salesforce Marketing Cloud bij te werken. Hieronder ziet u een voorbeeld van rollen die aan een gebruiker zijn toegewezen:
Afhankelijk van de rollen die de Salesforce Marketing Cloud -gebruiker heeft toegewezen, moet u ook machtigingen toewijzen aan de Salesforce Marketing Cloud -gegevensextensie die is gekoppeld aan de velden die u wilt bijwerken.
Aangezien deze bestemming toegang tot data extension
vereist, moet u hen toestaan. Bijvoorbeeld voor Email
data extension moet u toestaan zoals hieronder wordt 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 Rolesen Marketing Cloud Roles and Permissionspagina's voor gedetailleerde begeleiding.
Salesforce Marketing Cloud gebruikersgegevens verzamelen gather-credentials
Noteer de onderstaande items voordat u de verificatie uitvoert naar de bestemming (API) Salesforce Marketing Cloud .
is
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,moet u
mcq4jrssqdlyc4lph19nnqgzzs84
als waarde verstrekken.Guardrails guardrails
-
Salesforce legt bepaalde tariefgrenzenvoor.
- Verwijs naar de Salesforce Marketing Cloud documentatieom het even welke waarschijnlijke grenzen te richten die u fouten tijdens uitvoering zou kunnen ontmoeten en verminderen.
- Verwijs naar de Salesforce Marketing Cloud Prijsstelling van de Betrokkenheidpagina aan Download de Volledige Grafiek van de Vergelijking van de Uitgave als pdf die de grenzen door uw plan worden opgelegd detailleert.
- Het API overzichtpaginadetails extra grenzen.
- Verwijs hiervoor een pagina die deze details sorteert.
-
De telling van douanegebieden toegestaan per voorwerp varieert afhankelijk van uw Uitgave Salesforce.
-
Verwijs naar de Salesforce documentatievoor extra begeleiding.
-
Als u de grens hebt bereikt die voor wordt bepaald die douanegebieden per voorwerp worden toegestaan binnen Salesforce Marketing Cloud u zult moeten
- Verwijder oudere kenmerken voordat u nieuwe kenmerken toevoegt in Salesforce Marketing Cloud .
- Werk of verwijder om het even welk geactiveerd publiek in de bestemmingen van het Platform die deze oudere attributennamen als waarde gebruiken voor Mapping ID tijdens de publiek diestap plannen.
-
Ondersteunde identiteiten supported-identities
(API) Salesforce Marketing Cloud ondersteunt de activering van identiteiten die in de onderstaande tabel worden beschreven. Leer meer 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) volgens uw veldtoewijzing.
- Elke segmentstatus in Salesforce Marketing Cloud wordt bijgewerkt met de overeenkomstige publieksstatus van Platform, die op de Mapping ID waarde wordt gebaseerd die tijdens de publiek wordt verstrekt diestap plant.
Verbinden met de bestemming connect
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.
Zoek in Destinations > Catalog naar (API) Salesforce Marketing Cloud . U kunt de locatie ook in de categorie Email marketing 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 Marketing Cloud geloofsbrievensectie voor om het even welke begeleiding.
Bijvoorbeeld als uw domein
is
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,u
mcq4jrssqdlyc4lph19nnqgzzs84
als waarde moet verstrekken.Client ID
.Client Secret
.{het schermschot van het platform UI die tonen hoe te om aan Marketing Cloud Salesforce 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.
{het schermschot van het platform UI die de bestemmingsdetails toont.
- Name: Een naam waarmee u dit doel in de toekomst herkent.
- 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. 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
-
Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
-
Om identiteiten uit te voeren, hebt u de View Identity Graph toegangsbeheertoestemmingnodig.
{width="100" modal="regular"}
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 (API) Salesforce Marketing Cloud -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.
Voer de onderstaande stappen uit om uw XDM-velden correct toe te wijzen aan de (API) Salesforce Marketing Cloud -doelvelden.
-
Hoewel de namen van uw kenmerken overeenkomen met die van uw Salesforce Marketing Cloud -account, zijn toewijzingen voor zowel
contactKey
alspersonalEmail.address
verplicht. -
Voor de integratie met de Salesforce Marketing Cloud API geldt een pagineringslimiet van het aantal kenmerken dat Experience Platform van Salesforce kan ophalen. Dit betekent dat tijdens de stap Mapping het doelveldschema maximaal 2000 kenmerken van uw Salesforce-account kan weergeven.
-
Selecteer Add new mapping in de stap Mapping . Er verschijnt een nieuwe toewijzingsrij op het scherm.
{het screenshot voorbeeld van het platform UI voor Add nieuwe afbeelding. -
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.
-
Kies in het venster Select target field de Select identity namespace en selecteer een identiteit of kies Select attributes de categorie en selecteer een kenmerk uit de gegevensextensies die zo nodig worden weergegeven. De (API) Salesforce Marketing Cloud bestemming gebruikt Salesforce Marketing Cloud Search Attribute-Set Definitions REST APIom de gegevensuitbreidingen en hun verbonden die attributen dynamisch terug te winnen binnen Salesforce Marketing Cloud worden bepaald. Deze worden getoond in Target field popup wanneer u opstelling de afbeeldingin activeert publiek werkschema.
-
Herhaal deze stappen om de volgende toewijzingen tussen uw XDM-profielschema en (API) Salesforce Marketing Cloud toe te voegen:
table 0-row-3 1-row-3 2-row-3 3-row-3 Source-veld Doelveld Verplicht IdentityMap: contactKey
Identity: salesforceContactKey
Mandatory
xdm: personalEmail.address
Attribute: Email Address
in de gegevensextensie Salesforce Marketing Cloud Email Addresses .Mandatory
bij het toevoegen van nieuwe contactpersonen.xdm: person.name.firstName
Attribute: First Name
uit de 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
Wanneer het uitvoeren van de stap van de de publieksuitvoer van het Programma, moet u het publiek van het Platform aan de attributenin kaart brengen Salesforce Marketing Cloud.
Hiervoor selecteert u elk segment en voert u vervolgens een naam in van het kenmerk uit Salesforce Marketing Cloud in het veld (API) Salesforce Marketing Cloud Mapping ID . Verwijs naar creeer attribuut binnen Salesforce Marketing Cloud sectie voor begeleiding en beste praktijken bij het creëren van attributen in Salesforce Marketing Cloud.
Als uw Salesforce Marketing Cloud -kenmerk bijvoorbeeld salesforce_mc_segment_1
is, geeft u deze waarde op in (API) Salesforce Marketing Cloud Mapping ID om het publiek vanuit het Experience Platform in dit kenmerk te vullen.
Hieronder ziet u een voorbeeldkenmerk van Salesforce Marketing Cloud :
Hieronder ziet u een voorbeeld van de locatie van (API) Salesforce Marketing Cloud Mapping ID :
{het screenshot voorbeeld van het Platform UI die het publiek van het Programma tonen uitvoer.
Zoals u ziet, moet (API) Salesforce Marketing Cloud Mapping ID 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.
salesforce_mc_segment_1
salesforce_mc_segment_1
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:
-
Selecteer Destinations > Browse om naar de lijst met doelen te navigeren.
-
Selecteer het doel en bevestig dat de status enabled is.
-
Ga naar het tabblad Activation data en selecteer vervolgens een publieksnaam.
-
Controleer het publieksoverzicht en zorg ervoor dat de telling van profielen aan de telling beantwoordt die binnen het segment wordt gecreeerd.
-
Meld u aan bij de Salesforce Marketing Cloud-website. Navigeer vervolgens naar de pagina Audience Builder > Contact Builder > All contacts > Email en controleer of de profielen van het publiek zijn toegevoegd.
{het schermschot van de Marketing Cloud UI van 0} Salesforce die de pagina van Contacten met profielen toont in het segment worden gebruikt. -
Als u wilt controleren of er profielen zijn bijgewerkt, navigeert u naar de pagina Email en controleert u of de kenmerkwaarden voor het profiel van de doelgroep zijn bijgewerkt. Als succesvol, kunt u zien dat elke publieksstatus in Salesforce Marketing Cloud met de overeenkomstige publieksstatus van Platform werd bijgewerkt, dat op de Mapping ID waarde wordt gebaseerd die in de publiek wordt verstrekt diestap plant.
{het schermschot van de Marketing Cloud UI van 0} Salesforce die de geselecteerde E-mailpagina van Contacten 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 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.
{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 (API) Salesforce Marketing Cloud -doel exact overeenkomt met de naam van het kenmerk dat u in Salesforce Marketing Cloud hebt gemaakt. Verwijs naar creeer attribuut binnen Salesforce Marketing Cloud 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...
- Om deze fout te bevestigen, contacteer uw Salesforce Marketing Cloud rekeningsbeheerder om Experience Platform IP adressenaan uw Salesforce Marketing Cloud vertrouwde op IP waaiers van rekeningen toe te voegen. Verwijs naar Salesforce Marketing Cloud IP Adressen voor Opname op Lijsten van gewenste personen in Marketing Clouddocumentatie als u extra begeleiding nodig hebt.
Aanvullende bronnen additional-resources
- Salesforce Marketing Cloud API
- Salesforce Marketing Cloud documentatieverklarend 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 | Wij hebben de Eerste vereisten in (API) Marketing Cloud Salesforcesectie bijgewerkt om een verwijzingsverbinding te omvatten die aanroept dat Salesforce Marketing Cloud Engagement een verplicht abonnement is 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. |