SendGrid 連線

總覽

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

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

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

先決條件

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

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

啟用資料至SendGrid目的地之前，您必須擁有 綱要， a 資料集、和 區段 建立於 Experience Platform. 另請參閱 限制 區段下方。

重要

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

  • 目前，從Experience Platform的區段移除設定檔時，無法從SendGrid移除設定檔。

支援的身分

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

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

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

匯出型別和頻率

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

項目 類型 附註
匯出型別 以設定檔為基礎 您正在匯出區段的所有成員，以及所需的結構描述欄位（例如：電子郵件地址、電話號碼、姓氏），如<客戶名稱>的「選取設定檔屬性」畫面中所選。 目的地啟用工作流程.
匯出頻率 串流 串流目的地是「一律開啟」的API型連線。 一旦設定檔根據區段評估在Experience Platform中更新，聯結器就會將更新傳送至下游的目標平台。 深入瞭解 串流目的地.

使用案例

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

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

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

連線到目的地

重要

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

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

驗證至目的地

  1. 在內 Adobe Experience Platform 主控台，導覽至 目的地.

  2. 選取 目錄 標籤並搜尋 SendGrid. 然後選取 設定. 建立與目的地的連線後，UI標籤會變更為 啟用區段.

  3. 畫面會顯示協助您設定SendGrid目的地的精靈。 選取以下專案以建立新目的地 設定新目的地.

  4. 選取 新帳戶 選項並填入 持有人權杖 值。 此值是SendGrid API金鑰 先前在 必要條件區段.

  5. 選取 連線到目的地. 如果SendGrid API金鑰 您提供的有效，UI會顯示 已連線 狀態，並顯示綠色核取記號，然後您可以繼續進行下一步以填寫其他資訊欄位。

填寫目的地詳細資料

當 設定 您必須提供下列資訊：

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

啟用警示

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

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

啟用此目的地的區段

重要

若要啟用資料，您需要 管理目的地， 啟用目的地， 檢視設定檔、和 檢視區段 存取控制許可權. 閱讀 存取控制總覽 或聯絡您的產品管理員以取得必要許可權。

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

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

  1. 選取一或多個要匯出至SendGrid的區段。

  2. 在 對應 步驟，選取之後 新增對應，您會看到對應頁面，以將來源XDM欄位對應到SendGrid API目標欄位。 下圖示範如何在Experience Platform和SendGrid之間對應身分識別名稱空間。 請確保 來源欄位 電子郵件 應該對應至 目標欄位 external_id 如下所示。



  3. 同樣地，對應所需的 Adobe Experience Platform 要匯出至SendGrid目的地的屬性。

  4. 完成對應後，選取 下一個 以進入檢閱畫面。

  5. 選取 完成 以完成設定。

完整的支援屬性對應清單，可針對下列專案設定： 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：
city		 字串 連絡人的城市。 最大長度：
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.stateProvince		 xdm：
state_province_region		 字串 連絡人的州、省或地區。 最大長度：
50個字元

驗證SendGrid中的資料匯出

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

  1. 選取 目的地 > 瀏覽 以導覽至目的地清單。

  2. 選取目的地並驗證狀態是否為 已啟用.

  3. 切換至 Activation data 標籤，然後選取區段名稱。

  4. 監視區段摘要，並檢查與資料集中建立的計數對應的設定檔計數。

  5. 此 SendGrid行銷清單>建立清單API 用於在SendGrid中建立唯一的連絡人清單，方法是聯結 list_name 屬性和資料匯出的時間戳記。 導覽至SendGrid網站，並檢查是否建立了符合名稱模式的新連絡人清單。

  6. 選取新建立的連絡人清單，並檢查您建立之資料集中的新電子郵件記錄是否填入新連絡人清單中。

  7. 此外，也請檢查一些電子郵件以驗證欄位對應是否正確。

資料使用與控管

全部 Adobe Experience Platform 處理您的資料時，目的地符合資料使用原則。 如需如何操作的詳細資訊 Adobe Experience Platform 強制執行資料控管，請參閱 資料控管概觀.

其他資源

此SendGrid目的地會利用以下API：

限制

本頁內容