(API) Salesforce Marketing Cloud-anslutning

Översikt overview

(API) Salesforce Marketing Cloud (tidigare kallat ExactTarget) är en digital marknadsföringssvit som gör att du kan skapa och anpassa resor för besökare och kunder för att anpassa deras upplevelse.

IMPORTANT
Observera skillnaden mellan den här anslutningen och den andra Salesforce Marketing Cloud anslutningen som finns i katalogavsnittet E-postmarknadsföring. Med den andra Salesforce Marketing Cloud-anslutningen kan du exportera filer till en angiven lagringsplats, medan detta är en API-baserad direktuppspelningsanslutning.

Jämfört med Salesforce Marketing Cloud Account Engagement, som är mer inriktad på B2B-marknadsföring, är (API) Salesforce Marketing Cloud-målet idealiskt för B2C-användningsfall med kortare beslutscykler för transaktioner. Du kan konsolidera större datauppsättningar som representerar målgruppens beteende för att justera och förbättra marknadsföringskampanjer genom att prioritera och segmentera kontakter, särskilt från datauppsättningar utanför Salesforce. Obs! Experience Platform har också en anslutning för Salesforce Marketing Cloud Account Engagement.

Det här Adobe Experience Platform målet använder API:t Salesforce Marketing Cloud Uppdatera kontakter som gör att du kan lägga till kontakter och uppdatera kontaktdata för dina affärsbehov efter att du har aktiverat dem i ett nytt Salesforce Marketing Cloud-segment.

Salesforce Marketing Cloud använder OAuth 2 med klientautentiseringsuppgifter som autentiseringsmekanism för att kommunicera med Salesforce Marketing Cloud API. Instruktioner för autentisering till din Salesforce Marketing Cloud-instans finns längre ned i avsnittet Autentisera till mål.

Användningsfall use-cases

För att du bättre ska kunna förstå hur och när du ska använda målet (API) Salesforce Marketing Cloud finns det ett exempel på användning som Adobe Experience Platform-kunder kan lösa genom att använda det här målet.

Skicka e-post till kontakter för marknadsföringskampanjer use-case-send-emails

Försäljningsavdelningen på en uthyrningsplattform vill sända ett marknadsföringsmejl till en målgrupp. Plattformens marknadsföringsteam kan lägga till nya kontakter/uppdatera befintliga kontakter (och deras e-postadresser) via Adobe Experience Platform, bygga målgrupper utifrån deras egna offlinedata och skicka dessa målgrupper till Salesforce Marketing Cloud som sedan kan användas för att skicka marknadsföringskampanjens e-post.

Förhandskrav prerequisites

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

Innan du aktiverar data till målet (API) Salesforce Marketing Cloud måste du ha ett schema, en datamängd och segment som skapats i Experience Platform.

Förutsättningar i (API) Salesforce Marketing Cloud prerequisites-destination

Observera följande krav för att kunna exportera data från Platform till ditt Salesforce Marketing Cloud-konto:

Du måste ha ett Salesforce Marketing Cloud-konto prerequisites-account

Ett Salesforce Marketing Cloud-konto med en prenumeration på Marketing Cloud Engagement-produkten är obligatoriskt för att fortsätta.

Kontakta Salesforce support om du inte har något Salesforce Marketing Cloud-konto eller om ditt konto saknar produktprenumerationen Marketing Cloud Engagement.

Skapa attribut i Salesforce Marketing Cloud prerequisites-attribute

När du aktiverar målgrupper till målet (API) Salesforce Marketing Cloud måste du ange ett värde i fältet Mapping ID för varje aktiverad målgrupp i steget Målgruppsschema.

Salesforce kräver det här värdet för att kunna läsa och tolka målgrupper som kommer från Experience Platform korrekt och för att uppdatera deras målgruppsstatus inom Salesforce Marketing Cloud. Se Experience Platform-dokumentationen för schemafältgruppen Information om målgruppsmedlemskap om du behöver vägledning om målgruppsstatus.

För varje målgrupp som du aktiverar från Platform till Salesforce måste du ha ett attribut av typen Text länkat till datatillägget Email Demographics i Salesforce Marketing Cloud. Använd Salesforce Marketing Cloud Contact Builder för att skapa attribut. Läs Salesforce Marketing Cloud-dokumentationen om du vill skapa attribut om du behöver hjälp med att skapa attribut.

