SendGrid anslutning

Senaste uppdatering: 2023-11-01
  • Skapat för:
  • Developer
    User
    Admin
    Leader

Översikt

SendGrid är en populär plattform för kundkommunikation för transaktioner och marknadsföring.

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 inom en ny SendGrid-målgrupp 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 som 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 målgrupper 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 de önskade schemafälten (t.ex. 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å målgruppsutvärdering skickar anslutningsprogrammet uppdateringen nedströms 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 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.

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

VIKTIGT

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.

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

  1. Välj en eller flera målgrupper att exportera till SendGrid.

  2. I Mapping steg, efter markering Add new mapping visas mappningssidan som mappar 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 familj 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 målgruppsnamn.

  4. Övervaka målgruppssammanfattningen 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