DocumentatieExperience PlatformHandleiding voor bestemmingen

SendGrid verbinding

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Gebruiker

Overzicht overview

SendGridis een populair platform van de klantenmededeling voor transactie en marketing e-mails.

Dit Adobe Experience Platform bestemmingshefboomwerkingen SendGrid Marketing Contacts API, die u toestaat om uw eerste-partij e-mailprofielen uit te voeren en hen binnen een nieuw publiek te activeren SendGrid voor uw bedrijfsbehoeften.

SendGrid gebruikt API dragertokens als authentificatiemechanisme om met SendGrid API te communiceren.

Vereisten prerequisites

De volgende punten worden vereist alvorens u begint de bestemming te vormen.

  1. U moet een SendGrid-account hebben.

    • Ga naar SendGrid signalerenpagina om een rekening te registreren SendGrid tot stand te brengen, als u niet reeds hebt.

  2. Nadat u zich hebt aangemeld bij de portal SendGrid, moet u ook een API-token genereren.

  3. Ga naar de SendGrid-website en open de pagina Settings > API Keys . Alternatief, verwijs naar de documentatie SendGridom tot de aangewezen sectie in SendGrid toegang te hebben app.

  4. Selecteer ten slotte de knop Create API Key .

    • Verwijs naar de documentatie SendGrid, als u begeleiding op nodig hebt welke acties uit te voeren.
    • Als u uw API Sleutel programmatically zou willen produceren, gelieve te verwijzen naar de documentatie SendGrid.

Alvorens gegevens aan de bestemming te activeren SendGrid, moet u a schema, a dataset, en segmentenhebben die in Experience Platform worden gecreeerd. Verwijs ook naar de grenzensectie verder hieronder op deze pagina.

IMPORTANT

  • Voor de SendGrid-API die wordt gebruikt voor het maken van de mailinglijst vanuit e-mailprofielen, moeten binnen elk profiel unieke e-mailadressen worden opgegeven. Dit is ongeacht of het als waarde voor e-mail of afwisselende e-mail wordt gebruikt. Omdat de verbinding SendGrid afbeeldingen voor zowel e-mail als afwisselende e-mailwaarden steunt, gelieve ervoor te zorgen dat alle gebruikte e-mailadressen binnen elk profiel van de Dataset uniek zouden moeten zijn. Als de e-mailprofielen naar SendGrid worden verzonden, resulteert dit in een fout en is dat e-mailprofiel niet aanwezig in de gegevensexport.

  • Er is momenteel geen functionaliteit beschikbaar om profielen uit SendGrid te verwijderen wanneer ze uit het publiek in het Experience Platform worden verwijderd.

Ondersteunde identiteiten supported-identities

SendGrid ondersteunt de activering van identiteiten die in de onderstaande tabel worden beschreven. Leer meer over identiteiten.

Doelidentiteit
Beschrijving
Overwegingen
email
E-mailadres
Onbewerkte tekst en gehashte e-mailadressen van SHA256 worden ondersteund door Adobe Experience Platform . Als het bronveld van het Experience-platform hashed-kenmerken bevat, schakelt u de optie Apply transformation in om Platform de gegevens automatisch te laten hashen bij activering.

Merk op dat SendGrid geen gehakt e-mailadressen steunt, zodat slechts worden de gewone tekstgegevens zonder transformatie verzonden naar de bestemming.

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
U exporteert alle leden van een segment, samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam), zoals gekozen in het scherm van de uitgezochte profielkenmerken van het werkschema van de bestemmingsactivering.
Exportfrequentie
Streaming
Streaming doelen zijn "altijd aan" API-verbindingen. Zodra een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over het stromen bestemmingen.

Gebruiksscenario’s use-cases

Om u beter te helpen begrijpen hoe en wanneer u de bestemming zou moeten gebruiken SendGrid, zijn hier de gevallen van het steekproefgebruik die Experience Platform klanten kunnen oplossen door deze bestemming te gebruiken.

Een marketinglijst maken voor meerdere marketingactiviteiten

Marketing teams die SendGrid gebruiken, kunnen een mailinglijst maken in SendGrid en deze vullen met e-mailadressen. De mailinglijst die nu in SendGrid wordt gemaakt, kan vervolgens voor meerdere marketingactiviteiten worden gebruikt.

Verbinden met doel connect

IMPORTANT
Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het leerprogramma van de bestemmingsconfiguratieworden beschreven. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Verifiëren voor bestemming authenticate

  1. Binnen de Adobe Experience Platform console, navigeer aan Doelen.

  2. Selecteer het lusje van de Catalogus en onderzoek naar SendGrid. Dan selecteer Opstelling. Nadat u een verbinding aan de bestemming hebt gevestigd, verandert het etiket UI in Activate Segmenten.

  3. U wordt getoond een tovenaar die u in het vormen van de bestemming SendGrid bijstaat. Creeer de nieuwe bestemming door te selecteren vorm nieuwe bestemming.

  4. Selecteer de Nieuwe optie van de Rekening en vul de Symbolische waarde van de Token van de Drager in. Deze waarde is SendGrid API Sleutel eerder vermeld in de eerste vereisten sectie.

  5. Selecteer verbinden met bestemming. Als SendGrid API Sleutel u verstrekt geldig is, toont UI a Verbonden status met een groen vinkje, kunt u aan de volgende stap dan te werk gaan om extra informatiegebieden in te vullen.

