文件Audience ManagerAudience Manager 使用手冊

DCS錯誤碼、訊息和範例 dcs-error-codes-messages-and-examples

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

Data Collection Servers (DCS)產生的錯誤碼和訊息，依代碼識別碼以數值順序列出。

在下清單格中，斜體 ​代表變數預留位置。

系統錯誤碼 system-error-codes

錯誤碼
錯誤訊息
說明
0
未指定的錯誤
這是一個全包錯誤，會處理其他錯誤處理常式未涵蓋的事件。 疑難排解此錯誤相當困難。 這可能是由於各種未知的動作或事件所造成。 如果您收到此錯誤，請重試您的DCS要求。 如果問題仍然存在，請聯絡您的Adobe代表。
1
找不到主機名稱的設定： hostname
我們的合作夥伴布建團隊尚未設定請求中傳送的主機名稱。 如果您看到此錯誤訊息，請聯絡您的Adobe代表。
2
無效的d_orgid值（找不到此組織ID的設定）： ID
組織ID不正確。 請檢查您的ID，然後再次嘗試請求。 如果您不知道或沒有您的組織ID，請參閱「管理頁面」一節組織和帳戶連結，以瞭解如何找到它。
10
無法評估特徵
要求的特徵已經過部分評估或完全沒有評估。 如果問題仍然存在，請聯絡您的Adobe代表。

整合錯誤代碼 integration-error-codes

錯誤碼
錯誤訊息
說明
100
無法擷取要求的主機名稱
API呼叫未在要求中傳送主機HTTP標頭。 請將主機標頭新增至呼叫，然後再試一次。 大部分的瀏覽器和API使用者端會自動執行此動作。
101
在ID中傳遞的Experience Cloud ID無效
DCS呼叫包含無效的Experience Cloud ID。 檢查標頭字串中的d_mid=機碼值組。 請確定您傳入了正確的Experience Cloud ID，然後再次嘗試該請求。
102
傳入要求ID的AAM ID無效
DCS呼叫包含無效的Audience Manager ID。 檢查標頭字串中的d_uuid=機碼值組。 請確定您傳入了正確的Audience Manager ID，然後再次嘗試該請求。
104
所有客戶ID無效
您呼叫中的所有客戶ID無效。 請檢查您的ID，然後再試一次。
109
不允許協力廠商Partner ID使用反向連結HTTP referer
呼叫中的合作夥伴ID不允許呼叫中的HTTP referer標頭。 檢查HTTP referer標頭是否正確。
111
收到無效的IMS權杖
已傳回Audience Manager - Adobe Target整合。 呼叫DCS時擲回錯誤，其中包含無效的IMS權杖。 權杖可能格式錯誤、已過期或使用者可能無權存取所需的資源。

選擇退出錯誤碼 opt-out-error-codes

代碼ID
訊息
說明
171
發生ID ID的選擇退出標籤
客戶已選擇退出接收以興趣為基礎的廣告。
172
封鎖的Cookie
當使用者的瀏覽器封鎖第三方Cookie時傳回。
173
透過 NAI發現信任關係
使用者已透過NAI啟動選擇退出程式。
198
合作夥伴封鎖來自此國家/地區的請求
根據IP位址， DCS會封鎖來自合作夥伴刻意限制流量的國家/地區的請求。
199
不允許來自這個國家/地區的請求

根據IP位址，個DCS會封鎖來自下列國家/地區的要求：

  • 古巴(CU)
  • 伊朗
  • 北韓(KP)
  • 蘇丹(SD)
  • 敘利亞(SY)

設定檔擷取錯誤代碼 profile-retrieval-error-codes

代碼ID
訊息
說明
200
無法從設定檔快取讀取ID為ID的特徵
當無法從我們的內部儲存裝置讀取使用者設定檔時傳回。
201
無法從設定檔快取中讀取客戶ID的裝置ID： ID
當無法擷取設定檔連結合併規則的裝置識別碼時傳回。
202
無法讀取裝置ID的相關客戶： ID
當無法從我們的內部儲存區為上次驗證的合併規則擷取與裝置ID相關聯的客戶識別碼(UUID)時傳回。
203
無法讀取識別碼： ID的裝置叢集
無法針對此裝置ID傳回來自相同裝置圖表叢集的連結裝置ID。
204
無法執行移轉，因為主要裝置的設定檔讀取失敗
如果您收到此錯誤，我們的資料存放區（部PC）可能會發生擴充性問題。 如果問題仍然存在，請聯絡您的Adobe代表。
205
無法從ID執行移轉至ID，因為ID的設定檔讀取失敗
如果您收到此錯誤，我們的資料存放區（部PC）可能會發生擴充性問題。 如果問題仍然存在，請聯絡您的Adobe代表。

整合警告代碼 integration-warning-codes

