SendGrid-verbinding
Overzicht overview
SendGrid is een populair platform van de klantenmededeling voor transactie en marketing e-mails.
Dit Adobe Experience Platform doel hefboomwerkingen SendGrid Marketing Contacts API 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.
-
U moet een SendGrid-account hebben.
- Ga naar SendGrid signaleren pagina om een rekening te registreren SendGrid tot stand te brengen, als u niet reeds hebt.
-
Nadat u zich hebt aangemeld bij de portal SendGrid, moet u ook een API-token genereren.
-
Ga naar de SendGrid-website en open de pagina Settings > API Keys . Alternatief, zie de documentatie SendGrid om tot de aangewezen sectie in SendGrid toegang te hebben app.
-
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, zie de documentatie SendGrid .
Alvorens gegevens aan de bestemming te activeren SendGrid, moet u a schema , a dataset , en segmenten hebben die in Experience Platform worden gecreeerd. Verwijs ook naar de grenzen sectie verder hieronder op deze pagina.
-
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, zorg ervoor 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 om profielen uit SendGrid te verwijderen wanneer ze uit het publiek in 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 .
Merk op dat SendGrid geen gehakt e-mailadressen steunt, zodat slechts worden de gewone tekstgegevens zonder transformatie verzonden naar de bestemming.
Ondersteunde doelgroepen supported-audiences
In deze sectie wordt beschreven welke soorten publiek u naar dit doel kunt exporteren.
Deze categorie omvat alle oorsprong van het publiek buiten het publiek dat via Segmentation Service wordt gegenereerd. Lees over de diverse publieksoorsprong . Voorbeelden zijn:
- de douane uploadt publiek ingevoerde in Experience Platform van Csv- dossiers,
- gelijksoortige doelgroepen,
- federaal publiek,
- publiek dat wordt gegenereerd in andere Experience Platform-toepassingen, zoals Adobe Journey Optimizer ,
- en meer.
Ondersteund publiek per type publieksgegevens:
Type en frequentie exporteren export-type-frequency
Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.
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 create-marketing-list
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
Om met deze bestemming te verbinden, volg de stappen die in het leerprogramma van de bestemmingsconfiguratie worden beschreven. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.
Verifiëren voor bestemming authenticate
-
Binnen de Adobe Experience Platform console, navigeer aan Doelen.
-
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.
-
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.
-
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 .
-
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 vestiging deze 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
- Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingen nodig. Lees het overzicht van de toegangscontrole of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
- Om identiteiten uit te voeren, hebt u de View Identity Graph toegangsbeheertoestemming nodig.
Lees activeer profielen en publiek aan het stromen publiek uitvoerbestemmingen voor instructies bij het activeren van publiek aan deze bestemming.
Raadpleeg de onderstaande afbeeldingen voor meer informatie over deze bestemming.
-
Selecteer een of meer soorten publiek dat u wilt exporteren naar SendGrid.
-
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. Verzeker Source field E-mail zou aan Target field external_id zoals hieronder getoond moeten worden in kaart gebracht.
-
Wijs op dezelfde manier de gewenste Adobe Experience Platform attributen toe die u naar de bestemming wilt uitvoeren SendGrid.
-
Nadat u de toewijzingen hebt voltooid, selecteert u Next om naar het revisiescherm te gaan.
-
Selecteer Finish om de installatie te voltooien.
De uitvoerige lijst van gesteunde attributenafbeeldingen die opstelling voor SendGrid Marketing Contacten > toevoegen of Update Contact API kan zijn is hieronder.
homeAddress.street1
address_line_1
100 tekens
homeAddress.street2
address_line_2
100 tekens
_extcondev.alternate_e-mails
alternate_emails
- Max. 5 items
- Min.: 0 items
homeAddress.city
city
60 tekens
homeAddress.country
land
50 tekens
external_id
254 tekens
person.name.firstName
first_name
50 tekens
person.name.lastName
last_name
50 tekens
homeAddress.postalCode
postal_code
homeAddress.stateProvince
state_Province_region
50 tekens
De gegevensexport valideren in SendGrid validate
Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:
-
Selecteer Destinations > Browse om naar de lijst met doelen te navigeren.
-
Selecteer het doel en bevestig dat de status enabled is.
-
Ga naar het tabblad Activation data en selecteer vervolgens een publieksnaam.
-
Controleer de publiekssamenvatting en controleer de telling van profielen aan de telling beantwoordt die binnen de dataset wordt gecreeerd.
-
De SendGrid Marketing Lists > creëren Lijst API leidt tot unieke contactlijsten binnen SendGrid 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.
-
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.
-
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
- De SendGrid Marketing Contacten > voegen toe of werken contact API kan 30.000 contacten, of 6MB van gegevens goedkeuren, welke lager is.