(API) Salesforce Marketing Cloud anslutning

Översikt

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

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 utnyttjar 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

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

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) genom Adobe Experience Platform, skapa segment utifrån sina egna offlinedata och skicka dessa segment till Salesforce Marketing Cloudsom sedan kan användas för att skicka marknadsföringskampanjens e-post.

Förutsättningar

Förutsättningar i Experience Platform

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

Förutsättningar (API) Salesforce Marketing Cloud

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

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

När segment aktiveras för (API) Salesforce Marketing Cloud mål måste du ange ett värde i Mapping ID för varje aktiverat segment, i Segmentschema steg.

Salesforce kräver att det här värdet läser och tolkar segment som kommer in från Experience Platform korrekt och uppdaterar deras segmentstatus inom Salesforce Marketing Cloud. Se dokumentationen för Experience Platform för Schemafältgrupp för detaljer om segmentmedlemskap om du behöver vägledning om segmentstatus.

För varje segment som du aktiverar från Platform till Salesforce Marketing Cloudmåste du skapa ett attribut av typen Text inom Salesforce. Använd Salesforce Marketing Cloud Contact Builder för att skapa attribut. Attributfältsnamnen används för (API) Salesforce Marketing Cloud målfält och ska skapas under Email Demographics system attribute-set. 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.

Se Salesforce Marketing Cloud dokumentation till skapa attribut om du behöver hjälp med att skapa attribut.

Ett exempel på datadesignerskärmen i Salesforce Marketing Cloudsom du ska lägga till attributet i visas nedan:

En vy av Salesforce Marketing Cloud Email Demographics Attributuppsättningen visas nedan:

The (API) Salesforce Marketing Cloud destinationen använder Salesforce Marketing Cloud Search Attribute-Set Definitions REST API att dynamiskt hämta attributen och deras attributuppsättningar som definierats i Salesforce Marketing Cloud.

Dessa visas i Target field markeringsfönstret när du ställer in mappning i arbetsflödet till aktivera segment till målet. Observera att endast mappningar för de attribut som definieras i Salesforce Marketing Cloud Email Demographics stöds.

Ett exempel på hur attribut skapas i Salesforce Marketing Cloudvisas nedan:

Tilldela användarroller och behörigheter i Salesforce Marketing Cloud

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 i din Salesforce Marketing Cloud attributuppsättningar. Ett exempel på roller som tilldelats en användare visas nedan:

Beroende på vilka roller du har Salesforce Marketing Cloud användaren har tilldelats, du måste även tilldela behörigheter till Salesforce Marketing Cloud som innehåller de fält som du vill uppdatera.

Eftersom det här målet kräver åtkomst till Email Demographics system attribute-setmåste du tillåta Email enligt nedan:

Om du vill begränsa åtkomstnivån kan du även åsidosätta enskilda behörigheter genom att använda detaljerade behörigheter.

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

Samla Salesforce Marketing Cloud autentiseringsuppgifter

Anteckna vad som står nedan innan du autentiserar dig för (API) Salesforce Marketing Cloud mål.

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 Priser 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 segment i plattformsmål där dessa äldre attributnamn används som angivet värde Mapping ID under segmentplanering steg.

Identiteter som stöds

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

Exportera typ och frekvens

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Anslut till målet

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

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.

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

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.

• 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

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 status för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med hjälp av användargränssnittet.

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

Aktivera segment till den här destinationen

Läs Aktivera profiler och segment för att direktuppspela segmentexportmål om du vill ha instruktioner om hur du aktiverar målgruppssegment till det här målet.

Mappa överväganden och exempel

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.

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

1. I Mapping steg, välja Add new mapping. En ny mappningsrad visas på skärmen.
   

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 custom attributes och välj ett attribut i Email Demographics attribut visas efter behov. The (API) Salesforce Marketing Cloud destinationen använder Salesforce Marketing Cloud Search Attribute-Set Definitions REST API för att dynamiskt hämta de attribut och deras attributuppsättningar som definierats i Salesforce Marketing Cloud. Dessa visas i Target field när du ställer in mappning i aktivera segment i arbetsflöde. Obs! Endast mappningar för de attribut som definieras i Salesforce Marketing Cloud Email Demographics stöds.

   • Upprepa dessa steg för att lägga till följande mappningar mellan XDM-profilschemat och (API) Salesforce Marketing Cloud: |Källfält|Målfält| Obligatoriskt| |—|—|—| |IdentityMap: contactKey|Identity: salesforceContactKey| Mandatory |\

     |xdm: person.name.firstName|Attribute: Email Demographics.First Name| - |
     |xdm: personalEmail.address|Attribute: Email Addresses.Email Address| - |

   • Ett exempel på hur du använder dessa mappningar visas nedan:

     

När du har angett mappningarna för målanslutningen väljer du Next.

Schemalägg segmentexport och exempel

När du utför Schemalägg segmentexport måste du manuellt mappa plattformssegment 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 (API) Salesforce Marketing Cloud Mapping ID för att fylla segmentmålgrupper från Experience Platform i detta attribut.

Ett exempelattribut från Salesforce Marketing Cloud visas nedan:

Ett exempel som anger platsen för (API) Salesforce Marketing Cloud Mapping ID visas nedan:

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.

Beroende på ditt sätt att arbeta kan alla aktiverade segment mappas till samma Salesforce Marketing Cloud FIELD NAME eller till olika FIELD NAME in (API) Salesforce Marketing Cloud. 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 segment 1 | salesforce_mc_segment_1 | salesforce_mc_segment_1 | | salesforce mc segment 2 | salesforce_mc_segment_2 | salesforce_mc_segment_2 |

Validera dataexport

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.
   

2. Markera målet och validera att statusen är enabled.
   

3. Växla till Activation data väljer du ett segmentnamn.
   

4. Övervaka segmentsammanfattningen och se till att antalet profiler motsvarar antalet som skapas i segmentet.
   

5. Logga in på Salesforce Marketing Cloud webbplats. Navigera sedan till Audience Builder > Contact Builder > All contacts > Email och kontrollera om profilerna från segmentet har lagts till.
   

6. Navigera till Email och verifiera om attributvärdena för profilen från segmentet har uppdaterats. Om du lyckas ser du att varje segment har statusen Salesforce Marketing Cloud uppdaterades med motsvarande segmentstatus från Platform, baserat på Mapping ID värdet i segmentplanering steg.
   

Dataanvändning och styrning

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

Okända fel påträffades när händelser skickades till Salesforce Marketing Cloud

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

  

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

  • Om du vill åtgärda felet kontaktar du Salesforce Marketing Cloud kontoadministratör att lägga till Experience Platform IP-adresser till Salesforce Marketing Cloud kontots betrodda IP-intervall. Se Salesforce Marketing Cloud IP-adresser som ska inkluderas på Tillåtelselista i Marketing Cloud dokumentation om du behöver ytterligare vägledning.

Ytterligare resurser

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

Changelog

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

Resurser för Business.Adobe.com