執行API觸發的行銷活動 execute

啟動行銷活動後,您需要擷取產生的範例cURL請求,並將其用於API中以建置您的裝載並觸發行銷活動。

必讀 must-read

  • 行銷活動開始/結束日期 — 如果您在建立行銷活動時已設定特定的開始和/或結束日期,則不會在這些日期之外執行,且API呼叫將會失敗。

  • 呼叫逾時 — 對互動式訊息執行REST API的呼叫逾時60秒。 不過,萬一發生未預期的逾時情況,內部會重試以保證傳遞。

觸發行銷活動 trigger

  1. 開啟行銷活動,然後從​ cURL請求 ​區段複製並貼上裝載請求。 此裝載包含訊息中使用的所有個人化(設定檔和內容)變數。 行銷活動上線後,即可使用此功能。

    note important
    IMPORTANT
    cURL區段中的端點在標準和高輸送量行銷活動之間不同。
  2. 將此cURL請求用於API以建置您的裝載並觸發行銷活動。 如需詳細資訊,請參閱互動式訊息執行API檔案,其中列出標準和高輸送量行銷活動的所有端點。

    此頁面上也提供API呼叫範例。

疑難排解 troubleshooting

電子郵件傳遞延遲 delivery-delays

如果電子郵件傳送時間超過預期,請調查外部服務(例如雲端基礎結構提供者或電子郵件服務提供者)的潛在中斷或效能問題。 Journey Optimizer記錄會記錄訊息離開時間戳記,這有助於判斷傳送管道中是否發生延遲情形。

Azure Cosmos DB驗證錯誤(500內部伺服器錯誤) cosmosdb-auth-errors

如果您在觸發API觸發的行銷活動時遇到​500內部伺服器錯誤,且系統記錄顯示來自Azure Cosmos DB的​ 403 Forbidden ​錯誤,其中包含訊息,例如:

「對您帳戶的存取權目前已撤銷,因為Azure Cosmos DB服務無法取得帳戶預設身分的AAD驗證權杖」

此錯誤通常發生於Cosmos DB驗證所需的Azure服務主體已停用、刪除或設定錯誤時。

如何解決此問題
  1. 驗證您的Azure服務主體 — 確定您的Azure服務主體或受管理的身分識別已啟用,而且尚未在Azure Active Directory中停用或刪除。

  2. 檢查許可權 — 確認服務主體具有存取Azure Key Vault和Cosmos DB資源的必要許可權。 服務主體必須具有適當的角色指派,才能使用Azure Cosmos DB進行驗證。

  3. 檢閱Azure Cosmos DB CMK設定 — 如果您使用客戶自控金鑰(CMK),請參閱Azure Cosmos DB CMK疑難排解指南,以取得還原AAD權杖贏取的詳細步驟。

  4. 重新啟用並測試 — 更正設定後,如果服務主體已停用,請重新啟用服務主體,並重新測試您的交易式行銷活動API呼叫,以確認驗證成功且已傳送訊息。

note note
NOTE
此問題通常是由錯誤設定或意外停用Cosmos DB驗證所需的Azure服務主體所導致。 將服務主體保持啟用狀態並正確設定將可防止未來發生此錯誤。
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76