代碼ID
訊息
說明
300
無效的客戶ID ID
客戶ID無效（缺少資料來源的值、缺少整合代碼、資料來源的格式無效、已封鎖客戶ID、空白客戶ID、未獲授權存取不屬於合作夥伴的資料來源）。
301
已超出最大客戶ID數。 允許的最大值為maximum allowed。 找到的是maximum found。
與跨裝置資料來源相關聯的客戶ID數量超過每個請求允許的跨裝置ID數量。 這些ID包含跨裝置、行動或Cookie ID。 限制目前設為10。
302
未獲授權的客戶ID ID
當客戶ID資料來源並非目前組織ID所擁有時傳回。 如果您不知道或沒有組織ID，請參閱組織和帳戶連結中的「尋找組織ID」一節，瞭解如何尋找它。
303
封鎖的客戶ID ID
當客戶ID被識別為惡意且已新增至封鎖清單時傳回。
304
封鎖的資料來源識別碼ID
當資料來源ID被識別為惡意且已新增至封鎖清單時傳回
306
封鎖的宣告裝置識別碼ID
已將裝置ID識別為惡意，並已新增至封鎖清單。當我們收到極多的個DCS請求（包含此裝置ID）時，可能會在短時間內發生這種情況。
307
已封鎖ID的設定檔作業
已封鎖讀取/寫入動作，因為ID已被識別為惡意並已新增至封鎖清單請參閱錯誤碼306。
309
已捨棄客戶ID ID，因為它超過每個請求宣告的客戶ID限制

與錯誤301相關。 此錯誤會指定因為超過限制而捨棄哪個客戶ID。

例如，如果在 DCS呼叫上宣告12個客戶ID，將會捨棄其中兩個。 為了轉送哪些客戶已捨棄，此錯誤會在回應中出現兩次（每個捨棄的客戶ID顯示一次）。

310
已捨棄客戶ID，因為它超過指定名稱空間的限制。 名稱空間ID為ID，客戶ID為ID。

如果 DCS呼叫上的相同名稱空間( DPID)宣告3個以上的客戶ID，則會傳回此錯誤碼。

https://partner.demdex.net/event?d_rtbd=json&d_cid_ic=one&d_cid_ic=one&d_cid_ic=one&d_cid_ic=one

在此範例 DCS要求中，有4個識別碼宣告給相同的名稱空間（整合碼為1）。 其中一個ID會遭捨棄，並傳回錯誤310。

311
請求包含無效的引數

至少有一個URL引數未正確編碼時， DCS會傳回此錯誤碼。 在此情況下， DCS會忽略整個要求。

http(s)://partner.demdex.net/event?d_event=imp&d_rtbd=json&d_src=38454&d_site=%esid!&d_creative=%ecid!&d_adgroup=%eaid!&d_placement=%epid!&d_campaign=%ebuy!&d_adsrc=48123

在上述範例要求中， %序列編碼不正確。 因此， DCS將會忽略它。

正確編碼的範例看起來應該像這樣：

http(s)://partner.demdex.net/event?d_event=imp&d_rtbd=json&d_src=38454&d_site=%25esid!&d_creative=%25ecid!&d_adgroup=%25eaid!&d_placement=%25epid!&d_campaign=%25ebuy!&d_adsrc=48123

312
請求包含無效的全域裝置識別碼

當請求包含無效的全域裝置識別碼時，DCS會傳回此錯誤碼。 DCS會忽略無效ID並擲回312錯誤以及無效ID的特定錯誤。 請參閱全域資料來源和Audience Manager中識別碼的索引，以取得正確裝置廣告ID格式與對應全域資料來源的詳細資訊。

不正確呼叫的範例： "http://partner.demdex.net/event?d_rtbd=json&d_cid=20915%01a53cc5a2-6aa1-4210-8ded-a88b29b6212z"

說明： IDFA (DPID 20915)必須是大寫識別碼。 請求中提供的ID為小寫。

313
CMP ID不存在於GCL中
當gdpr=1和IAB TC字串是由評估時Audience Manager快取版本的全域CMP清單中不存在的CMP ID產生時，適用於IAB TCF的Audience Manager外掛程式會捨棄IAB TC字串，並照常處理請求。 IAB TCF v2.2 ${GDPR}巨集設為0，而${GDPR_CONSENT_XXX}巨集是空的。
314
CMP ID在GCL中標籤為已刪除
當gdpr=1和IAB TC字串是由在我們快取版本的「全域CMP清單」中標籤為已刪除的CMP產生時，如果評估時間超過從「全域CMP清單」刪除的時間，適用於IAB TCF的Audience Manager外掛程式會捨棄TC字串並照常處理請求。 IAB TCF v2.2 ${GDPR}巨集設為0，而${GDPR_CONSENT_XXX}巨集是空的。
315
同意字串表示不同意
未提供同意時，適用於IAB TCF的Audience Manager外掛程式會選擇讓使用者退出後續的資料收集，或是在未偵測到合作夥伴內容時完全捨棄呼叫。

錯誤碼訊息範例 sample-error-codes

DCS會在JSON物件或HTTP回應字串的X標頭中傳回錯誤碼和訊息。

DCS錯誤碼和訊息範例

{
   "errors":[
      {
         "code":101,
         "msg":"Invalid Experience Cloud id passed in"
      },
      {
         "code":102,
         "msg":"Invalid aam id passed in request"
      }
   ]
}

X錯誤

X標頭擷取的錯誤碼會顯示在URL字串中，如下所示： X-Error: 101,102。

競爭條件與錯誤處理

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695