# 2.5 Data Landing Zone

In this exercise, the goal is to setup your Data Landing Zone Source connector with Azure Blob storage.

Data Landing Zone is an Azure Blob storage interface provisioned by Adobe Experience Platform, granting you to access a secure, cloud-based file storage facility to bring files into Platform. Data Landing Zone supports SAS-based authentication and its data is protected with standard Azure Blob storage security mechanisms at rest and in transit. SAS-based authentication allows you to securely access your Data Landing Zone container through a public internet connection.

{% hint style="warning" %}
Adobe Experience Platform **enforces a strict seven-day time-to-live (TTL)** on all files uploaded to a Data Landing Zone container. All files are deleted after seven days.
{% endhint %}

## 2.5.1 Prerequisites

To copy blobs or files to your Adobe Experience Platform Data Landing Zone you'll use AzCopy, a command-line utility. You can download a version for your operating system via <https://docs.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-v10>.

![dlz-install-az-copy.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-8389cfa6c1f5743ba03253864cbfa6512c15b034%2Fdlz-install-az-copy.png?alt=media)

* Unzip the downloade file

![dlz-install-az-copy.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-566a9436f27f1900eaf22d69bfd0ed2d1907192b%2Fdlz1.png?alt=media)

* Download the sample data file [global-context-websiteinteractions.csv](https://github.com/AdobePartnerTechnicalServices/aep-quickstart-guide/blob/main/assets/csv/data-ingestion/global-context-websiteinteractions.csv), which contains sample website interactions and save it into the folder in which you unzipped **azcopy**.

![dlz-install-az-copy.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-a323aa16b1ce4a032e2a16ee5d3226b2921f5881%2Fdlz2.png?alt=media)

* Open a terminal window and navigate to the folder on your desktop, you should see the following content (azcopy and global-context-websiteinteractions.csv), for example on OSX:

![dlz-unzip-azcopy.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-1282ad356a1f095f89e487dab712c3455d710271%2Fdlz-unzip-azcopy.png?alt=media)

## 2.5.2 Connect Data Landing Zone to Adobe Experience Platform

Log in to Adobe Experience Platform by going to this URL: <https://experience.adobe.com/platform>.

After logging in, you'll land on the homepage of Adobe Experience Platform.

![Data Ingestion](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-d3766e8abcdcae565589d172ff39148a026b3712%2Fhome.png?alt=media)

Before you continue, you need to select a **sandbox**. The sandbox to select is named `--module2sandbox--`. You can do this by clicking the text **Production Prod]** in the blue line on top of your screen. After selecting the appropriate sandbox, you'll see the screen change and now you're in your dedicated sandbox.

![Data Ingestion](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-f8fe0607dc3e272ebd2416a98220bb1d82c1a166%2Fsb1.png?alt=media)

In the left menu, go to **Sources**. In the Sources catalog, search for **data landing**. On the **Data Landing Zone** card, click **...** and select **View Credentials**.

![dlz-view-credentials.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-86a9f29b7dc226224bc91308930b8bf80c5f06c6%2Fdlz-view-credentials.png?alt=media)

Click to copy **SASUri**.

![dlz-copy-sas-uri.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-05bc3c7c9a2c5bdb240707a507f892b508dcefd5%2Fdlz-copy-sas-uri.png?alt=media)

## 2.5.3 Copy your csv-file to your AEP data landing zone

You'll now ingest data into Adobe Experience Platform using Azure command line tools using AZCopy.

Open a terminal at the location of you azcopy install location and execute the following command to copy a file into AEP's data landing zone:

`./azcopy copy <your-local-file> <your SASUri>`

Make sure to surround your SASUri with double quotes. Replace `<your-local-file>` by the path to your local copy of the file **global-context-websiteinteractions.csv** in the azcopy directory, and replace `<your SASUri>` by the **SASUri** value which you copied from the Adobe Experience Platform UI. Your command should look like this:

```
./azcopy copy global-context-websiteinteractions.csv "https://sndbxdtlnd2bimpjpzo14hp6.blob.core.windows.net/dlz-user-container?sv=2020-04-08&si=dlz-xxxxxxx-9843-4973-ae52-xxxxxxxx&sr=c&sp=racwdlm&sig=DN3kdhKzard%2BQwKASKg67Zxxxxxxxxxxxxxxxx"
```

After executing the above command in your terminal, you'll see this:

![dlz-exec-copy-command.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-8d1d899d0b2325d762804adcd47a8eda219c7af9%2Fdlz-exec-copy-command.png?alt=media)