Attributfältsnamnen används för målfältet (API) Salesforce Marketing Cloud under steget Mapping. Du kan definiera fälttecknet med högst 4 000 tecken, beroende på dina affärsbehov. Mer information om attributtyper finns på dokumentationssidan Salesforce Marketing Cloud Datatilläggsdatatyper .

Ett exempel på datadesignerskärmen i Salesforce Marketing Cloud där du ska lägga till attributet visas nedan:
Datadesigner för användargränssnittet i Salesforce Marketing Cloud.

En vy över en Salesforce Marketing Cloud Email Data-attributgrupp med attribut som motsvarar målgruppens status i datatillägget Email Demographics visas nedan:
Användargränssnittsgruppen för e-postdata i Salesforce Marketing Cloud.

Målet (API) Salesforce Marketing Cloud använder Salesforce Marketing Cloud Search Attribute-Set Definitions REST API för att dynamiskt hämta datatilläggen och deras länkade attribut som definierats i Salesforce Marketing Cloud.

Dessa visas i urvalsfönstret Target field när du ställer in mappningen i arbetsflödet för att aktivera målgrupper till målet.

IMPORTANT
Inom Salesforce Marketing Cloud måste du skapa attribut med en FIELD NAME som exakt matchar värdet som anges i Mapping ID för varje aktiverat plattformssegment. Skärmbilden nedan visar till exempel attributet salesforce_mc_segment_1. När du aktiverar en målgrupp på det här målet lägger du till salesforce_mc_segment_1 som Mapping ID för att fylla målgrupper från Experience Platform i det här attributet.

Ett exempel på hur du skapar attribut i Salesforce Marketing Cloud visas nedan:
Skärmbild för användargränssnittet i Salesforce Marketing Cloud med ett attribut.

TIP
  • När du skapar attributet ska du inte ta med blankstegstecken i fältnamnet. Använd i stället understrecket (_) som avgränsare.
  • Om du vill skilja mellan attribut som används för plattformsmålgrupper och andra attribut i Salesforce Marketing Cloud kan du inkludera ett identifierbart prefix eller suffix för attributen som används för Adobe-segment. Använd till exempel Adobe_test_segment eller test_segment_Adobe i stället för test_segment.
  • Om du redan har andra attribut skapade i Salesforce Marketing Cloud kan du använda samma namn som plattformssegmentet för att enkelt identifiera målgruppen i Salesforce Marketing Cloud.

Tilldela användarroller och behörigheter i Salesforce Marketing Cloud prerequisites-roles-permissions

Eftersom Salesforce Marketing Cloud har stöd för anpassade roller beroende på ditt användningsfall, bör din användare tilldelas de relevanta rollerna för att uppdatera dina attribut i Salesforce Marketing Cloud. Ett exempel på roller som tilldelats en användare visas nedan:
Användargränssnittet Salesforce Marketing Cloud för en vald användare som visar sina tilldelade roller.

Beroende på vilka roller din Salesforce Marketing Cloud-användare har tilldelats, måste du även tilldela behörigheter till datatillägget Salesforce Marketing Cloud som är länkade till de fält som du vill uppdatera.

Eftersom det här målet kräver åtkomst till data extension måste du tillåta dem. Till exempel för Email data extension som du måste tillåta enligt nedan:

Användargränssnittet i Salesforce Marketing Cloud visar e-postdatatillägget med tillåtna behörigheter.

Om du vill begränsa åtkomstnivån kan du även åsidosätta individuell åtkomst genom att använda detaljerade behörigheter.
Användargränssnittet i Salesforce Marketing Cloud visar e-postdatatillägget med detaljerad behörighet.

Mer information finns på sidorna Marketing Cloud Roles och Marketing Cloud Roles and Permissions.

Samla in inloggningsuppgifter för Salesforce Marketing Cloud gather-credentials

Anteckna objekten nedan innan du autentiserar till målet (API) Salesforce Marketing Cloud.

