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

VIKTIGT

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.

Detta Adobe Experience Platform mål utnyttjar Salesforce Marketing Cloud uppdatera kontakter API, som gör att du kan lägga till kontakter/uppdatera kontaktdata för ditt företags behov 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

Nå ut till Salesforce Account Executive prenumerera på Salesforce Marketing Cloud Account Engagement om du inte redan har det.

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:
Datadesigner för användargränssnittet i Salesforce Marketing Cloud.

En vy av Salesforce Marketing Cloud Email Demographics Attributuppsättningen visas nedan:
Salesforce Marketing Cloud UI email demographics attribute-set.

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.

VIKTIGT

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 segmentmålgrupper från Experience Platform i detta attribut.

Ett exempel på hur attribut skapas i Salesforce Marketing Cloudvisas nedan:
Användargränssnittet i Salesforce Marketing Cloud med ett attribut.

TIPS
  • 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 plattformssegment 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 segmentet i Salesforce Marketing Cloud.

Samla Salesforce Marketing Cloud autentiseringsuppgifter

Anteckna vad som står nedan 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.exactarget.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. r23kxxxxxxxx0z05xxxxxx
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. ipxxxxxxxxxxT4xxxxxxxxxx

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.

Målidentitet Beskrivning Överväganden
contactKey Salesforce Marketing Cloud Kontaktnyckel. Se Salesforce Marketing Cloud dokumentation om du behöver ytterligare vägledning. Obligatoriskt

Exportera typ och frekvens

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 segmentstatus från Platform, baserat på Mapping ID det värde som anges under segmentplanering steg.
Exportfrekvens Streaming Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på segmentutvärdering skickar kopplingen uppdateringen nedåt till målplattformen. Läs mer om mål för direktuppspelning.

Anslut till målet

VIKTIGT

Om du vill ansluta till målet behöver du Manage Destinations åtkomstkontrollbehörighet. 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

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.exactarget.com,
du måste ange mcq4jrssqdlyc4lph19nnqgzzs84 som värdet.
Client ID Din Salesforce Marketing Cloud Client ID.
Client Secret Din 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

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

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

VIKTIGT

Om du vill aktivera data måste du ha Manage Destinations, Activate Destinations, View Profiles och View Segments behörigheter för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

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.

VIKTIGT

Även om attributnamnen är som du vill Salesforce Marketing Cloud konto, mappningar för båda contactKey och personalEmail.address är obligatoriska. Vid mappning av attribut är det bara attribut från Experience Platform Email Demographics ska användas i målfälten.

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

      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 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:
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 Schedule-segment.

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.
    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 segmentnamn.
    Skärmbild för användargränssnittet för plattformen visar aktiveringsdata för destinationer.

  4. Övervaka segmentsammanfattningen och se till att antalet profiler motsvarar antalet som skapas i 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 segmentet har lagts till.
    Användargränssnittet i Salesforce Marketing Cloud visar sidan Kontakter med profiler som används i segmentet.

  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.
    Användargränssnittet i Salesforce Marketing Cloud visar den valda e-postkontaktsidan med uppdaterade segmentstatusar.

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.

    Skärmbild för användargränssnittet för plattformen visar ett fel.

    • 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

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

På denna sida