DCS エラーコード、メッセージ、例 dcs-error-codes-messages-and-examples

Data Collection Servers(DCS)で生成されるエラーコードおよびメッセージをコード ID 順に説明します。

以下の表で、斜体​の部分には実際の情報が入ります。

システムエラーコード system-error-codes

エラーコード
エラーメッセージ
説明
0
Unspecified error
これは、他のエラーハンドラーでカバーされないイベントを処理する包括的なエラーです。このエラーのトラブルシューティングは困難です。種々の不明なアクションやイベントが原因になっている可能性があります。このエラーが発生した場合は、DCS 要求をもう一度試してください。問題が解決しない場合は、Adobe 担当者にお問い合わせください。
1
ホスト名:hostname の構成が見つかりませんでした。
送信された要求に含まれているホスト名が、アドビのパートナープロビジョニングチームでセットアップされていません。このエラーメッセージが表示された場合は、Adobe 担当者にご連絡ください。
2
Invalid d_orgid value (could not find a config for this org id): ID
組織 ID が正しくありません。ID を確認して、要求をもう一度試してください。組織 ID が不明な場合は、組織 ID の見つけ方について、組織とアカウントのリンクの「管理ページ」を参照してください。
10
特性を評価できません
リクエスト上の特性は、部分的に評価されたか、まったく評価されていません。 問題が解決しない場合は、Adobe 担当者にお問い合わせください。

統合エラーコード integration-error-codes

エラーコード
エラーメッセージ
説明
100
Could not retrieve host name for the request
API 呼び出しで送信された要求にホスト ヘッダーが含まれていませんでした。HTTPホストヘッダーを呼び出しに追加して、もう一度試してください。なお、ほとんどのブラウザーおよび API クライアントでは、これを自動的におこないます。
101
Invalid Experience Cloud id passed in ID
DCS 呼び出しに無効な Experience Cloud ID が含まれています。ヘッダー文字列の d_mid= キー値ペアを確認してください。正しい Experience Cloud ID を渡していることを確認して、要求をもう一度試してください。
102
Invalid AAM ID passed in request ID
DCS 呼び出しに無効な Audience Manager ID が含まれています。ヘッダー文字列の d_uuid= キー値ペアを確認してください。正しい Audience Manager ID を渡していることを確認して、要求をもう一度試してください。
104
All customer IDs are invalid
呼び出しに含まれているすべての顧客 ID が無効です。ID を確認して、もう一度試してください。
109
リファラー HTTP referer はパートナーの Partner ID で使用できます。
呼び出しの HTTP referer ヘッダーは、呼び出しのパートナー ID では使用できません。HTTP referer ヘッダーが正しいことを確認します。
111
Invalid IMS token received
Audience Manager - Adobe Target 統合に対して返されます。エラーがスローされるのは、無効な IMS トークンを含んだ呼び出しが DCS に対しておこなわれた場合です。トークンの形式が正しくないか有効期限が切れている、または要求したリソースにアクセスする権限をユーザーが持っていない可能性があります。

オプトアウトエラーコード opt-out-error-codes

コード ID
メッセージ
説明
171
ID ID のオプトアウトタグが見つかりました
お客様がインタレストベース広告の受信をオプトアウトしました。
172
Blocked cookies
ユーザーのブラウザーがサードパーティ Cookie をブロックしている場合に返されます。
173
Encountered trust relationship via NAI
ユーザーが NAI を通じてオプトアウトプロセスを開始しました。
198
Requests from this country are blocked by partner
DCS では、パートナーがトラフィックを意図的に制限している国からの要求を IP アドレスに基づいてブロックします。
199
Requests from this country are not allowed

DCS では、次の国からの要求を IP アドレスに基づいてブロックします。

  • キューバ(CU)
  • イラン(IR)
  • 北朝鮮(KP)
  • スーダン(SD)
  • シリア(SY)

プロファイル取得エラーコード profile-retrieval-error-codes

コード ID
メッセージ
説明
200
ID ID のプロファイル キャッシュから特性を読み取れません
アドビの社内ストレージからユーザープロファイルを読み取れない場合に返されます。
201
顧客 ID: ID のプロファイル キャッシュからデバイス ID を読み取ることができません
デバイス ID をプロファイルリンク結合ルールのために取得できない場合に返されます。
202
デバイス ID: ID の関連する顧客を読み取れません
デバイス ID に関連付けられている顧客 ID(UUID)を、前回の認証済みプロファイル結合ルールのためにアドビの社内ストレージから取得できない場合に返されます。
203
次の ID のデバイス クラスターを読み取れません:ID
このデバイス ID にリンクされているデバイス ID を同じデバイスグラフクラスターから返せません。
204
Could not perform migration since profile read failed for primary device
このエラーが報告された場合は、アドビのデータストア(PCS)にスケーラビリティの問題が発生している可能性があります。問題が解決しない場合は、アドビの担当者にお問い合わせください。
205
ID のプロファイルの読み取りに失敗したため、ID から ID への移行を実行できませんでした
このエラーが報告された場合は、アドビのデータストア(PCS)にスケーラビリティの問題が発生している可能性があります。問題が解決しない場合は、アドビの担当者にお問い合わせください。

