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

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

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

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

エラーコード
エラーメッセージ
説明
0
Unspecified error
これは、他のエラーハンドラーでカバーされないイベントを処理する包括的なエラーです。このエラーのトラブルシューティングは困難です。種々の不明なアクションやイベントが原因になっている可能性があります。このエラーが発生した場合は、DCS 要求をもう一度試してください。問題が解決しない場合は、Adobe 担当者にお問い合わせください。
1
Could not find config for hostname: 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
Encountered opt out tag for 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
Cannot read traits from profile cache for id: ID
アドビの社内ストレージからユーザープロファイルを読み取れない場合に返されます。
201
Cannot read device ids from profile cache for customer id: ID
デバイス ID をプロファイルリンク結合ルールのために取得できない場合に返されます。
202
Cannot read related customer for device id: ID
デバイス ID に関連付けられている顧客 ID(UUID)を、前回の認証済みプロファイル結合ルールのためにアドビの社内ストレージから取得できない場合に返されます。
203
Cannot read device cluster for id: ID
このデバイス ID にリンクされているデバイス ID を同じデバイスグラフクラスターから返せません。
204
Could not perform migration since profile read failed for primary device
このエラーが報告された場合は、アドビのデータストア(PCS)にスケーラビリティの問題が発生している可能性があります。問題が解決しない場合は、アドビの担当者にお問い合わせください。
205
Could not perform migration fromID to ID, because profile read failed for ID
このエラーが報告された場合は、アドビのデータストア(PCS)にスケーラビリティの問題が発生している可能性があります。問題が解決しない場合は、アドビの担当者にお問い合わせください。

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

コード ID
メッセージ
説明
300
Invalid customer id ID
顧客 ID が無効です(データソースの値がない、統合コードがない、データソースの形式が無効、顧客 ID がブロックされている、顧客 ID が未指定、パートナーの管理下にないデータソースに不正にアクセスしようとしている、など)。
301
Maximum number of customer ids exceeded.Maximum allowed ismaximum allowed. Found is maximum found.
クロスデバイス対応データソースに関連付けられている顧客 ID の数が、要求あたりのクロスデバイス ID 数の上限を超えています。このような ID にはクロスデバイス ID、モバイル ID、Cookie ID などがあります。上限は現在 10 に設定されています。
302
Unauthorized customer id ID
顧客 ID データソースが現在の組織 ID に所有されていない場合に返されます。組織 ID が不明な場合は、組織 ID の見つけ方について、組織とアカウントのリンクの「組織 ID を見つける」を参照してください。
303
Blocked customer id ID
顧客 ID が悪意のある ID と見なされてブロックリストに追加されている場合に返されます。
304
Blocked datasource id ID
データソース ID が悪意のある ID と見なされてブロックリストに追加されている場合に返されます
306
Blocked declared device id ID
デバイス ID が悪意のあるもの見なされ、ブロックリストに加えられました。この問題は、このデバイス ID を含む DCS 要求を短期間で大量に受信した場合に発生する可能性があります。
307
Blocked profile operation for ID
ID が悪意のあるIDと見なされてブロックに加えられたため、読み取り/書き込み操作がブロックされました。エラーコード 306 を参照してください。
309
Customer idID was discarded because it exceeded the limit of declared customer ids per request

エラー 301 に関係します。このエラーは、上限を超えたため破棄された顧客 ID を示します。

例えば、12 個の顧客 ID が DCS 呼び出しで宣言された場合は、そのうちの 2 個が破棄されます。どの ID が破棄されたかを伝えるために、このエラーは応答に 2 回表示されます(破棄された顧客 ID ごとに 1 回ずつ)。

310
Customer id was discarded because it exceeded the limit for a given namespace.Namespace id isID, customer id is ID.

このエラーコードが返されるのは、1 回の DPIDDCS 呼び出しで同じ名前空間()に 4 個以上の顧客 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 要求では、同じ名前空間に(統合コード one で)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

DCS がこのエラーコードを返すのは、要求に無効なグローバルデバイス ID が含まれている場合です。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 TCF 文字列が CMP によって生成され、その CMP がグローバル CMP リストのキャッシュバージョンで削除とマークされている場合、評価時間がグローバル CMP リストの削除時間を経過すると、IAB TC 用 Audience Manager プラグインは TC 文字列を破棄し、通常どおりリクエストを処理します。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