(API) Salesforce Marketing Cloud anslutning

Översikt overview

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

IMPORTANT
Observera skillnaden mellan den här anslutningen och den andra Salesforce Marketing Cloud anslutning 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, (API) Salesforce Marketing Cloud målet är idealiskt för B2C Användningsfall med kortare handläggningstider. Ni 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. Observera att Experience Platform också har en anslutning till Salesforce Marketing Cloud Account Engagement.

Detta Adobe Experience Platform mål använder Salesforce Marketing Cloud uppdatera kontakter API, som gör att du kan lägga till kontakter och uppdatera kontaktdata efter att ha aktiverat dem i en ny 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 hur du autentiserar Salesforce Marketing Cloud -instansen är längre ned, i Autentisera till mål -avsnitt.

Användningsfall use-cases

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

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 Cloudsom sedan kan användas för att skicka marknadsföringskampanjens e-post.

Förutsättningar prerequisites

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

Innan du aktiverar data för (API) Salesforce Marketing Cloud mål, du måste ha schema, a datauppsättningoch segment som Experience Platform.

Krav (API) Salesforce Marketing Cloud prerequisites-destination

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

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

A Salesforce Marketing Cloud konto med en prenumeration på Marketing Cloud Engagement produkten är obligatorisk för att fortsätta.

Nå ut till Salesforce Support om du inte har en Salesforce Marketing Cloud eller så saknas kontot Marketing Cloud Engagement produktprenumeration.

Skapa attribut i Salesforce Marketing Cloud prerequisites-attribute

När målgrupper aktiveras för (API) Salesforce Marketing Cloud mål måste du ange ett värde i Mapping ID för varje aktiverad målgrupp, i Målgruppsschema steg.

Salesforce kräver att det här värdet läser och tolkar målgrupper som kommer från Experience Platform korrekt och uppdaterar deras målgruppsstatus inom Salesforce Marketing Cloud. Se dokumentationen för Experience Platform för Schemafältgrupp för målgruppsmedlemskapsdetaljer om ni behöver vägledning om målgruppsstatus.

För varje målgrupp som du aktiverar från Platform till Salesforcemåste du ha ett attribut av typen Text länkad till Email Demographics datatillägg inom Salesforce Marketing Cloud. Använd Salesforce Marketing Cloud Contact Builder för att skapa attribut. Se Salesforce Marketing Cloud dokumentation till skapa attribut om du behöver hjälp med att skapa attribut.

Attributfältsnamnen används för (API) Salesforce Marketing Cloud målfält under Mapping steg. Du kan definiera fälttecknet med högst 4 000 tecken, beroende på dina affärsbehov. Se Salesforce Marketing Cloud Datatyper för datatillägg dokumentationssida för mer information om attributtyper.

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

En vy av en Salesforce Marketing Cloud Email Data attributgrupp med attribut som motsvarar målgruppsstatusen i Email Demographics datatillägg visas nedan:
E-postattributgrupp för användargränssnittet i Salesforce Marketing Cloud.

The (API) Salesforce Marketing Cloud destinationen använder Salesforce Marketing Cloud Search Attribute-Set Definitions REST API att dynamiskt hämta datatilläggen och deras länkade attribut som definierats i Salesforce Marketing Cloud.

Dessa visas i Target field markeringsfönstret när du ställer in mappning till aktivera målgrupper till målet.

IMPORTANT
Inom Salesforce Marketing Cloudmåste du skapa attribut med FIELD NAME som exakt matchar värdet som anges i Mapping ID för varje aktiverat plattformssegment. På skärmbilden nedan visas ett attribut med namnet salesforce_mc_segment_1. Lägg till salesforce_mc_segment_1 as Mapping ID för att fylla målgrupper från Experience Platform i detta attribut.

Ett exempel på hur attribut skapas i Salesforce Marketing Cloud, visas nedan:
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 (_) tecken som avgränsare.
  • Att skilja mellan attribut som används för plattformens målgrupper och andra attribut inom Salesforce Marketing Cloudkan du inkludera ett identifierbart prefix eller suffix för de attribut som används för Adobe-segment. I stället för test_segment, använda Adobe_test_segment eller test_segment_Adobe.
  • Om du redan har andra attribut som Salesforce Marketing Cloudkan 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

Som 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 inom 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 du Salesforce Marketing Cloud användaren har tilldelats, du måste även tilldela behörigheter till 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 extensionmåste du tillåta dem. Till exempel för Email data extension 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.

Se Marketing Cloud Roles och Marketing Cloud Roles and Permissions sidor för detaljerad vägledning.

Samla Salesforce Marketing Cloud autentiseringsuppgifter gather-credentials

