2017 Documentation Updates

A list of new or revised documentation released in 2017 and previous years. Includes minor updates to the Audience Manager documentation that might not be covered in the Experience Cloud release notes.

See the Experience Cloud Release Notes for changes to Audience Manager and other Experience Cloud solutions. See the Previous Years section for older release notes.

December, 2017

Topic Description

Understanding Algorithmic Models

Added a section on troubleshooting.

Audience Manager Cookies

Deprecated the DST cookie and added time-to-live information for the demdex and dextp cookies, when the user opts out of data collection.

November, 2017

Topic Description

Supported Attributes for DCS API Calls

For reference purposes, we added the reserved attributes d_dst_filter and d_rs to the documented d_ attributes. We advise against creating traits that use reserved attributes. Adobe may change reserved attributes at any time.

Trait Qualification Reference

Trait qualification, or trait realization is treated differently in Audience Manager, depending on trait type. This document details qualification particularities for each trait type.

Privacy and Data Retention FAQ

Added a section on Trait Qualification Data Retention.

Usage Limits

Added the total trait qualifications to the limits that we highlight here.

Inbound Data File Contents: Syntax, Invalid Characters, Variables, and Examples

Updated the accepted and forbidden characters in inbound data files. We also added a matrix table that shows examples of the correct way to format your inbound files, depending on the type of IDs you are importing and the method by which you want to add traits to profiles.

October, 2017

Topic Description

DCS Error Codes, Messages, and Examples

Returning new error codes 111, 309, 310.

Supported Attributes for DCS API Calls

Added d_cts as an optional parameter in the list of available keys for DCS requests. You must contact your Adobe Audience Manager consultant or Customer Care to enable it.

How Data Delivery and File Processing Times Affect Reports

Updated the data processing and delivery schedule for Outbound jobs.

DCS API Methods

You can send data to the DCS by using GET or POST methods. This document describes the syntax you must use, in each case.

Reporting FAQ

Total Trait Fires have been renamed to Total Trait Realizations in the Audience Manager user interface. We updated the FAQ to reflect this modification.

Configure an Analytics Destination

New content on how to send Audience Manager segments to Analytics.

September, 2017

Topic Description

Update Schedule for Algorithmic Models and Traits

We updated the creation and update schedules for new or existing algorithmic models and traits.

Data Collection and Product Integration FAQ

Added a question on missing trait realizations, when sending event calls containing declared IDs to the DCS.

Actionable Log Files

Find out why Actionable Log Files is the recommended way of importing DCM log files into Audience Manager and learn how you can get started with the feature.

Import DCM Data Files Into Audience Manager

Added step 7, on what you need to do to enable Actionable Log Files after setting up the DCM data file import into Audience Manager.

Working with Comparison Operators in Trait Builder

Updated the comparison operators to correctly identify the ones that support regular expressions.

Trait Details Page

New content describes features on the trait details page, including the trait audit log.

Integrate Audience Manager With Target

New content describes how to send Audience Manager segments to Target.

Data Privacy

Revised content with new links to the Adobe Privacy Center.

Declared ID Targeting

Revised content.

August, 2017

Topic Description

How Data Delivery and File Processing Times Affect Reports

Updated the time the General Reports data is available and the times the inbound file ingestion process starts each day.

Data Collection Server (DCS) API Methods and Code

Revised and reorganized DCS API content.

isCoopSafe

A new configuration to control how data is sent to the Experience Cloud Device Co-op.

Profile Merge Rules and Device Graph FAQ

Revised and updated answers related to Merge Rules created with device graph options.

July, 2017

Topic Description

CSV Files for Overlap Reports

Revised to note that string data is enclosed in double-quotes " ".

Profile Merge Rules and Device Graph FAQ

Revised and updated to include information about unsegmentation and how device graphs affect merge rules and reporting.

Profile Merge Rules and Device Un-Segmentation Processes

New content that describes how unsegmentation works with Profile Merge Rules.

Trait and Segment Population Data in Segment Builder

Revised with new definitions that account for how Profile Merge Rules affect reporting numbers.

Audience Marketplace for Data Buyers

New and revised content for data feed subscription workflows.

DCS Error Codes, Messages, and Examples

Added new errors and text for error IDs 307 and 306.

June, 2017

Topic Description
DCS Error Codes, Messages, and Examples

Added the Profile Retrieval Errors 200, 201, 202 and 203.

API Requirements and Recommendations

Revised content and included new information about creating a generic, API-only user.

Folder Traits

A folder trait allows you to capture all the users and activities from its associated folder and any child folder.

Folder Traits: About

Folder traits let you automatically aggregate traits that reside within the same folder and all child folders into a targetable segment.

Create a Folder Trait

A folder trait is created automatically when you create a new folder in your taxonomy.

Edit a Folder Trait

The Edit workflow allows you to change the data source for folder traits.

Delete a Folder Trait

Delete a folder trait by deleting the storage folder that the trait belongs to.

Trait Summary View

Surfaces two new metrics in the Trait Summary View: Unique Trait Realizations and Total Trait Population.

Usage Limits

Added Folder limits and Folder Trait limits to the documentation.

Run a General Report

Updated to include the new metrics Unique Trait Realizations, Total Trait Realizations, Total Trait Population. We also added new day ranges to the reporting look-back window. You can now select a 1, 7, 14, 30, 60, 90-day range or lifetime.

Run a Trend Report

