開始使用 Iterable 的 API
要開始使用 Iterable 的 API，第一步就是產生 API 金鑰。此金鑰對於驗證請求和確保安全存取您的 Iterable 帳戶至關重要。
產生 API 金鑰的逐步指南：
登入您的 Iterable 帳戶。
導航到整合部分。
按一下 API 金鑰。
產生新的 API 金鑰，確保您根據您的用例授予適當的權限。
安全地儲存 API 金鑰，因為您的所有 API 請求都需要它。
取得 API 金鑰後，您就可以開始發出請求了。讓我們探討一些常見的用例及其相應的範例有效負載。
常見 API 用例和範例有效負載
1. 新增用戶
若要將新使用者新增至您的 Iterable 項目，請使用/api/users/update端點。此端點可讓您建立或更新使用者數據，確保您的聯絡人清單始終是最新的。
要求：
POST /api/users/update
{
“email”: “[email protected]”,
“dataFields”: {
“firstName”: “John”,
“lastName”: “Doe”,
“signupDate”: “2024-01-01”
},
“preferUserId”: false
}
解釋：
email：使用者的電子郵件地址。
dataFields：包含使用者自訂資料欄位的 JSON 物件。
preferUserId：如果設定為 true，API 將優先使用 userId 而不是電子郵件來識別使用者。
2. 觸發自訂事件
自訂事件對於追蹤使用者操作和觸發自動化工作流程至關重要。使用/api/events/track端點記錄這些事件。
要求：
json
Copy code
POST /api/events/track
{
“email”: “[email protected]”,
“eventName”: “purchase”,
“dataFields”: {
“itemName”: “Smartphone”,
“itemPrice”: 699,
“purchaseDate”: “2024-06-01”
}
}
解釋：
email：與事件關聯的使用者的電子郵件。
eventName：您正在追蹤的事件的名稱。
dataFields：包含與事件相關的附加資料的 JSON 物件。
3. 發送交易電子郵件
交易電子郵件對於根據使用者操作發送個人化訊息至關重要。使用/api/email/target端點傳送這些電子郵件。
要求：
json
Copy code
POST /api/email/target
{
“recipientEmail”: “[email protected]”,
“campaignId”: 12345,
“dataFields”: {
“firstName”: “John”,
“orderNumber”: “987654321”,
“orderTotal”: “$699.00”
}
}
解釋：
recipientEmail：收件者的電子郵件地址。
campaignId：您要傳送的電子郵件行銷活動的 ID。
dataFields：自訂資料 土耳其 電話號碼 欄位以個人化電子郵件內容。
4. 建立列表
管理清單對於細分受眾群體至關重要。使用/api/lists端點建立新清單。
要求：
json
Copy code
POST /api/lists
{
“name”: “VIP Customers”
}
解釋：
name：您要建立的清單的名稱。
5. 將使用者加入清單中
獲得清單後，使用/api/lists/subscribe。
要求：
json
Copy code
POST /api/lists/subscribe
{
“listId”: 67890,
“subscribers”: [
{
“email”: “[email protected]”
},
{
“email”: “[email protected]”
}
]
}
解釋：
listId：您要新增訂閱者的清單的 ID。
subscribers：訂閱者物件數組，每個物件包含一個電子郵件地址。
使用 Iterable API 的最佳實踐
若要充分利用 Iterable 的 API，請考慮以下最佳實務：
速率限制：請注意API 速率限制，以避免達到可能中斷工作流程的閾值。盡可能有效率地批量處理請求。
資料驗證：在發出 API 請求之前確保您的資料經過驗證，以防止錯誤並確保資料完整性。
錯誤處理：在應用程式中實作強大的錯誤處理，以優雅地管理 API 錯誤和重試。
安全性：確保 API 金鑰安全並定期輪調以降低安全風險。
文件：定期查閱 Iterable 的 API 文件以獲取更新和最佳實踐，以隨時了解新功能和改進。
無縫整合以個人化訊息傳遞
Iterable 的 API 是現代行銷自動化 酸鹼度數字 的基石，提供管理資料、觸發事件和精確個人化行銷活動所需的工具。透過利用全面的端點並遵循最佳實踐，您可以充分利用 Iterable 平台的潛力來提供卓越的客戶體驗。無論您是新增使用者、追蹤事件、發送交易電子郵件或管理列表，Iterable 的 API 都能提供靈活性和強大功能，將您的行銷策略提升到新的高度。
立即釋放 Iterable API 的強大功能，以前所未有的方式改變您的客戶參與度 -立即安排簡報。
麥可·塞登
麥可·
