SendGrid 連線

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

undefined
undefined

概觀 overview

傳送格線是異動和行銷電子郵件的熱門客戶通訊平台。

這個 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目的地之前，您必須擁有綱要， a 資料集、和區段建立於 Experience Platform. 另請參閱限制一節。

IMPORTANT

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

支援的身分 supported-identities

SendGrid支援如下表所述的身分啟用。進一步瞭解身分.

目標身分

說明

考量事項

電子郵件

電子郵件地址

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

請注意 傳送格線 不支援雜湊電子郵件地址，因此只會將不含轉換的純文字資料傳送至目的地。

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

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

項目

類型

附註

匯出型別

以設定檔為基礎

您正在匯出區段的所有成員，以及所需的結構描述欄位（例如：電子郵件地址、電話號碼、姓氏），如目的地啟用工作流程.

匯出頻率

串流

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

使用案例 use-cases

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

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

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

連線到目的地 connect

IMPORTANT

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

若要連線至此目的地，請遵循以下說明的步驟：目的地設定教學課程. 在設定目標工作流程中，填寫以下兩個區段中列出的欄位。

驗證目標 authenticate

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

填寫目標詳細資訊 destination-details

當設定您必須提供下列資訊給此目的地：

名稱：您日後用來辨識此目的地的名稱。
說明：此說明選填，可協助您日後識別此目的地。

啟用警示 enable-alerts

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

當您完成提供目的地連線的詳細資訊時，請選取「」 下一個.

啟動此目標的對象 activate

IMPORTANT

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

讀取將設定檔和受眾啟用至串流受眾匯出目標以取得啟用此目的地對象的指示。

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

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

可針對設定的受支援屬性對應的完整清單 SendGrid行銷聯絡人>新增或更新聯絡人API 底下。

來源欄位

目標欄位

類型

說明

限制

xdm：
homeAddress.street1

xdm：
address_line_1

字串

地址的第一行。

最大長度：
100個字元

xdm：
homeAddress.street2

xdm：
address_line_2

字串

位址的選擇性第二行。

最大長度：
100個字元

xdm：
_extconndev.alternate_emails

xdm：
alternate_email

字串陣列

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

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

xdm：
homeAddress.city

xdm：
城市

字串

連絡人的城市。

最大長度：
60個字元

xdm：
homeAddress.country

xdm：
國家/地區

字串

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

最大長度：
50個字元

identityMap：
電子郵件

身分：
external_id

字串

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

最大長度：
254個字元

xdm：
person.name.firstName

xdm：
名字

字串

連絡人姓名

最大長度：
50個字元

xdm：
person.name.lastName

xdm：
last_name

字串

連絡人的姓氏

最大長度：
50個字元

xdm：
homeAddress.postalCode

xdm：
postal_code

字串

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

xdm：
homeAddress.stateProvidle

xdm：
state_providle_region

字串

連絡人的州、省或地區。

最大長度：
50個字元

驗證SendGrid中的資料匯出 validate

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

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