執行API觸發的行銷活動 execute

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

必讀 must-read

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

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

觸發行銷活動 trigger

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

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

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

疑難排解 troubleshooting

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