Skip to main content

Data Qualification (DQE)

Onboarding Progress

Step 1: Getting Started
Step 2: API Integration (AIE)
Step 3: Data Qualification (DQE)
Step 4: Production Launch

Step 3: Submit All Your Data

In the Data Qualification Environment (DQE), you will submit your data for evaluation by Apple Business before you are granted approval for the production environment. Your submission should be as close as possible to production quality.

  • Data qualification is typically completed within one to two weeks.
  • The data submitted for data qualification is not published externally.
  • Data sent to DQE is not automatically promoted to production.
  • When creating a location for DQE, the partnersLocationId you specify will be used for the entire lifecycle of the location. Be sure to record the partnersLocationId. Any time you change location data, you must reuse the same partnersLocationId.

Data Qualification Sequence of Tasks

  1. Receive email granting access to DQE (includes DQE endpoint).
  2. Create a Service Account for DQE.
  3. Collect Integration Parameters.
  4. Submit Data for Qualification.
  5. Request Data Qualification Verification.
  6. View Data Qualification Progress Reports.
  7. Complete the Data Qualification Exit Process.

New Partners vs. Existing Partners

The data qualification steps differ depending on whether you are a new or existing partner:

  • New Partner: You are sending data to Apple Maps for the first time and have no previous bulk ingests.
  • Existing Partner: You are currently sending bulk data to Apple.

Submit Data for Qualification

Note the differences in some steps for new and existing partners.

  1. You will receive an email granting you access to DQE. Retrieve the DQE endpoint from this email.
  2. Create a Service Account for DQE.
  3. Collect the Integration Parameters.
  4. Send your data.
New Partner
  1. Send all of your location data for evaluation.
    • When locations are initially submitted, their resource state is SUBMITTED. After Apple Business finalizes the analysis and approves the location data, the location state will update to PUBLISHED.
  2. After your locations are PUBLISHED, send the rest of your production data for evaluation.
Existing Partner
  • Send all of your production data for evaluation.
  • Each site_code in a bulk record must be captured as a partnersLocationId.
  • Apple Business will run a differential analysis between your previous bulk ingest and the data you submit to DQE.

Request Data Qualification Verification

important

Only request verification when all of your data has been sent to DQE.

  1. Navigate to Organization > Organization Name > API > Data Qualification ().
  2. Select Verify Data Quality > Send. Apple Business will then evaluate your data for quality and accuracy.
  3. You can optionally confirm receipt via the embedded alert in the API Access pane.

View Data Qualification Progress Reports

  1. You will receive an email with your DQE results.
  1. Sign in to the Apple Business portal and select Organization > Organization Name > API.
  2. In the Data Qualification pane, a message will indicate that your submitted data was not approved. Select View Details.
  3. Access the reports in your Box folder.
  4. Proceed to the Data Qualification Exit Criteria.

Access Box Folder Reports

In the "Not Approved" dialog, select the Box folder link to view your progress reports.

tip

If the Box folder does not open, sign in to your organization's Box account first, then select the Box folder link again.