SendGrid 連線
概觀 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. 另請參閱 限制 一節。
-
用於從電子郵件設定檔建立郵寄清單的SendGrid API要求在每個設定檔中提供唯一的電子郵件地址。 無論其是否作為下列專案的值使用,此皆然 電子郵件 或 備用電子郵件. 由於SendGrid連線支援電子郵件和備用電子郵件值的對應,請確保使用的每個設定檔中的所有電子郵件地址都應該是唯一的 資料集. 否則,將電子郵件設定檔傳送至SendGrid時,將會導致錯誤,且該電子郵件設定檔將不會出現在資料匯出中。
-
目前,從Experience Platform的受眾移除設定檔時,無法從SendGrid移除設定檔。
支援的身分 supported-identities
SendGrid支援如下表所述的身分啟用。 進一步瞭解 身分.
請注意 傳送格線 不支援雜湊電子郵件地址,因此只會將不含轉換的純文字資料傳送至目的地。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
使用案例 use-cases
為協助您更清楚瞭解應該如何以及何時使用SendGrid目的地,以下提供以下範例使用案例, Experience Platform 客戶可以使用此目的地來解析。
為多個行銷活動建立行銷清單
使用SendGrid的行銷團隊可以在SendGrid內建立郵寄清單,並填入電子郵件地址。 現在於SendGrid內建立的郵寄清單可隨後用於多個行銷活動。
連線到目的地 connect
若要連線至此目的地,請遵循以下說明的步驟: 目的地設定教學課程. 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。
驗證目標 authenticate
-
在 Adobe Experience Platform 主控台,導覽至 目的地.
-
選取 目錄 標籤並搜尋 傳送格線. 然後選取 設定. 建立與目的地的連線後,UI標籤會變更為 啟用區段.
-
系統會顯示精靈,協助您設定SendGrid目的地。 透過選取「 」建立新目的地 設定新目的地.
-
選取 新帳戶 並填入 持有人權杖 值。 此值是SendGrid API金鑰 先前在 必要條件區段.
-
選取 連線到目的地. 如果傳送格線 API金鑰 您提供的有效,UI會顯示 已連線 狀態,並顯示綠色核取記號,您就可以繼續進行下一步以填寫其他資訊欄位。
填寫目標詳細資訊 destination-details
當 設定 您必須提供下列資訊給此目的地:
- 名稱:您日後用來辨識此目的地的名稱。
- 說明:此說明選填,可協助您日後識別此目的地。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱以下指南: 使用UI訂閱目的地警報.
當您完成提供目的地連線的詳細資訊時,請選取「 」 下一個.
啟動此目標的對象 activate
讀取 將設定檔和受眾啟用至串流受眾匯出目標 以取得啟用此目的地對象的指示。
如需此目的地的特定詳細資訊,請參閱下列影像。
-
選取一或多個要匯出至SendGrid的對象。
-
在 對應 步驟,選取後 新增對應,您會看到對應頁面,以將來源XDM欄位對應至SendGrid API目標欄位。 下圖示範如何在Experience Platform和SendGrid之間對應身分識別名稱空間。 請確保 來源欄位 電子郵件 應該對應至 目標欄位 external_id 如下所示。
-
同樣地,對應所需的 Adobe Experience Platform 要匯出至SendGrid目的地的屬性。
-
完成對應後,選取 下一個 以進入稽核畫面。
-
選取 完成 以完成設定。
可針對設定的受支援屬性對應的完整清單 SendGrid行銷聯絡人>新增或更新聯絡人API 底下。
homeAddress.street1
address_line_1
100個字元
homeAddress.street2
address_line_2
100個字元
_extconndev.alternate_emails
alternate_email
- 最多5個專案
- 最小值:0個專案
homeAddress.city
城市
60個字元
homeAddress.country
國家/地區
50個字元
電子郵件
external_id
254個字元
person.name.firstName
名字
50個字元
person.name.lastName
last_name
50個字元
homeAddress.postalCode
postal_code
homeAddress.stateProvidle
state_providle_region
50個字元
驗證SendGrid中的資料匯出 validate
若要驗證您是否已正確設定目的地,請遵循下列步驟:
-
選取 目的地 > 瀏覽 以導覽至目的地清單。
-
選取目的地並驗證狀態是否為 已啟用.
-
切換至 Activation data 標籤,然後選取對象名稱。
-
監視對象摘要,並檢查與資料集中建立的計數對應的設定檔計數。
-
此 SendGrid行銷清單>建立清單API 用於在SendGrid中建立唯一的連絡人清單,方法是聯結 list_name 資料匯出的屬性和時間戳記。 導覽至SendGrid網站,並檢查是否建立了符合名稱模式的新連絡人清單。
-
選取新建立的連絡人清單,並檢查您是否將來自您建立之資料集的新電子郵件記錄填入新連絡人清單中。
-
此外,也檢查一些電子郵件以驗證欄位對應是否正確。
資料使用與控管 data-usage-governance
全部 Adobe Experience Platform 處理您的資料時,目的地符合資料使用原則。 如需如何操作的詳細資訊 Adobe Experience Platform 強制執行資料控管,請參閱 資料控管概觀.
其他資源 additional-resources
此SendGrid目的地會利用以下API:
限制 limits
- 此 SendGrid行銷聯絡人>新增或更新聯絡人API 可接受30,000個連絡人,或6MB的資料(以較低者為準)。