SendGrid個連線
概觀 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中建立結構描述、資料集和區段。 另請參閱此頁面下方的限制區段。
-
用於從電子郵件設定檔建立郵寄清單的SendGrid API要求在每個設定檔中提供唯一的電子郵件地址。 無論其用作 電子郵件 或 備用電子郵件 的值,皆不適用。 由於SendGrid連線支援電子郵件和備用電子郵件值的對應,請確定在 資料集 的每個設定檔中,使用的所有電子郵件地址都應該是唯一的。 否則,將電子郵件設定檔傳送至SendGrid時,將會導致錯誤,且該電子郵件設定檔將不會出現在資料匯出中。
-
目前,從Experience Platform的受眾移除設定檔時,無法從SendGrid移除設定檔。
支援的身分 supported-identities
SendGrid支援如下表所述的身分啟用。 深入瞭解身分。
請注意,SendGrid 不支援雜湊電子郵件地址,所以只會將純文字資料傳送至目的地,而不進行轉換。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
使用案例 use-cases
為了協助您更清楚瞭解您應如何及何時使用SendGrid目的地,以下是Experience Platform客戶可以使用此目的地解決的範例使用案例。
為多個行銷活動建立行銷清單
使用SendGrid的行銷團隊可以在SendGrid內建立郵寄清單,並填入電子郵件地址。 現在於SendGrid內建立的郵寄清單可隨後用於多個行銷活動。
連線到目的地 connect
若要連線到此目的地,請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。
驗證目標 authenticate
-
在Adobe Experience Platform主控台中,導覽至 目的地。
-
選取 目錄 索引標籤並搜尋 SendGrid。 然後選取 設定。 在您建立與目的地的連線後,UI標籤會變更為 啟用區段。
-
系統會顯示精靈,協助您設定SendGrid目的地。 選取 設定新的目的地,以建立新的目的地。
-
選取 新帳戶 選項並填入 持有人權杖 值。 此值是先前在必要條件區段中提及的SendGrid API金鑰。
-
選取 連線到目的地。 如果您提供的SendGrid API金鑰 有效,UI會以綠色勾號顯示 已連線 狀態,然後您可以繼續下一個步驟以填寫其他資訊欄位。
填寫目標詳細資訊 destination-details
在設定此目的地時,您必須提供下列資訊:
- 名稱:您日後識別此目的地所使用的名稱。
- 描述:可協助您日後識別此目的地的可選描述。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱使用UI訂閱目的地警示的指南。
當您完成提供目的地連線的詳細資訊後,請選取 下一步。
啟動此目標的對象 activate
閱讀將設定檔和對象啟用至串流對象匯出目的地,以瞭解啟用此目的地對象的指示。
如需此目的地的特定詳細資訊,請參閱下列影像。
-
選取一或多個要匯出至SendGrid的對象。
-
在 對應 步驟中,選取 新增對應 後,您會看到對應頁面,以將來源XDM欄位對應到SendGrid API目標欄位。 下圖示範如何在Experience Platform和SendGrid之間對應身分識別名稱空間。 請確定 Source欄位 電子郵件 應該對應至 目標欄位 external_id,如下所示。
-
同樣地,對應您要匯出至SendGrid目的地的所需Adobe Experience Platform屬性。
-
完成對應後,選取 下一步 以進入檢閱畫面。
-
選取 完成 以完成設定。
可為SendGrid行銷連絡人>新增或更新連絡人API設定的支援屬性對應完整清單如下。
homeAddress.street1
address_line_1
100個字元
homeAddress.street2
address_line_2
100個字元
_extconndev.alternate_emails
封備用電子郵件
- 最多5個專案
- 最小值:0個專案
homeAddress.city
城市
60個字元
homeAddress.country
國家/地區
50個字元
電子郵件
external_id
254個字元
人員。名稱。名字
first_name
50個字元
person.name.lastName
last_name
50個字元
homeAddress.postalCode
postal_code
homeAddress.stateProvince
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的資料(以較低者為準)。