Read Pulse
Ask for thepulse include on a campaign:
get returns pulse with the campaign’s verdict, its reasons, and one entry
for each live media buy (at most 50; mediaBuysOmitted counts the rest). A live
media buy is one that is active: not a draft, paused, ended or archived.
Each media buy entry has:
To show Pulse in a list, ask
search for it:
pulse with only the campaign verdict,
dataThrough and nextCheckAt.
If Pulse cannot be read, the campaign is still returned, and
unavailableIncludes names pulse with the reason.
What each verdict means
For a media buy:
For the campaign:
Missing figures are never shown as zero. A media buy whose seller has not
reported reads
unverified, not not_delivering, and its metrics are null.
When figures are due
A media buy’s reporting schedule comes from the products it booked: how often each product reports (available_reporting_frequencies) and how long after a
period ends its report arrives (expected_delay_minutes). A buy reports as
often as its slowest product. Its first report is due one period plus the
longest delay after its flight starts, and its figures stay fresh for one period
plus that delay after their dataThrough.
Keep a view current
nextCheckAt is the earliest time a verdict can change with no new report: a
flight starting, a first report falling due, or figures going stale. It is
null when only a new report can change a verdict. To keep a page current,
read Pulse again at nextCheckAt rather than on a timer.