SendGrid anslutning

Översikt

SendGrid är en populär plattform för kundkommunikation för transaktions- och marknadsföringsmejl.

Detta Adobe Experience Platform mål utnyttjar SendGrid Marketing Contacts API, som gör att du kan exportera dina e-postprofiler från första part och aktivera dem i ett nytt SendGrid-segment för dina affärsbehov.

SendGrid använder API-bearer-token som en autentiseringsmekanism för att kommunicera med SendGrid API:t.

Förutsättningar

Följande objekt krävs innan du börjar konfigurera målet.

  1. Du måste ha ett SendGrid-konto.
    • Gå till SendGrid registrering om du vill registrera och skapa ett SendGrid-konto, om du inte redan har ett.
  2. När du har loggat in på SendGrid-portalen måste du också generera en API-token.
  3. Navigera till webbplatsen SendGrid och gå till Settings > API Keys sida. Du kan även läsa Dokumentation för SendGrid för att få tillgång till rätt avsnitt i SendGrid-appen.
  4. Slutligen väljer du Create API Key -knappen.

Innan du aktiverar data till SendGrid-målet måste du ha en schema, a datauppsättningoch segment skapad i Experience Platform. Se även gränser längre ned på denna sida.

VIKTIGT

  • Det SendGrid-API som används för att skapa distributionslistan från e-postprofiler kräver att unika e-postadresser anges i varje profil. Detta är oberoende av om det används som ett värde för e-post eller alternativ e-postadress. Eftersom SendGrid-anslutningen stöder mappningar för både e-postadresser och alternativa e-postadresser måste du se till att alla e-postadresser som används är unika inom varje profil i Datauppsättning. Annars, när e-postprofilerna skickas till SendGrid, resulterar det i ett fel och den e-postprofilen kommer inte att finnas i dataexporten.

  • Det finns för närvarande ingen funktion för att ta bort profiler från SendGrid när de tas bort från segment i Experience Platform.

Identiteter som stöds

SendGrid stöder aktivering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.

Målidentitet Beskrivning Överväganden
e-post E-postadress Observera att både oformaterad text och SHA256-hashade e-postadresser stöds av Adobe Experience Platform. Om källfältet för Experience-plattformen innehåller ohashade attribut ska du kontrollera Apply transformation alternativ, att ha Platform automatiskt hash-koda data vid aktiveringen.

Observera att SendGrid stöder inte hash-kodade e-postadresser, så endast oformaterade textdata utan omformning skickas till målet.

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 önskade schemafält (till exempel: e-postadress, telefonnummer, efternamn), som du har valt på skärmen Välj profilattribut i arbetsflöde för målaktivering.
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.

Användningsfall

För att du bättre ska förstå hur och när du ska använda SendGrid-målet finns det exempel på användningsområden som Experience Platform kunder kan lösa genom att använda den här destinationen.

Skapa en marknadsföringslista för flera marknadsföringsaktiviteter

Marknadsföringsteam som använder SendGrid kan skapa en e-postlista i SendGrid och fylla i den med e-postadresser. Den utskickslista som nu skapas i SendGrid kan sedan användas för flera marknadsföringsaktiviteter.

Anslut till mål

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.

Autentisera till mål

  1. I Adobe Experience Platform konsol, navigera till Destinationer.

  2. Välj Katalog flik och sök efter SendGrid. Välj sedan Konfigurera. När du har upprättat en anslutning till målet ändras gränssnittsetiketten till Aktivera segment.

  3. En guide visas som hjälper dig att konfigurera SendGrid-målet. Skapa det nya målet genom att välja Konfigurera nytt mål.

  4. Välj Nytt konto och fylla i Bearer Token värde. Det här värdet är SendGrid API-nyckel som tidigare omnämns i kravsektion.

  5. Välj Anslut till mål. Om SendGrid API-nyckel om du anger att det är giltigt visas ett Ansluten status med en grön bockmarkering kan du sedan gå vidare till nästa steg för att fylla i ytterligare informationsfält.

Fyll i målinformation

while konfigurera Om du vill ange destinationen måste du ange följande information:

  • Name: Det namn som du känner igen det här målet med i framtiden.
  • Description: En valfri 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.

Se bilden nedan för mer information om det här målet.

  1. Markera ett eller flera segment som ska exporteras till SendGrid.

  2. I Mapping steg, efter markering Add new mapping visas mappningssidan för att mappa XDM-källfälten till API-målfälten för SendGrid. Bilderna nedan visar hur du mappar identitetsnamnutrymmen mellan Experience Platform och SendGrid. Se till att Source field E-post ska mappas till Target field external_id enligt nedan.



  3. Du kan också mappa det önskade Adobe Experience Platform attribut som du vill exportera till SendGrid-målet.

  4. När mappningarna är klara väljer du Next för att gå vidare till granskningsskärmen.

  5. Välj Finish för att slutföra installationen.

Den omfattande listan över attributmappningar som stöds och som kan ställas in för SendGrid Marketing Contacts > Add or Update Contact API är under.

Källfält Målfält Typ Beskrivning Gränser
xdm:
homeAddress.street1		 xdm:
address_line_1		 Sträng Adressens första rad. Maximal längd:
100 tecken
xdm:
homeAddress.street2		 xdm:
address_line_2		 Sträng En valfri andra rad för adressen. Maximal längd:
100 tecken
xdm:
_extconndev.alternate_emails		 xdm:
alternativ_e-post		 Array med strängen Ytterligare e-postmeddelanden som är kopplade till kontakten.
  • Max: 5 objekt
  • Min: 0 objekt
xdm:
homeAddress.city		 xdm:
stad		 Sträng Kontaktens stad. Maximal längd:
60 tecken
xdm:
homeAddress.country		 xdm:
land		 Sträng Kontaktens land. Kan vara ett fullständigt namn eller en förkortning. Maximal längd:
50 tecken
identityMap:
E-post		 Identitet:
external_id		 Sträng Kontaktens primära e-postadress. Detta måste vara en giltig e-postadress. Maximal längd:
254 tecken
xdm:
person.name.firstName		 xdm:
first_name		 Sträng Kontaktens namn Maximal längd:
50 tecken
xdm:
person.name.lastName		 xdm:
last_name		 Sträng Kontaktens familjenamn Maximal längd:
50 tecken
xdm:
homeAddress.mailCode		 xdm:
mail_code		 Sträng Kontaktens postnummer eller annat postnummer.
xdm:
homeAddress.stateProvince		 xdm:
state_Province_region		 Sträng Kontaktens delstat, provins eller region. Maximal längd:
50 tecken

Validera dataexporten i SendGrid

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 kontrollera att antalet profiler motsvarar antalet som skapas i datauppsättningen.

  5. The SendGrid Marketing Lists > Create List API används för att skapa unika kontaktlistor i SendGrid genom att koppla värdet för list_name och tidsstämpeln för dataexporten. Navigera till SendGrid-webbplatsen och kontrollera om den nya kontaktlistan som överensstämmer med namnmönstret skapas.

  6. Markera den nya kontaktlistan och kontrollera om den nya e-postposten från datauppsättningen som du skapade fylls i i den nya kontaktlistan.

  7. Kontrollera också några e-postmeddelanden för att verifiera om fältmappningen är korrekt.

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.

Ytterligare resurser

Detta SendGrid-mål utnyttjar API:erna nedan:

Gränser

På denna sida