Documentation Updates 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 dec-17

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 nov-17

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 oct-17

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 sept-17

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 aug-17

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

This feature has been deprecated.

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 jul-17

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 jun-17

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 may-17

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...
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 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 apr-17

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 march-17

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 Link
This section contains new and revised content to support the Profile Link and third-party device graph options.

February, 2017 feb-17

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 jan-17

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...
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 prev

Links to Audience Manager release notes and documentation changes. For an archive of older changes at the Experience Cloud level, see the Previous Release Notes section.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695