Agencies CALL TO ACTION

On June 24, 2024, DAP released a new major code version 8.1, focused primarily on the removal of UA code. It will also contain a few other updates, including lowercase enforcement for hostnames, new custom event naming taxonomy in addition to the dap_event, updates to redaction code to allow additional matching cases, and backward compatibility for the GAS function for new custom tracking code in GA4.

CALL TO ACTION:

Centerally-hosted DAP code without "pua" (Parallel Universal Analytics)

For agencies using DAP code from the centrally-hosted location without “pua” parameter for parallel tracking for their own GA account(s): NO ACTION REQUIRED

Self-hosted DAP code

For agencies self-hosting the DAP code: agencies must download the DAP v.8.0 code from the DAP Github repository on June 25, 2024 or shortly after and install it on their servers

Parallel-tracking or "pua" (Parallel Universal Analytics) DAP Code

For agencies using DAP code with parallel-tracking or “pua” (stands for Parallel Universal Analytics): agencies should replace their “pua” parameter and Universal Analytics account number with a “pga4” (Measurement ID) parameter and your GA4 account number as soon as possible. See the example below:

Example

Replace the “pua” parameter and account information (example only)

<script async type="text/javascript" id="_fed_an_ua_tag" src=https://dap.digitalgov.gov/Universal-Federated-Analytics-Min.js?agency=DHS&pua=UA-000000-0></script>

with “pga4” parameter and account information (example only)

<script async type="text/javascript" id="_fed_an_ua_tag" src=https://dap.digitalgov.gov/Universal-Federated-Analytics-Min.js?agency=DHS&pga4=G-111111></script>

Instruction for finding your independent GA4 Measurement ID (example only):

1. Click on the settings icon on the bottom left
2. Click on "Data streams" under "Data collection and modification"
3. Click on arrow
4. Copy the Measurement ID under Web stream details for your independent GA4 Account For more information about the DAP code capabilities, see the DAP Quick Technical Guide or email dap@gsa.gov.

Announcement on Next Release:

Custom Event Tracking

This update will only impact websites that have implemented event tracking using a function called gas(). In the next release, the event tracking function will change from this structure gas('send', 'event', 'category', 'action', 'label', value, noninteraction); to this new structure gas4('event','parameter');

All custom events must have this structure:

gas4('event','parameter');

Please visit our wiki instruction for DAP - Custom Events.