Autentiseringsuppgifter
Beskrivning
Exempel
Underdomän
Mer information om hur du hämtar det här värdet från gränssnittet Salesforce Marketing Cloud finns i Salesforce Marketing Cloud domain prefix.
Om din Salesforce Marketing Cloud-domän är
mcq4jrssqdlyc4lph19nnqgzzs84.login.exactarget.com,
du måste ange mcq4jrssqdlyc4lph19nnqgzzs84 som värde.
Klient-ID
Läs Salesforce Marketing Cloud documentation om du vill veta hur du hämtar det här värdet från gränssnittet Salesforce Marketing Cloud.
r23kxxxxxx0z05xxxx
Klienthemlighet
Läs Salesforce Marketing Cloud documentation om du vill veta hur du hämtar det här värdet från gränssnittet Salesforce Marketing Cloud.
ipxxxxxxxxxxT4xxxxxxxx

Guardrails guardrails

  • Salesforce tillämpar vissa hastighetsbegränsningar.

    • Läs Salesforce Marketing Cloud dokumentation om du vill åtgärda eventuella begränsningar som kan uppstå och minska antalet fel under körningen.
    • Gå till sidan Salesforce Marketing Cloud Åtagandepriser för att hämta jämförelsetabellen med fullständiga utgåvor som en pdf som innehåller information om de begränsningar som din plan innebär.
    • Sidan API-översikt innehåller ytterligare begränsningar.
    • Gå till här för en sida som samlar in dessa uppgifter.
  • Antalet anpassade fält som tillåts per objekt varierar beroende på din Salesforce Edition.

    • Mer information finns i Salesforce dokumentationen.

    • Om du har nått gränsen som definierats för anpassade fält som tillåts per objekt inom Salesforce Marketing Cloud måste du

      • Ta bort äldre attribut innan du lägger till nya attribut i Salesforce Marketing Cloud.
      • Uppdatera eller ta bort aktiverade målgrupper i plattformsmål som använder dessa äldre attributnamn som det värde som anges för Mapping ID under steget målgruppsplanering.

Identiteter som stöds supported-identities

(API) Salesforce Marketing Cloud stöder aktivering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.

Målidentitet
Beskrivning
Överväganden
contactKey
Salesforce Marketing Cloud Kontaktnyckel. Mer information finns i Salesforce Marketing Cloud dokumentationen om du behöver ytterligare vägledning.
Obligatoriskt

Målgrupper supported-audiences

I det här avsnittet beskrivs vilka typer av målgrupper du kan exportera till det här målet.

