SendGrid個連線

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

主題：

建立對象：

undefined
undefined

概觀 overview

SendGrid是交易和行銷電子郵件的熱門客戶通訊平台。

此Adobe Experience Platform 目的地利用SendGrid Marketing Contacts API，可讓您匯出第一方電子郵件設定檔，並在新的SendGrid對象中啟用這些設定檔，以滿足您的業務需求。

SendGrid使用API持有人權杖作為驗證機制，與SendGrid API通訊。

先決條件 prerequisites

開始設定目的地之前，需要下列專案。

您必須有SendGrid帳戶。
- 移至SendGrid 註冊頁面，註冊並建立SendGrid帳戶（如果尚未建立）。
登入SendGrid入口網站後，您還需要產生API權杖。
導覽至SendGrid網站並存取 Settings > API Keys 頁面。或者，請參閱SendGrid檔案以存取SendGrid應用程式中的適當區段。
最後，選取 Create API Key 按鈕。
- 如需執行哪些動作的指引，請參閱SendGrid檔案。
- 如果您想要以程式設計方式產生API金鑰，請參閱SendGrid檔案。

在啟用資料到SendGrid目的地之前，您必須在Experience Platform中建立結構描述、資料集和區段。另請參閱此頁面下方的限制區段。

IMPORTANT

用於從電子郵件設定檔建立郵寄清單的SendGrid API要求在每個設定檔中提供唯一的電子郵件地址。無論其用作 電子郵件 或 備用電子郵件 的值，皆不適用。由於SendGrid連線支援電子郵件和備用電子郵件值的對應，請確定在 資料集 的每個設定檔中，使用的所有電子郵件地址都應該是唯一的。否則，將電子郵件設定檔傳送至SendGrid時，將會導致錯誤，且該電子郵件設定檔將不會出現在資料匯出中。
目前，從Experience Platform的受眾移除設定檔時，無法從SendGrid移除設定檔。

支援的身分 supported-identities

SendGrid支援如下表所述的身分啟用。深入瞭解身分。

目標身分

說明

考量事項

電子郵件

電子郵件地址

請注意，Adobe Experience Platform同時支援純文字和SHA256雜湊電子郵件地址。如果Experience Platform來源欄位包含未雜湊的屬性，請核取 套用轉換 選項，讓Platform在啟用時自動雜湊資料。

請注意，SendGrid 不支援雜湊電子郵件地址，所以只會將純文字資料傳送至目的地，而不進行轉換。

匯出型別和頻率 export-type-frequency

請參閱下表以取得目的地匯出型別和頻率的資訊。

項目

類型

附註

匯出類型

以設定檔為基礎

您正在匯出區段的所有成員，以及所需的結構描述欄位（例如：電子郵件地址、電話號碼、姓氏），如目的地啟用工作流程的選取設定檔屬性畫面中所選。

匯出頻率

串流

串流目的地是「一律開啟」的API型連線。一旦根據對象評估在Experience Platform中更新了設定檔，聯結器就會將更新傳送至下游的目的地平台。深入瞭解串流目的地。

使用案例 use-cases

為了協助您更清楚瞭解您應如何及何時使用SendGrid目的地，以下是Experience Platform客戶可以使用此目的地解決的範例使用案例。

為多個行銷活動建立行銷清單

使用SendGrid的行銷團隊可以在SendGrid內建立郵寄清單，並填入電子郵件地址。現在於SendGrid內建立的郵寄清單可隨後用於多個行銷活動。

連線到目的地 connect

IMPORTANT

若要連線到目的地，您需要 檢視目的地 和 管理目的地 存取控制許可權。閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。在設定目標工作流程中，填寫以下兩個區段中列出的欄位。

驗證目標 authenticate

在Adobe Experience Platform主控台中，導覽至 目的地。
選取目錄索引標籤並搜尋 SendGrid。然後選取設定。在您建立與目的地的連線後，UI標籤會變更為 啟用區段。
系統會顯示精靈，協助您設定SendGrid目的地。選取 設定新的目的地，以建立新的目的地。
選取 新帳戶 選項並填入 持有人權杖 值。此值是先前在必要條件區段中提及的SendGrid API金鑰。
選取 連線到目的地。如果您提供的SendGrid API金鑰 有效，UI會以綠色勾號顯示 已連線 狀態，然後您可以繼續下一個步驟以填寫其他資訊欄位。

