> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Map the Catalogue for Customer Data

You can only map a source that has moved to the **Integrated** state. Hence, once a source is in the **Integrated** state, perform the following steps to map the catalogue:

<Steps>
  <Step>
    Click the three dots next to the source in the Integrated state and choose **Map to Catalogue** from the drop-down menu, or select the source, go to the **[PREVIEW DATA](/articles/integrate-customer/knowing-the-fields-on-the-preview-data-tab)** tab or the **CATALOGUE MAPPING** tab, and then click **MAP TO CATALOGUE**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/VC7TCWdAQcEWP1YP/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-4.png?fit=max&auto=format&n=VC7TCWdAQcEWP1YP&q=85&s=862bd0e7e98ad5ca19a986c6f2ab9e3d" alt="" width="3016" height="1770" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-4.png" />
    </Frame>
  </Step>

  <Step>
    Map the country and add [Country Enrichers](/articles/unify-customer/enrichers-for-data-transformation-2816770049#country-enricher) - For every source, except native streaming sources (like Web JavaScript, Pixel, Android and iOS SDK sources) where Zeotap is collecting data wherein the country is mapped internally, it is mandatory that a Country is provided. If the country is not part of your incoming source data then you can use our [Hardcode Enricher](/articles/unify-customer/enrichers-for-data-transformation-2816770049#hardcode-enricher) to define the country for your incoming data.
  </Step>

  <Step>
    Map the identifiers - Mapping the identifiers is a mandatory step and at least one ID must be mapped for every source. We recommend that this ID is the one that you have used in ID stitching.

    **Exception in case of one or all the below reasons:**

    * If Zeotap’s Web JavaScript, GTM, Pixel or SDK source is integrated, then the first-party cookie or natively tracked identifiers are mapped internally. In this case, the ID is mapped internally.
    * If the internally mapped IDs are classified as Disabled IDs. To know more about Disabled IDs, refer [here](/articles/unify-customer/high-fidelity-or-custom-id-strategy).

    <Frame>
      <img src="https://mintcdn.com/zeotap/VC7TCWdAQcEWP1YP/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07.png?fit=max&auto=format&n=VC7TCWdAQcEWP1YP&q=85&s=957da99b38225b47db5c64f500b16217" alt="" width="3520" height="1730" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07.png" />
    </Frame>
  </Step>

  <Step>
    Use the **Enable Auto Mapping** toggle to turn auto-mapping of source and catalogue fields on or off. Auto mapping uses the catalog name and previous mappings to automatically map source fields to catalog fields. Note that auto-mapping is available at both the source level and the individual category level. To learn more about how auto-mapping works, refer [here](/articles/unify-customer/auto-mapping). 

    <Frame>
      <img src="https://mintcdn.com/zeotap/8JL3J3GLnO5rMtb7/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-13.png?fit=max&auto=format&n=8JL3J3GLnO5rMtb7&q=85&s=ea852241b7c9c0b5869b6a4d2a9e2bd3" alt="" width="3028" height="1256" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-13.png" />
    </Frame>
  </Step>

  <Step>
    You can also search for a field using the search box or filter fields by status. To filter, select the desired status next to the search box. The available statuses are **Mapped**, **Unmapped**, **Warnings**, and **Errors**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/VC7TCWdAQcEWP1YP/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-7.png?fit=max&auto=format&n=VC7TCWdAQcEWP1YP&q=85&s=8e014ce94913519dbf8025a7190e9f43" alt="" width="3044" height="450" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-7.png" />
    </Frame>
  </Step>

  <Step>
    However, if you find any field with no mapping, then the system identifies it as a new field. In such case, you need to define the mapping. To do so, in the drop-down, click + **Add Catalogue Field** as shown in the image below. For information about how to create a new catalogue field, refer [here](/articles/unify-customer/add-a-catalogue-field).

    <Frame>
      <img src="https://mintcdn.com/zeotap/VC7TCWdAQcEWP1YP/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-8.png?fit=max&auto=format&n=VC7TCWdAQcEWP1YP&q=85&s=52928ab8795563deb4ea0b66501a2f0e" alt="" width="3036" height="1710" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-8.png" />
    </Frame>
  </Step>

  <Step>
    If there is a data type mismatch between the incoming source field and the catalogue field, then the system displays a warning to fix the data type to prevent ingestion failure. In such cases, you can perform one of the following actions:

    * Choose the data type that matches the source data
    * Add an enricher while mapping the source to align incoming data with catalogue fields
    * Override the source data type to your desired data type. For information about how to override and edit an override, refer [here](/articles/unify-customer/override-the-source-data-type).
  </Step>

  <Step>
    If there is a data type mismatch between the incoming source field and the catalogue field, then the system displays a warning to fix the data type to prevent ingestion failure. In such cases, you can perform one of the following actions:

    * Choose the data type that matches the source data
    * Add an enricher while mapping the source to align incoming data with catalogue fields
    * Override the source data type to your desired data type. For information about how to override and edit an override, refer [here](/articles/unify-customer/override-the-source-data-type).
  </Step>

  <Step>
    Map the Consent Purposes - If a source has consent data, then click **Add mapping** and select the incoming consent field and map it to the relevant Zeotap consent field. Add Enricher to standardise the incoming consent field to a binary value (Yes/No) to use it across the downstream modules. To know more about the Value Mapper Enricher, click [here](/articles/unify-customer/enrichers-for-data-transformation-2816770049#value-mapper-enricher).

    If there is no incoming consent source field, then click **Add custom field** and choose the relevant consent catalogue field followed by which, add the [Hardcode Enricher](/articles/unify-customer/enrichers-for-data-transformation-2816770049#hardcode-enricher), specifying that all the incoming records are consented by your customer.
  </Step>

  <Step>
    Map the Marketing Preferences - Capturing marketing preferences along with consent gives clarity and assurance to the marketing team while designing the campaign for the right audience.

    Explain the mapping procedure. If a source has marketing preference data, then click **Add mapping** and select the incoming marketing preference field and map it to the relevant Zeotap marketing preference field. Add Enricher to standardise the incoming consent field to a binary value (Yes/No) to use it across the downstream modules. To know more about the Value Mapper Enricher, click [here](/articles/unify-customer/enrichers-for-data-transformation-2816770049#value-mapper-enricher).

    If there is no incoming consent source field, then click **Add custom field** and choose the relevant marketing preference field followed by which, add the [Hardcode Enricher](/articles/unify-customer/enrichers-for-data-transformation-2816770049#hardcode-enricher), specifying that all the incoming records are consented by your customer.

    <Frame>
      <img src="https://mintcdn.com/zeotap/VC7TCWdAQcEWP1YP/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-9.png?fit=max&auto=format&n=VC7TCWdAQcEWP1YP&q=85&s=8b37868f52bfcdb9845f3145a88d8b07" alt="" width="2960" height="1026" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-9.png" />
    </Frame>
  </Step>

  <Step>
    Click **REVIEW**.

    In the **REVIEW MAPPING**screen that appears, you can find warnings along with error logs that provide a description of the issue for incorrectly mapped fields. Once you have corrected these fields, the system automatically refreshes, allowing the warning to disappear.

    <Frame>
      <img src="https://mintcdn.com/zeotap/8JL3J3GLnO5rMtb7/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-10.png?fit=max&auto=format&n=8JL3J3GLnO5rMtb7&q=85&s=ab4df6faa2c7febd3749e4815169543f" alt="" width="3022" height="2746" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-10.png" />
    </Frame>

    The table below outlines some cases where warning and error logs may appear during the mapping process, along with corresponding mitigation steps.

    | **CASE**                                                                                                 | **MITIGATION**                                                                                                                                                                                                 |
    | :------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | If there is conflicting mapping. That is, more  than one source field is mapped to  one catalogue field. | \*   Keep the mapping only against the correct      source field and remove it for the others.   <br /> <br /> \*   Map the other source fields with a new      or any of the other unmapped catalogue fields. |
    | If there is a mismatch found between  the source field data type and the  mapped fields data type.       | Either correct the value in your source data  to match the catalogue data type or create a new  catalogue field of the matching data type.                                                                     |

    <Note>
      **Note**

      Ensure that you consider the following points while reviewing the mapping:

      * We highly recommend that you define consent for each source to comply with your privacy regulations
      * Note that the checks that are done during the Review Mapping stage are just preliminary validation performed on the sample dataset. This does not provide a complete view of the source ingestion.
      * We do not allow mapping an incoming `String` field to an `Integer` field. However, we do allow mapping an incoming `Integer` field to a `String` field in the Catalogue. For example, you can map an incoming `String` field "Age" to a `String` field in the Catalogue. On the other hand, mapping the same field to an `Integer` field in the Catalogue is not allowed. This may lead to ingestion errors in specific cases, which you have to be aware of.
      * We recommend that you fix all the errors that appear on the Review Mapping screen before proceeding with source ingestion.
    </Note>
  </Step>

  <Step>
    After the review is complete, you can choose either **Save as a Draft** or **Confirm and Save**.

    * **Save as a Draft** allows you to save the mapping as a draft and revisit later for modifications. This serves as a checkpoint for verifying the mapped fields with an expert. Note that when you save a mapping as a draft, the status of the source remains in **INTEGRATED**. In addition, a **DRAFT** tag gets added below it as shown in the image below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/8JL3J3GLnO5rMtb7/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-04-22.png?fit=max&auto=format&n=8JL3J3GLnO5rMtb7&q=85&s=4e62f053c58061f90823e17ed94d2fd0" alt="" width="1794" height="324" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-04-22.png" />
    </Frame>

    * **Confirm and Save**concludes the mapping process, preventing further modifications to the mapping.

    <Frame>
      <img src="https://mintcdn.com/zeotap/8JL3J3GLnO5rMtb7/articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-12.png?fit=max&auto=format&n=8JL3J3GLnO5rMtb7&q=85&s=3db9e04f0062a772186020a54d4af604" alt="" width="3522" height="1740" data-path="articles/unify-customer/Storage/unify-customer/map-the-catalogue-for-customer-data/map-the-catalogue-for-customer-data-2024-10-07-12.png" />
    </Frame>
  </Step>
</Steps>