## 2.5.4 Lookup your file in your Data Landing Zone

Go to your Data Landing Zone in Adobe Experience Platform.

Select **Sources**, search for **data landing** and click the **Setup** button.

![dlz-inspect-datalanding-zone.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-ce7fbc0b88f0ecc286e01fefa9927b87f80017dc%2Fdlz-inspect-datalanding-zone.png?alt=media)

This will open the Data Landing Zone. You'll see the file that you just uploaded in the data landing zone's **select data** panel.

![dlz-datalanding-zone-open.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-5fe69636cac255f690a7fc15ee1818891afdf910%2Fdlz-datalanding-zone-open.png?alt=media)

## 2.5.5 Process your file

Select your file and select **Delimited** as data format. You'll then see a preview of your data. Click **Next**.

![dlz-datalanding-select-file.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-e7246161b72412321a646c48a867ee70416a9d60%2Fdlz-datalanding-select-file.png?alt=media)

You can now start mapping the uploaded data to match the XDM schema of your dataset.

Select **Existing dataset** and select the dataset **Demo System - Event Dataset for Website (Global v1.1)**. Click **Next**.

![dlz-target-dataset.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-ac3fe27725ec5d4f94e98843ed9f95a1ff16c2da%2Fdlz-target-dataset.png?alt=media)

Now you are ready map the incoming source data from your csv file to the target fields from the dataset's XDM schema.

![dlz-start-mapping.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-1ac0c59d0f509f00c1362f006012a75d4ce592db%2Fdlz-start-mapping.png?alt=media)

{% hint style="info" %}
Don't mind the potential errors with the mapping. You'll correct the mapping in the next step.
{% endhint %}

## 2.5.6 Map fields

First of all, click the **Clear all mappings** button. You can then start with a clean mapping.

![dlz-clear-mappings.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-9e6872d5fda06670874b65e77261d9172c1bf527%2Fmappings1.png?alt=media)

Next, click **New field type** and then select **Add new field**.

![dlz-clear-mappings.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-56a076d8659a708eb924c933f959ef1bf6c29704%2Fdlz-clear-mappings.png?alt=media)

To map the **ecid** source field, select the field **identities.ecid** and click **Select**.

![dlz-map-identity.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-e880e19102b5eb4f936b77ddee00482df9d3cfb3%2Fdlz-map-identity.png?alt=media)

Next, click **Map target field**.

![dlz-map-select-target-field.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-31eddf38743074caa9df06571e04da30a8699df8%2Fdlz-map-select-target-field.png?alt=media)

Select the field `--aepTenantId--`.identification.core.ecid in the schema structure.

![dlz-map-target-field.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-701f9de08d950d98f23a421e0dc1e7579e98a503%2Fdlz-map-target-field.png?alt=media)

You need to map a couple of other fields, click **+ New field type** followed by **Add new field** and add fields for this mapping

| source                 | target                  |
| ---------------------- | ----------------------- |
| resource.info.pagename | web.webPageDetails.name |
| timestamp              | timestamp               |
| timestamp              | \_id                    |

![dlz-add-other-mapping.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-dc512238f1b89b8a2da5643cbff6a5e9f2166f11%2Fdlz-add-other-mapping.png?alt=media)

When finished your screen should look like, the screen below. Click **Next**.

![dlz-mapping-result.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-76c5d113b41cfcf3ec553e2d86b8a03932b71fba%2Fdlz-mapping-result.png?alt=media)

Click **Next**.

![dlz-default-scheduling.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-6ceced56f8e2ce4e6ea28776d8742d7d91810dc0%2Fdlz-default-scheduling.png?alt=media)

Click **Finish**.

![dlz-import-finish.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-04086255193d4d20052cfd91c7f1533b8adb126b%2Fdlz-import-finish.png?alt=media)

## 2.5.7 Monitor dataflow

To monitor you dataflow, go to **Sources**, **Dataflows** and click on your dataflow:

![dlz-monitor-dataflow.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-a33c3afc643214b6027bb39a8aabf4bbd0fc4c27%2Fdlz-monitor-dataflow.png?alt=media)

Loading the data can take a couple of minutes, when succesful, you'll see a status of **Success**:

![dlz-monitor-dataflow-result.png](https://858372621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpBC8bA57il8Sj47B7QPJ%2Fuploads%2Fgit-blob-92747d2c84785d0982c3c9e2d4cfc4c15223cd5f%2Fdlz-monitor-dataflow-result.png?alt=media)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.adobesandbox.com/comprehensive-technical-tutorial-archive/module2/ex5.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.