Updated to include the new metrics Unique Trait Realizations, Total Trait Realizations, Total Trait Population. We also added new day ranges to the reporting look-back window. You can now select a 1, 7, 14, 30, 60 or 90-day range.

Trait and Segment Population Data in Segment Builder

Changed a metric to Total Trait Population from Unique Trait Realizations.

Remove Traits from a Segment

Instructions about how to remove traits from a segment using Segment Builder.

Data Feed Deactivation: Why It Happens and How to Respond

Revised with more information about why feeds are deactivated and what you should do when this happens.

May, 2017

Topic Description
File Compression for Inbound Data Transfer Files

We increased the documented optimal and maximum file sizes for compressed files.

FTP Name and File Size Requirements for Inbound Data Files

We increased the documented optimal and maximum file sizes for compressed files.

Amazon S3 Name and File Size Requirements for Inbound Data Files

We increased the documented optimal and maximum file sizes for compressed files.

Geotargeting With Platform-level Keys

Updated the codes in the geolocation keys.

Audience Lab Use Cases

A new section in our documentation, highlighting several use cases for the Audience Lab feature.

Compare Models in Audience Lab

You can use several different types and sources of models in Audience Manager. Audience Lab offers an easy way to compare your customers' conversion rates, across your active models.

Testing Creatives Across Destinations

Use Audience Lab to measure the number of conversions a creative is driving across different destinations. This use case also allows you to measure the conversions of the creative against naturally occurring conversions.

Profile Merge Rules and Device Graph FAQ

Added a new FAQ to help answer common Profile Merge Rule and device graph questions.

Understanding TraitWeight

Models Summary View

Revised content to account for the changed weighting model. The new model weights traits on a 0% to 100% scale rather than just on a 0 to 1 scale.

April, 2017

Topic Description

Receive Data From the DCS

DCS HTTP response calls now contain the tid field. Use this field for debugging purposes in case of incidents.

Send Batch Data to Audience Manager Overview

Added information on the Production and Beta environment locations for the Amazon S3 service.

Segment Performance Report

Added a note, clarifying that 7-day and 30-day look-back periods are only available for Sunday Date Through dates.

Unique User Reach

Trend Analysis and Volume Analysis Reports

Recency and Frequency

Minor text revisions to improve clarity.

Customer Data Feeds

Significant revisions include new information and a complete rewrite and reorganization of this documentation.

Data Files for Audience Optimization Reports

Revised content to indicate the following:

  • In a file name, an underscore separates the event type from the timestamp.
  • Prior to upload, files must be gzip compressed and have a .gz file extension.

Trait and Segment Population Data in Segment Builder

Revised content to include information about this redesigned UI feature.

Understanding Calls to the Demdex Domain

Added a new doc on why Audience Manager makes calls to the demdex.net domain.

Audience Manager Cookies

Revised and updated with new information.

March, 2017

Topic Description

Supported Attributes for DCS API Calls

Updated the Key Variable Prefixes with _p, identifying private parameters in Audience Manager.

Prefix Requirements for Key Variables

Updated the Key Variable Prefixes with _p, identifying private parameters in Audience Manager.

Create a Segment

Added further search and filter capabilities to the Browse All Traits advanced search.

Trait List View

UI improvements to the way you can search and filter traits in the Traits Dashboard.

Overlap Reports: Update Schedule and Minimum Segment Size

Specified the cutoff time for segment creation as 12 AM Thursday UTC so that the users are included in the Overlap Reports for that particular week.

Addressable Audiences

Added information about prospecting and match rates.

Addressable Audience Metrics

Added more detail to metric definitions.

Profile Merge Rules

This section contains new and revised content to support the Profile Link and third-party device graph options.

February, 2017

Topic Description
DCS Error Codes, Messages, and Examples Added Integration Warnings to DCS Error Codes.
Outbound Data File Name: Syntax and Examples Added optional file name element PID-ALIAS in the Outbound file.

Segment Summary View

Added 1, 14, 90-day and lifetime look-back periods for real-time and total segment population.

Using DNS Prefetch with Different Experience Cloud Solutions

Describes how to implement DNS prefetch to help reduce page load times.

DIL create

Revised description and added related links to the containerSNID property of DIL.create.

Addressable Audience Metrics

Revised and reorganized metric definitions.

Audience Manager API Code Migration

Revised with new content related to Swagger and migrated API methods.

Folder API Methods

Rewritten in Swagger and migrated to new site.

Trait API Methods

Rewritten in Swagger and migrated to new site.

January, 2017

Topic Description
Usage Limits Added maximum audience size and advice on how to reduce it to usage limits documentation.

Audience Optimization Reports

Revised section to include new descriptions and images of updated reports.

Name and Content Requirements for ID Synchronization Files

Added ID sync sample files and added a more precise explanation around how the ID sync process works.

Models Summary View

Updated the models summary page to include available model details and controls.

Index of IDs in Audience Manager

Updated with the expected format for mobile device IDs (DAID) handled by Audience Manager.

Amazon S3 Name and File Size Requirements for Inbound Data Files

Added a note advising that the inbound data validation process will mark empty files as invalid and will not process them.

Product Features and Functions FAQ

Added new entry that describes the Experience Cloud Organization ID, including information on how to find it.

Updated to include the DPUUIDS macro.

Previous Years

Links to Audience Manager release notes and documentation changes prior to 2017. For an archive of older changes at the Experience Cloud level, see the previous release notes.