Målgruppsursprung
Stöds
Beskrivning
Segmentation Service
Publiker som genererats via Experience Platform segmenteringstjänsten.
Anpassade överföringar
X
Publikerna importerade till Experience Platform från CSV-filer.

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 (till exempel e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • Varje segmentstatus i Salesforce Marketing Cloud uppdateras med motsvarande målgruppsstatus från Platform, baserat på värdet Mapping ID som tillhandahölls under steget målgruppsplanering.
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 direktuppspelningsmål.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet måste du ha Manage Destinations åtkomstkontrollbehörighet. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

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

Sök efter (API) Salesforce Marketing Cloud inom Destinations > Catalog. Du kan också hitta den under kategorin Email marketing.

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. Mer information finns i avsnittet Samla Salesforce Marketing Cloud inloggningsuppgifter.

(API) Salesforce Marketing Cloud mål
Salesforce Marketing Cloud
Subdomain
Domänprefixet Salesforce Marketing Cloud.
Om din domän till exempel är
mcq4jrssqdlyc4lph19nnqgzzs84.login.exactarget.com,
du måste ange mcq4jrssqdlyc4lph19nnqgzzs84 som värde.
Client ID
Din Salesforce Marketing Cloud Client ID.
Client Secret
Din Salesforce Marketing Cloud Client Secret.

Skärmbild för användargränssnittet för plattformen som visar hur du autentiserar till Salesforce Marketing Cloud.

Om den angivna informationen är giltig visar gränssnittet Connected-status med en grön bockmarkering, och du kan sedan 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.
Skärmbild för plattformsgränssnitt som visar målinformationen.

  • 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.

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 prenumerera på destinationsvarningar med användargränssnittet.

Välj Next när du är klar med att ange information för målanslutningen.

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

IMPORTANT
  • För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.
  • Om du vill exportera identiteter måste du ha View Identity Graph åtkomstkontrollbehörighet.
    Markera identitetsnamnområdet som är markerat i arbetsflödet för att aktivera målgrupper till mål. {width="100" modal="regular"}

Läs Aktivera profiler och målgrupper för att direktuppspela målgruppsexportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

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

Om du vill skicka målgruppsdata från Adobe Experience Platform till målet (API) Salesforce Marketing Cloud 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.

Följ stegen nedan för att mappa dina XDM-fält till målfälten för (API) Salesforce Marketing Cloud korrekt.

IMPORTANT
  • Även om dina attributnamn är som de är för ditt Salesforce Marketing Cloud-konto är mappningarna för både contactKey och personalEmail.address obligatoriska.

  • Integrationen med Salesforce Marketing Cloud-API:t har en sidnumreringsgräns för hur många attribut Experience Platform kan hämta från Salesforce. Detta innebär att målfältschemat kan visa högst 2 000 attribut från ditt Salesforce-konto under steget Mapping.

  1. Välj Add new mapping i steget Mapping. En ny mappningsrad visas på skärmen.
    Exempel på skärmbild för användargränssnittet för plattformen för Lägg till ny mappning.

  2. Välj kategorin Select attributes i fönstret Select source field och markera XDM-attributet eller välj Select identity namespace och välj en identitet.

  3. I fönstret Select target field väljer du Select identity namespace och väljer en identitet eller en Select attributes-kategori och väljer ett attribut bland de datatillägg som visas efter behov. Målet (API) Salesforce Marketing Cloud använder Salesforce Marketing Cloud Search Attribute-Set Definitions REST API för att dynamiskt hämta datatilläggen och deras länkade attribut som definierats i Salesforce Marketing Cloud. Dessa visas i popup-fönstret Target field när du konfigurerar mappningen i arbetsflödet aktivera målgrupper.

    • Upprepa de här stegen för att lägga till följande mappningar mellan XDM-profilschemat och (API) Salesforce Marketing Cloud:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      Source Field Målfält Obligatoriskt
      IdentityMap: contactKey Identity: salesforceContactKey Mandatory
      xdm: personalEmail.address Attribute: Email Address från datatillägget Salesforce Marketing Cloud Email Addresses. Mandatory när nya kontakter läggs till.
      xdm: person.name.firstName Attribute: First Name från det önskade datatillägget Salesforce Marketing Cloud.
    • Ett exempel på hur du använder dessa mappningar visas nedan:

      Exempel på skärmbild för plattformsgränssnitt 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 steget Schemalägg målgruppsexport måste du manuellt mappa plattformsmålgrupper till attributen i Salesforce Marketing Cloud.

Det gör du genom att markera varje segment och sedan ange attributets namn från Salesforce Marketing Cloud i fältet (API) Salesforce Marketing Cloud Mapping ID. Mer information om hur du skapar attribut i Salesforce Marketing Cloud finns i avsnittet Skapa attribut i Salesforce Marketing Cloud.

Om attributet Salesforce Marketing Cloud till exempel är salesforce_mc_segment_1 anger du det här värdet i (API) Salesforce Marketing Cloud Mapping ID för att fylla målgrupper från Experience Platform i det här attributet.

Ett exempelattribut från Salesforce Marketing Cloud visas nedan:
Skärmbild för användargränssnittet i Salesforce Marketing Cloud med ett attribut.

Ett exempel som anger platsen för (API) Salesforce Marketing Cloud Mapping ID visas nedan:
Exempel på skärmbild i användargränssnittet för plattformen som visar export av schemalagda målgrupper.

Så som visas ska (API) Salesforce Marketing Cloud Mapping ID exakt matcha värdet som anges i Salesforce Marketing Cloud FIELD NAME.

Upprepa det här avsnittet för varje aktiverat plattformssegment.

Ett typiskt exempel baserat på bilden ovan kan vara.
| (API) Salesforce Marketing Cloud segmentnamn | Salesforce Marketing Cloud FIELD NAME | (API) Salesforce Marketing Cloud Mapping ID |
| — | — | — |
| salesforce mc målgrupp 1 | salesforce_mc_segment_1 | salesforce_mc_segment_1 |
| salesforce mc målgrupp 2 | salesforce_mc_segment_2 | salesforce_mc_segment_2 |

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 mål.
    Skärmbild för plattformsgränssnitt med bläddringsmål.

  2. Markera målet och validera att statusen är enabled.
    Skärmbild för plattformsgränssnitt med körning av måldataflöde.

  3. Växla till fliken Activation data och välj sedan ett publiknamn.
    Exempel på skärmbild för användargränssnittet för plattformen som 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 in på webbplatsen Salesforce Marketing Cloud. Gå sedan till sidan Audience Builder > Contact Builder > All contacts > Email och kontrollera om profilerna från målgruppen har lagts till.
    Användargränssnittet i Salesforce Marketing Cloud visar sidan Kontakter med profiler som används i segmentet.

  6. Om du vill kontrollera om några profiler har uppdaterats går du till sidan Email och kontrollerar om attributvärdena för profilen från målgruppen har uppdaterats. Om det lyckas kan du se att varje målgruppsstatus i Salesforce Marketing Cloud har uppdaterats med motsvarande målgruppsstatus från Platform, baserat på värdet Mapping ID som anges i steget målgruppsplanering.
    Användargränssnittet i Salesforce Marketing Cloud visar den valda e-postsidan för kontakter med uppdaterade målgruppsstatus.

Dataanvändning och styrning data-usage-governance

Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Datastyrningsöversikten.

Fel och felsökning errors-and-troubleshooting

Okända fel påträffades när händelser skickades till Salesforce Marketing Cloud 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 plattformsgränssnitt visar ett fel.

    • Om du vill åtgärda det här felet kontrollerar du att Mapping ID som du angav i aktiveringsarbetsflödet till (API) Salesforce Marketing Cloud-målet exakt matchar namnet på attributet som du skapade i Salesforce Marketing Cloud. Mer information finns i avsnittet Skapa attribut i Salesforce Marketing Cloud.
  • 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

  • Salesforce Marketing Cloud API
  • Salesforce Marketing Cloud dokumentation som förklarar hur kontakter uppdateras med den angivna informationen.

Changelog changelog

I det här avsnittet beskrivs funktionaliteten och viktiga dokumentationsuppdateringar för den här målanslutningen.

Visa ändringslogg
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Releasamånad Uppdateringstyp Beskrivning
Oktober 2023 Dokumentation - uppdatering
  • Vi har uppdaterat avsnittet Krav i (API) Salesforce Marketing Cloud och har i allmänhet tagit bort onödiga referenser till attributgrupper i hela dokumentet.
  • Uppdaterad dokumentation som anger att attribut för målgruppsstatus endast ska skapas inom Salesforce Marketing Cloud inuti datatillägget Email Demographics.
  • Mappningstabellen i avsnittet Mappningsöverväganden och exempel har uppdaterats. Mappningen för attributet Email Address i datatillägget Email Addresses har markerats som obligatorisk. Detta krav nämndes i bildtexten som är markerad som VIKTIGT, men utelämnades från tabellen.
April 2023 Dokumentation - uppdatering
  • Vi har korrigerat en instruktions- och referenslänk i avsnittet Förutsättningar i (API) Salesforce Marketing Cloud för att anropa att Salesforce Marketing Cloud Engagement är en obligatorisk prenumeration för att använda det här målet. Avsnittet som tidigare anropade felaktigt att användare behöver en prenumeration på Marketing Cloud Account för att kunna fortsätta.
  • Vi lade till ett avsnitt under Krav för roller och behörigheter som ska tilldelas Salesforce-användaren för att det här målet ska fungera. (PLATIR-26299)
Februari 2023 Dokumentation - uppdatering Vi har uppdaterat avsnittet Krav i (API) Salesforce Marketing Cloud så att det innehåller en referenslänk som anropar att Salesforce Marketing Cloud Engagement är en obligatorisk prenumeration för att kunna använda det här målet.
Februari 2023 Funktionsuppdatering Vi har åtgärdat ett problem där en felaktig konfiguration i målet orsakade att ett felaktigt JSON skickades till Salesforce. Detta resulterade i att ett stort antal identiteter inte kunde aktiveras. (PLATIR-26299)
Januari 2023 Dokumentation - uppdatering
  • Vi har uppdaterat avsnittet Krav i Salesforce för att anropa att attribut måste skapas på sidan Salesforce. Det här avsnittet innehåller nu detaljerade anvisningar om hur du gör det och de bästa sätten att namnge attributen i Salesforce. (PLATIR-25602)
  • Vi har lagt till tydliga instruktioner om hur du använder mappnings-ID för varje aktiverad målgrupp i steget målgruppsplanering. (PLATIR-25602)
Oktober 2022 Inledande version Ursprunglig målversion och dokumentationspublicering.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6