Documentation

Profile stitching fails due to invalid ECID values in Adobe Experience Platform

Last update: Thu Feb 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Profile stitching in Adobe Experience Platform doesn’t occur when the ECID value ingested into a schema-defined identity field fails validation. This causes the Identity Service to skip those records, even if a common identifier exists between profiles. Supplying valid ECID values resolves the issue.

Description description

Environment

Adobe Experience Platform

Issue/Symptoms

  • Profiles that share a common identifier (such as Customer ID) don’t stitch together.
  • Records contain an invalid value (for example, NO_ECID) for the ECID field defined as an identity in the schema.
  • Records with invalid ECID values are skipped during ingestion, resulting in failed profile stitching.

Resolution resolution

Removing an identity designation from a schema field after data ingestion cause breaking changes and should be evaluated carefully before implementation.

Follow these steps to solve the issue:

  1. Review your data ingestion process for the dataset where profile stitching is expected.
  2. Confirm that the ECID value ingested into the schema-defined identity field (_[ field] .identities.ecid) is always present and correctly formatted.
  3. Ensure that all ECID values are exactly 38 numeric characters and don’t contain non-numeric characters or placeholder values such as NO_ECID or any value not corresponding to the required 38 numeric characters.
  4. If ECID is always passed through the identityMap and validation on _[ field] .identities.ecid is not required, remove its identity designation from the schema if possible. Evaluate this change carefully because it can break existing data.
  5. Re-ingest corrected data if necessary.
  6. Verify that profiles with matching identifiers now stitch correctly by checking their merged identities in Adobe Experience Platform.

Notes:

  • The schema remains the source of truth for validation; all identities defined there must be ingested in valid formats.
  • The Identity Service skips any record where an ECID value violates guardrails (length or character set).
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f