Anteckna nedanstående innan du autentiserar dig för (API) Salesforce Marketing Cloud mål.

Autentiseringsuppgifter
Beskrivning
Exempel
Underdomän
Se Salesforce Marketing Cloud domain prefix om du vill veta hur du får fram det här värdet från Salesforce Marketing Cloud gränssnitt.
Om Salesforce Marketing Cloud domänen är
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
du måste ange mcq4jrssqdlyc4lph19nnqgzzs84 som värdet.
Klient-ID
Se Salesforce Marketing Cloud dokumentation om du vill veta hur du får fram det här värdet från Salesforce Marketing Cloud gränssnitt.
r23kxxxxxx0z05xxxx
Klienthemlighet
Se Salesforce Marketing Cloud dokumentation om du vill veta hur du får fram det här värdet från Salesforce Marketing Cloud gränssnitt.
ipxxxxxxxxxxT4xxxxxxxx

Guardrails guardrails

  • Salesforce inför vissa hastighetsbegränsningar.

    • Se Salesforce Marketing Cloud dokumentation för att åtgärda eventuella begränsningar som kan uppstå och minska antalet fel under körningen.
    • Se Salesforce Marketing Cloud Engagemangspris sida till Ladda ned jämförelsetabellen för fullversionen som en pdf som detaljerar de begränsningar som din plan innebär.
    • The API-översikt ytterligare begränsningar för sidinformation.
    • Referens här för en sida som sammanställer dessa uppgifter.
  • Antal anpassade fält tillåtna per objekt varierar beroende på din Salesforce Edition.

    • Se Salesforce dokumentation för ytterligare vägledning.

    • Om du har nått gränsen för anpassade fält tillåtna 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 angivna värdet Mapping ID under målgruppsplanering steg.

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. Se Salesforce Marketing Cloud dokumentation 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
Målgrupper som skapats genom Experience Platform Segmenteringstjänst.
Anpassade överföringar
X
Målgrupper importerad 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 (t.ex. e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • Varje segmentstatus i Salesforce Marketing Cloud uppdateras med motsvarande målgruppsstatus från Platform, baserat på Mapping ID det värde som anges under målgruppsplanering steg.
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 mål för direktuppspelning.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du Manage Destinations behörighet för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

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

Inom Destinations > Catalog, sök efter (API) Salesforce Marketing Cloud. Du kan även hitta den under Email marketing kategori.

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. Se Samla Salesforce Marketing Cloud autentiseringsuppgifter för vägledning.

(API) Salesforce Marketing Cloud mål
Salesforce Marketing Cloud
Subdomain
Dina Salesforce Marketing Cloud domänprefix.
Om din domän till exempel är
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
du måste ange mcq4jrssqdlyc4lph19nnqgzzs84 som värdet.
Client ID
Dina Salesforce Marketing Cloud Client ID.
Client Secret
Dina Salesforce Marketing Cloud Client Secret.

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

Om den angivna informationen är giltig visas en Connected status med en grön bockmarkering kan du 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 användargränssnittet för plattformen 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 på prenumerera på destinationsvarningar med användargränssnittet.

När du är klar med informationen för målanslutningen väljer du Next.

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

IMPORTANT

Läs Aktivera profiler och målgrupper för att strömma målgruppernas exportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

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

Så här skickar du målgruppsdata från Adobe Experience Platform till (API) Salesforce Marketing Cloud mål 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.

Mappa XDM-fälten korrekt till (API) Salesforce Marketing Cloud målfält, följ stegen nedan.

IMPORTANT
  • Även om attributnamnen är som du vill Salesforce Marketing Cloud konto, mappningar för båda contactKey och personalEmail.address är obligatoriska.

  • Integrationen med Salesforce Marketing Cloud API har en sidnumreringsgräns som anger hur många attribut Experience Platform kan hämta från Salesforce. Detta innebär att Mapping målfältets schema kan visa högst 2 000 attribut från ditt Salesforce-konto.

  1. I Mapping steg, välja Add new mapping. En ny mappningsrad visas på skärmen.
    Exempel på skärmbild för användargränssnittet för plattformen för att lägga till ny mappning.

  2. I Select source field väljer du Select attributes och välj XDM-attributet eller välj Select identity namespace och välj en identitet.

  3. I Select target field väljer du Select identity namespace och välj en identitet eller välj Select attributes och välj ett attribut bland de datatillägg som visas efter behov. The (API) Salesforce Marketing Cloud destinationen använder Salesforce Marketing Cloud Search Attribute-Set Definitions REST API att dynamiskt hämta datatilläggen och deras länkade attribut som definierats i Salesforce Marketing Cloud. Dessa visas i Target field popup-fönster när du ställer in mappning i aktivera målgruppsarbetsflöde.

    • Upprepa dessa steg 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
      Källfält Målfält Obligatoriskt
      IdentityMap: contactKey Identity: salesforceContactKey Mandatory
      xdm: personalEmail.address Attribute: Email Address från Salesforce Marketing Cloud Email Addresses datatillägg. Mandatorynär nya kontakter läggs till.
      xdm: person.name.firstName Attribute: First Name från önskat Salesforce Marketing Cloud datatillägg.
    • Ett exempel på hur du använder dessa mappningar visas nedan:

      Exempel på skärmbild för användargränssnittet för plattformen 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 Schemalägg målgruppsexport måste du manuellt mappa plattformsmålgrupper till attributes in Salesforce Marketing Cloud.

Det gör du genom att markera varje segment och sedan ange namnet på attributet från Salesforce Marketing Cloud i (API) Salesforce Marketing Cloud Mapping ID fält. Se Skapa attribut i Salesforce Marketing Cloud för vägledning och bästa metoder för att skapa attribut i Salesforce Marketing Cloud.

Om Salesforce Marketing Cloud attributet är salesforce_mc_segment_1anger du det här värdet i dialogrutan (API) Salesforce Marketing Cloud Mapping ID för att fylla målgrupper från Experience Platform i detta attribut.

Ett exempelattribut från Salesforce Marketing Cloud visas nedan:
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 för användargränssnittet för plattformen som visar export av schemalagda målgrupper.

Som visas (API) Salesforce Marketing Cloud Mapping ID ska 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 destinationer.
    Skärmbild av användargränssnittet för plattformen med bläddringsmål.

  2. Markera målet och validera att statusen är enabled.
    Skärmbild av användargränssnittet för plattformen med körning av måldataflöde.

  3. Växla till Activation data väljer du ett målgruppsnamn.
    Skärmbild för användargränssnittet för plattformen 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å Salesforce Marketing Cloud webbplats. Navigera sedan till 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 Email och verifiera om attributvärdena för profilen från målgruppen har uppdaterats. Om det lyckas ser du att varje målgrupps status Salesforce Marketing Cloud uppdaterades med motsvarande målgruppsstatus från Platform, baserat på Mapping ID värdet i målgruppsplanering steg.
    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 destinationerna är kompatibla med dataanvändningsprinciper när data hanteras. Detaljerad information om hur Adobe Experience Platform använder datastyrning, se Datastyrning - översikt.

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 användargränssnittet för plattformen visar ett fel.

    • Du kan åtgärda felet genom att kontrollera att Mapping ID som du angav i aktiveringsarbetsflödet för (API) Salesforce Marketing Cloud målet matchar exakt namnet på attributet som du skapade i Salesforce Marketing Cloud. Se Skapa attribut i Salesforce Marketing Cloud för vägledning.
  • 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 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 uppdaterade Förutsättningar i (API) Salesforce Marketing Cloud och i allmänhet har onödiga referenser till attributgrupper i dokumentet tagits bort.
  • Uppdaterad dokumentation som anger att attribut för målgruppsstatus ska skapas i Salesforce Marketing Cloud innanför Email Demographics endast datatillägg.
  • Vi uppdaterade mappningstabellen i Mappa överväganden och exempel -avsnitt, mappning för Email Address -attribut i Email Addresses Datatillägget är markerat som obligatoriskt. Detta krav omnämndes i den pratbubbla som är markerad som VIKTIGT, men utelämnades från tabellen.
April 2023 Dokumentation - uppdatering
  • Vi korrigerade en instruktion och en referenslänk i Förutsättningar i (API) Salesforce Marketing Cloud för att ta reda på det Salesforce Marketing Cloud Engagement är en obligatorisk prenumeration för att använda den här destinationen. Avsnittet som tidigare felaktigt anropade att användare behöver en prenumeration på Marketing Cloud Konto Åtagande att fortsätta.
  • Vi lade till ett avsnitt under krav for roller och behörigheter som ska tilldelas Salesforce för att den här destinationen ska fungera. (PLATIR-26299)
Februari 2023 Dokumentation - uppdatering Vi uppdaterade Förutsättningar i (API) Salesforce Marketing Cloud -avsnitt som ska innehålla en referenslänk som anropar den Salesforce Marketing Cloud Engagement är en obligatorisk prenumeration för att använda den här destinationen.
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 uppdaterade Krav Salesforce för att ta reda på att attribut måste skapas i Salesforce sida. 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 målgruppsplanering steg. (PLATIR-25602)
Oktober 2022 Inledande version Ursprunglig målversion och dokumentationspublicering.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6