統合警告コード integration-warning-codes

コード ID
メッセージ
説明
300
顧客 ID _ID_ が無効です
顧客 ID が無効です(データソースの値がない、統合コードがない、データソースの形式が無効、顧客 ID がブロックされている、顧客 ID が未指定、パートナーの管理下にないデータソースに不正にアクセスしようとしている、など)。
301
Maximum number of customer ids exceeded.最大許容数は _maximum allowed_ です。 Found is _maximum found_.
クロスデバイス対応データソースに関連付けられている顧客 ID の数が、要求あたりのクロスデバイス ID 数の上限を超えています。このような ID にはクロスデバイス ID、モバイル ID、Cookie ID などがあります。上限は現在 10 に設定されています。
302
未認証の顧客 ID _ID_
顧客 ID データソースが現在の組織 ID に所有されていない場合に返されます。組織 ID がわからない場合や持っていない場合は、検索方法について、「組織とアカウントのリンク ​ の「組織 ID を検索 ​ の節を参照してください。
303
ブロックされた顧客 ID _ID_
顧客 ID が悪意のある ID と見なされてブロックリストに追加されている場合に返されます。
304
ブロックされたデータソース ID _ID_
データソース ID が悪意のある ID と見なされてブロックリストに追加されている場合に返されます
306
ブロックされた宣言デバイス ID _ID_
デバイス ID が悪意のあるものとして識別され、ブロックリストに追加されました。これは、このデバイス ID を含む極端な量の DCS リクエストを短時間で受け取った場合に発生する可能性があります。
307
_ID_ のブロックされたプロファイル操作
ID が悪意のあるIDと見なされてブロックに加えられたため、読み取り/書き込み操作がブロックされました。エラーコード 306 を参照してください。
309
顧客 ID _ID_ は、要求あたりの宣言済み顧客 ID の上限を超えたため、破棄されました
エラー 301 に関係します。このエラーは、上限を超えたため破棄された顧客 ID を示します。

例えば、DCS 呼び出しで宣言された顧客 ID が 12 個の場合、そのうち 2 つは破棄されます。 どの ID が破棄されたかを伝えるために、このエラーは応答に 2 回表示されます(破棄された顧客 ID ごとに 1 回ずつ)。
310
Customer id was discarded because it exceeded the limit for a given namespace. 名前空間 ID は _ID_、顧客 ID は _ID_ です。
このエラーコードは、DCS 呼び出しで同じ名前空間(DPID)に対して宣言された顧客 ID が 3 つ以上ある場合に返されます。

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 リクエストでは、同じ名前空間に対して(統合コード 1 で)宣言された 4 つの ID があります。 これらの ID の 1 つが破棄され、エラー 310 が返されます。
311
Request contains invalid parameters
DCS がこのエラーコードを返すのは、少なくとも 1 つの URL パラメーターが正しくエンコードされていない場合です。その場合、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
Request contains an invalid Global Device ID
リクエストに無効なグローバルデバイス ID が含まれている場合、DCS はこのエラーコードを返します。 DCS は無効な ID を無視し、この無効な 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 である必要があります。 例の要求では ID を小文字で指定しています。
313
CMP ID is not present in GCL
gdpr=1 および IAB TC 文字列が CMP ID によって生成され、評価時点においてその CMP ID が、Audience Manager のグローバル CMP リストのキャッシュバージョンに存在しない場合、IAB TCF 用 Audience Manager プラグインは IAB TC 文字列を破棄し、通常どおりリクエストを処理します。IAB TCF v2.2 ${GDPR} マクロが 0 に設定され、${GDPR_CONSENT_XXX} マクロが空です。
314
CMP ID is marked as deleted in GCL
gdpr=1 と IAB TC 文字列が、キャッシュされたバージョンの Global CMP List で削除済みとマークされた CMP によって生成されると、IAB TCF 用Audience Manager プラグインは TC 文字列を破棄し、評価時間が Global CMP List からの削除時間を過ぎた場合は、通常どおりリクエストを処理します。 IAB TCF v2.2 ${GDPR} マクロが 0 に設定され、${GDPR_CONSENT_XXX} マクロが空です。
315
Consent string indicates no consent
同意が提供されない場合、IAB TCF の Audience Manager プラグインは、それ以上のデータ収集からユーザーをオプトアウトするか、パートナーコンテキストが検出されない場合は呼び出しを完全にドロップします。

サンプルエラーコードメッセージ sample-error-codes

DCS では、エラーコードおよびメッセージを HTTP 応答文字列の JSON オブジェクトまたは X ヘッダーで返します。

サンプル DCS エラーコードおよびメッセージ

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

X-Error

X- ヘッダーで表現されたエラーコード(例えば X-Error: 101,102 など)が URL 文字列に含まれます。

競合状態とエラー処理

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