SendGrid verbinding
Overzicht overview
SendGrid is een populair platform voor klantcommunicatie voor transactie en marketing e-mails.
Dit Adobe Experience Platform doel gebruikt de SendGrid Marketing Contacts API, zodat u uw e-mailprofielen van de eerste partij kunt exporteren en deze kunt activeren in een nieuw SendGrid-publiek 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.
- Naar SendGrid inschrijving pagina om een SendGrid-account te registreren en te maken, als u er nog geen hebt.
-
Nadat u zich hebt aangemeld bij de portal SendGrid, moet u ook een API-token genereren.
-
Navigeer naar de SendGrid-website en open de Settings > API Keys pagina. U kunt ook verwijzen naar de SendGrid-documentatie om de juiste sectie te openen in de SendGrid-app.
-
Tot slot selecteert u Create API Key knop.
- Zie de SendGrid-documentatie, als u hulp nodig hebt over welke handelingen moeten worden uitgevoerd.
- Als u de API-sleutel programmatisch wilt genereren, raadpleegt u de SendGrid-documentatie.
Voordat u gegevens naar de SendGrid-bestemming kunt activeren, moet u een schema, gegevensset, en segmenten gemaakt in Experience Platform. Verwijs ook naar limieten verderop op 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 ongeacht of het wordt gebruikt als waarde voor email of alternatieve e-mail. Omdat de SendGrid-verbinding toewijzingen ondersteunt voor e-mailwaarden en alternatieve e-mailwaarden, moet u ervoor zorgen dat alle gebruikte e-mailadressen uniek zijn in elk profiel van het Gegevensset. 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. Meer informatie over identiteiten.
Let op: SendGrid Hashed-e-mailadressen worden niet ondersteund, dus alleen onbewerkte tekstgegevens zonder transformatie worden naar de bestemming verzonden.
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 SendGrid zou moeten gebruiken, zijn hier voorbeelden van gebruiksgevallen 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
Als u verbinding wilt maken met dit doel, voert u de stappen uit die in het dialoogvenster zelfstudie over doelconfiguratie. 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, navigeren naar Doelen.
-
Selecteer de Catalogus tabblad en zoeken naar SendGrid. Selecteer vervolgens Instellen. Nadat u een verbinding aan de bestemming hebt gevestigd, verandert het etiket UI in Segmenten activeren.
-
U wordt getoond een tovenaar die u in het vormen van de bestemming SendGrid bijstaat. Maak het nieuwe doel door Nieuwe bestemming configureren.
-
Selecteer de Nieuw account en vult de Dragertoken waarde. Deze waarde is de SendGrid API-sleutel die eerder in het sectie voorwaarden.
-
Selecteren Verbinden met doel. Als de SendGrid API-sleutel u hebt opgegeven, is geldig. Verbonden als u een groen vinkje hebt, gaat u verder naar de volgende stap om extra informatievelden in te vullen.
Doelgegevens invullen destination-details
while opzetten voor deze bestemming moet u de volgende informatie opgeven:
- Name: De naam waarmee u dit doel in de toekomst wilt herkennen.
- 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. Zie de handleiding voor meer informatie over waarschuwingen abonneren op bestemmingen die het alarm gebruiken UI.
Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next.
Soorten publiek naar dit doel activeren activate
- Als u gegevens wilt activeren, hebt u de opdracht View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.
- Om te exporteren identiteiten, hebt u de View Identity Graph toegangsbeheermachtiging.
Lezen Profielen en doelgroepen activeren voor het streamen van doelgroepen voor het exporteren van bestanden voor instructies voor het activeren van het publiek naar 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 Mapping stap, na het selecteren Add new mapping, wordt u getoond de toewijzingspagina om de bronXDM gebieden aan de SendGrid API doelgebieden in kaart te brengen. In de onderstaande afbeeldingen ziet u hoe u naamruimten kunt toewijzen tussen Experience Platform en SendGrid. Zorg ervoor dat Source field E-mail moet worden toegewezen aan de Target field external_id zoals hieronder weergegeven.
-
Wijs op dezelfde manier de gewenste afbeelding toe Adobe Experience Platform attributen die u naar de bestemming wilt uitvoeren SendGrid.
-
Na het voltooien van de toewijzingen selecteert u Next naar het revisiescherm gaan.
-
Selecteren Finish om de installatie te voltooien.
De uitgebreide lijst met ondersteunde kenmerktoewijzingen die kan worden ingesteld voor de SendGrid-marketingcontactpersonen > Contactpersoon-API toevoegen of bijwerken is lager dan.
homeAddress.street1
address_line_1
100 tekens
homeAddress.street2
address_line_2
100 tekens
_extcondev.alternatieve_e-mails
alternatieve_e-mails
- Max. 5 items
- Min.: 0 items
homeAddress.city
stad
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:
-
Selecteren Destinations > Browse om naar de lijst met bestemmingen te navigeren.
-
Selecteer het doel en controleer of de status enabled.
-
Schakel over naar de Activation data en selecteert u vervolgens de naam van een publiek.
-
Controleer de publiekssamenvatting en controleer de telling van profielen aan de telling beantwoordt die binnen de dataset wordt gecreeerd.
-
De SendGrid-marketinglijsten > Create List API wordt gebruikt om unieke contactlijsten binnen SendGrid tot stand te brengen door de waarde van samen te voegen list_name en het tijdstempel van de gegevensexport. 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
Alles Adobe Experience Platform de bestemmingen zijn volgzaam met het beleid van het gegevensgebruik wanneer het behandelen van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform handhaaft gegevensbeheer, zie Overzicht van gegevensbeheer.
Aanvullende bronnen additional-resources
Deze SendGrid-bestemming gebruikt de onderstaande API's:
Limieten limits
- De SendGrid-marketingcontactpersonen > Contactpersoon-API toevoegen of bijwerken kan 30.000 contacten, of 6MB van gegevens goedkeuren, welke lager is.