Adobe Target Single Profile Update API
Adobe Target Single Profile Update API可讓您傳送單一使用者的設定檔更新。 Single Profile Update API幾乎與Bulk Profile Update API相同,但一次會更新一個訪客設定檔,內嵌於API呼叫而非.cvs檔案。
Single Profile Update API和通常用於必須發生與尚未實作Target的管道中發生的交易相關的更新時。 例如,您想要更新執行某些離線動作之單一訪客的設定檔。 動作包括聯絡客服中心、提供貸款、在商店中使用忠誠卡、存取資訊站等。
Single Profile Update API的優點包括:
- 設定檔屬性的數量不限。
- 透過網站傳送的設定檔屬性可以透過API更新,反之亦然。
注意事項
-
Single Profile Update API受限於在任何連續24小時的期間內執行100萬項更新。
-
更新通常在一小時內發生,但可能需要長達24小時的時間才會反映。
如果您必須傳送更多更新,或需要在較短的時間範圍內處理更新,請考慮透過使用者端更新(偏好設定)或透過Adobe Target伺服器端傳送API傳送異動設定檔更新。
-
Single Profile Update API是伺服器對伺服器的API,並非設計成可在網頁內運作。 若要從您的網頁更新訪客設定檔,您可以使用trackEvent()函式或傳送API。
格式
指定設定檔引數,格式為profile.paramName=value
。
若要更新pcId
的設定檔,請使用:
\ https\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01\_00\&profile.attr=0\&profile.attr2=1…\
若要更新mbox3rdPartyId
的設定檔,請使用:
\ shell http\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456\&profile.attr=0\&profile.attr2=1…\
Single Profile Update API僅供更新。 如果未找到任何專案,則不會建立設定檔。
附註
- 引數和值必須使用UTF-8進行URL編碼。
- 引數格式為
profile.paramName
。 - 並非所有pcIds和mbox3rdPartyIds都必須存在所有引數值。
- 引數和值區分大小寫。
- 同時支援GET和POST。
- 目前的大小限製為:GET為8 KB,POST為60 KB。
回應
上述請求的範例回應如下所示:
trueRequest successfully submitted
此回應表示回應已提交且很快將進行處理。