The latest release of the Data Manager API
introduces features that simplify
audience management, enhance ingestion workflows with field-level warnings,
and enable more granular user-provided data for Google Analytics.
Remove all audience members
Use the new
RemoveAllAudienceMembers
method to clear all members from specified user lists in a single operation.
The optional removeAsOfTime parameter lets you target only those
members added before a specific timestamp.
This is particularly useful when you need to perform a full refresh (or
"replace all") of your audience data, allowing you to clear the existing list
and populate it with a new set of users.
Ingestion field warnings
Data Manager API ingestion responses now include detailed field-level warnings
for validation issues on optional fields. If the API detects
validation issues with optional fields, your ingestion request will succeed
and the rest of your ingestion data will still be processed. Validation
failures for required fields will continue to fail the entire request
following the
fast-fail model.
If any optional field you provide is invalid, the response from
IngestEventsRequest
or
IngestAudienceMembersRequest
includes a field_warnings field with a list of
FieldWarning
objects. Each warning provides a specific reason (WarningReason), a descriptive message, and the location of the field in the request where
the issue occurred.
Additional address data for Google Analytics events
You can now provide additional user address information when ingesting events
to Google Analytics destinations. Along with the given_name,
family_name, region_code, and
postal_code fields,
AddressInfo
resource now supports:
address_line (street address)
city
administrative_area (state or province)
Also, you can now use the existing user-provided data (user_data)
field to meet the
Identifiers requirement for multi-source events sent to web data
streams. This gives you another option when you don't have the
ad_identifiers.gclid, user_id, or
client_id for a multi-source event.
Get started
-
Learn how to implement the new
RemoveAllAudienceMembers method
for your workflow:
-
See the
Ingestion warnings
section of the
Understand API errors
guide to learn how to check your responses for warnings.
-
Start sending events to Google Analytics with the Data Manager API:
Build faster with AI agent skills: We recently introduced new
Data Manager API agent skills to help you speed up your integrations. Explore
the new skills in the
Google Skills GitHub repository
to get more accurate, efficient guidance directly within your AI-assisted
coding environment.
If you have any questions or want to discuss this post, please reach out to us
on our
"Google Advertising and Measurement Community" Discord server. You can also contact us through the
support page
if you have an issue or need help with the API.
If you're interested in becoming a data partner, please fill out the
Partner Interest Form.
- Lindsey Volta, on behalf of the Data Manager API Team