Doelgegevens invullen destination-details

Terwijl vestigingdeze bestemming, u de volgende informatie moet verstrekken:

  • Name: De naam waarmee u dit doel in de toekomst herkent.
  • Description: Een optionele beschrijving waarmee u deze bestemming in de toekomst kunt identificeren.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij het intekenen aan bestemmingsalarm gebruikend UI.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren activate

IMPORTANT

Lees activeer profielen en publiek aan het stromen publiek uitvoerbestemmingenvoor instructies bij het activeren van publiek aan deze bestemming.

Raadpleeg de onderstaande afbeeldingen voor meer informatie over deze bestemming.

  1. Selecteer een of meer soorten publiek dat u wilt exporteren naar SendGrid.

  2. In de stap Mapping wordt na het selecteren van Add new mapping de toewijzingspagina weergegeven om de XDM-bronvelden toe te wijzen aan de SendGrid API-doelvelden. In de onderstaande afbeeldingen ziet u hoe u naamruimten kunt toewijzen tussen Experience Platform en SendGrid. Gelieve te verzekeren Source field E-mail aan Target field external_id zoals hieronder getoond zou moeten worden in kaart gebracht.



  3. Wijs op dezelfde manier de gewenste Adobe Experience Platform attributen toe die u naar de bestemming wilt uitvoeren SendGrid.

  4. Nadat u de toewijzingen hebt voltooid, selecteert u Next om naar het revisiescherm te gaan.

  5. Selecteer Finish om de installatie te voltooien.

De uitvoerige lijst van gesteunde attributenafbeeldingen die opstelling voor SendGrid Marketing Contacten > toevoegen of Update Contact APIkan zijn is hieronder.

Source-veld
Doelveld
Type
Beschrijving
Limieten
xdm:
homeAddress.street1
xdm:
address_line_1
String
De eerste regel van het adres.
Max. lengte:
100 tekens
xdm:
homeAddress.street2
xdm:
address_line_2
String
Een optionele tweede regel voor het adres.
Max. lengte:
100 tekens
xdm:
_extcondev.alternate_e-mails
xdm:
alternate_emails
Array van tekenreeks
Extra e-mailberichten die aan de contactpersoon zijn gekoppeld.
  • Max. 5 items
  • Min.: 0 items
xdm:
homeAddress.city
xdm:
city
String
De stad van de contactpersoon.
Max. lengte:
60 tekens
xdm:
homeAddress.country
xdm:
land
String
Het land van de contactpersoon. Kan een volledige naam of een afkorting zijn.
Max. lengte:
50 tekens
identityMap:
Email
Identiteit:
external_id
String
Het primaire e-mailadres van de contactpersoon. Dit is een geldige e-mail.
Max. lengte:
254 tekens
xdm:
person.name.firstName
xdm:
first_name
String
De naam van de contactpersoon
Max. lengte:
50 tekens
xdm:
person.name.lastName
xdm:
last_name
String
De familienaam van de contactpersoon
Max. lengte:
50 tekens
xdm:
homeAddress.postalCode
xdm:
postal_code
String
De postcode of andere postcode van de contactpersoon.
xdm:
homeAddress.stateProvince
xdm:
state_Province_region
String
De staat, provincie of regio van de contactpersoon.
Max. lengte:
50 tekens

De gegevensexport valideren in SendGrid validate

Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:

  1. Selecteer Destinations > Browse om naar de lijst met doelen te navigeren.

  2. Selecteer het doel en bevestig dat de status enabled is.

  3. Ga naar het tabblad Activation data en selecteer vervolgens een publieksnaam.

  4. Controleer de publiekssamenvatting en controleer de telling van profielen aan de telling beantwoordt die binnen de dataset wordt gecreeerd.

  5. De SendGrid Marketing Lists > creëren Lijst APIwordt gebruikt om unieke contactlijsten binnen SendGrid tot stand te brengen door tot de waarde van het list_name attribuut en timestamp van de gegevensuitvoer toe te treden. Navigeer naar de SendGrid-site en controleer of de nieuwe lijst met contactpersonen die overeenkomen met het naampatroon is gemaakt.

  6. Selecteer de zojuist gemaakte lijst met contactpersonen en controleer of de nieuwe e-mailrecord in de gegevensset die u hebt gemaakt, wordt ingevuld in de nieuwe lijst met contactpersonen.

  7. Controleer bovendien een aantal e-mailberichten om te controleren of de veldtoewijzing juist is.

Gegevensgebruik en -beheer data-usage-governance

Alle Adobe Experience Platform -doelen zijn compatibel met het beleid voor gegevensgebruik bij het verwerken van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform gegevensbeheer afdwingt, zie het overzicht van het Beleid van Gegevens.

Aanvullende bronnen additional-resources

Deze SendGrid-bestemming gebruikt de onderstaande API's:

Limieten limits

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6