Cheatsheet

Timestamp formats: legacy Google Ads → RFC 3339

The Data Manager API accepts exactly one timestamp shape: RFC 3339. The legacy world accepted half a dozen. This page maps each old format to its converted form.

The target format

event_timestamp: "2026-06-20T15:07:01Z"       // UTC ("Z")
event_timestamp: "2026-06-20T10:07:01-05:00"  // or explicit offset

Conversion table

Legacy inputTimezone sourceRFC 3339 output
2026-06-20 10:07:01-05:00 In-row offset 2026-06-20T15:07:01Z
06/20/2026 10:07:01 Parameters:TimeZone=America/Chicago (CDT, −05:00) 2026-06-20T15:07:01Z
2026-06-20 10:07:01 Parameters:TimeZone=-0500 2026-06-20T15:07:01Z
2026-06-20 10:07:01 None anywhere Error — timezone required

The three timezone pitfalls

1. Naive timestamps are not UTC

A timestamp without an offset means "whatever timezone the file assumed" — usually the account timezone, not UTC. Converting a US-Eastern timestamp as if it were UTC shifts every conversion by 4–5 hours, which silently moves late-evening conversions to the wrong day and breaks day-level reporting. The converter refuses to guess: if no timezone information exists, it asks you to pick one.

2. DST changes the offset mid-file

America/New_York is −05:00 in January and −04:00 in July. If a file spans a DST boundary, a fixed offset like -0500 is wrong for part of the rows. Prefer timezone IDs (America/New_York) over raw offsets — the converter resolves each row's offset at that row's date.

3. MM/dd vs dd/MM

03/04/2026 is March 4 in US format and April 3 in most of the world. This tool parses US-style MM/dd/yyyy, and when it detects a day-first date (day > 12) it raises an error instead of guessing. If your export uses day-first dates, switch it to ISO yyyy-MM-dd.

Related rules

Convert and validate your file in the converter, or see the full field mapping.