填寫目標詳細資訊 destination-details

在設定此目的地時，您必須提供下列資訊：

名稱：您日後識別此目的地所使用的名稱。
描述：可協助您日後識別此目的地的可選描述。

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。從清單中選取警報以訂閱接收有關資料流狀態的通知。如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。

當您完成提供目的地連線的詳細資訊後，請選取 下一步。

啟動此目標的對象 activate

IMPORTANT

若要啟用資料，您需要 檢視目的地、啟用目的地、檢視設定檔 和 檢視區段 存取控制許可權。閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
若要匯出身分，您需要 檢視身分圖表 存取控制許可權。
{width="100" modal="regular"}

閱讀將設定檔和對象啟用至串流對象匯出目的地，以瞭解啟用此目的地對象的指示。

如需此目的地的特定詳細資訊，請參閱下列影像。

選取一或多個要匯出至SendGrid的對象。
在對應步驟中，選取 新增對應 後，您會看到對應頁面，以將來源XDM欄位對應到SendGrid API目標欄位。下圖示範如何在Experience Platform和SendGrid之間對應身分識別名稱空間。請確定 Source欄位 電子郵件 應該對應至 目標欄位 external_id，如下所示。
同樣地，對應您要匯出至SendGrid目的地的所需Adobe Experience Platform屬性。
完成對應後，選取 下一步 以進入檢閱畫面。
選取完成以完成設定。

可為SendGrid行銷連絡人>新增或更新連絡人API設定的支援屬性對應完整清單如下。

來源欄位

目標欄位

類型

說明

限制

xdm：
homeAddress.street1

xdm：
address_line_1

字串

地址的第一行。

最大長度：
100個字元

xdm：
homeAddress.street2

xdm：
address_line_2

字串

位址的選擇性第二行。

最大長度：
100個字元

xdm：
_extconndev.alternate_emails

xdm：
封備用電子郵件

字串陣列

和聯絡人相關聯的其他電子郵件。

最多5個專案
最小值：0個專案

xdm：
homeAddress.city

xdm：
城市

字串

連絡人的城市。

最大長度：
60個字元

xdm：
homeAddress.country

xdm：
國家/地區

字串

連絡人的國家/地區。可以是全名或縮寫。

最大長度：
50個字元

identityMap：
電子郵件

身分：
external_id

字串

連絡人的主要電子郵件。這必須是有效的電子郵件。

最大長度：
254個字元

xdm：
人員。名稱。名字

xdm：
first_name

字串

連絡人姓名

最大長度：
50個字元

xdm：
person.name.lastName

xdm：
last_name

字串

連絡人的姓氏

最大長度：
50個字元

xdm：
homeAddress.postalCode

xdm：
postal_code

字串

連絡人的郵遞區號或其他郵遞區號。

xdm：
homeAddress.stateProvince

xdm：
state_providle_region

字串

連絡人的州、省或地區。

最大長度：
50個字元

驗證SendGrid中的資料匯出 validate

若要驗證您是否已正確設定目的地，請遵循下列步驟：

選取 目的地 > 瀏覽以瀏覽目的地清單。
選取目的地並驗證狀態為 已啟用。
切換至 Activation data 標籤，然後選取對象名稱。
監視對象摘要，並檢查與資料集中建立的計數對應的設定檔計數。
SendGrid行銷清單>建立清單API是用來在SendGrid中建立唯一的連絡人清單，方法是加入 list_name 屬性的值和資料匯出的時間戳記。導覽至SendGrid網站，並檢查是否建立了符合名稱模式的新連絡人清單。
選取新建立的連絡人清單，並檢查您是否將來自您建立之資料集的新電子郵件記錄填入新連絡人清單中。
此外，也檢查一些電子郵件以驗證欄位對應是否正確。