Hyros icon

Hyros

Interact with Hyros API - Complete coverage of all endpoints

Actions60

Attribution → Get Ads Attribution Report

AI-generated

Summary

Retrieves a Hyros ads attribution report for a date range, using the selected attribution model and level. Choose requested metrics and IDs; optional filters and grouping settings refine the report.

Inputs

  • Attribution Model (required) — Choose Last Click, Scientific, or First Click.
  • Start Date (required) — Start of the report date range in ISO 8601 format.
  • End Date (required) — End of the report date range in ISO 8601 format.
  • Level (required) — Select the ad entity level to report on, such as Facebook AdSet, Google Ad, or TikTok AdGroup.
  • Fields (required) — Select the metrics and dimensions to include; defaults to sales, revenue, and cost.
  • IDs (required) — Comma-separated IDs for the selected level. With Is Ad Account ID enabled, provide an ad account ID instead.
  • Additional Fields — Optional report settings include currency, attribution-day behavior, hard-cost and recurring-sale handling, forecasting, customer and source filters, lead-stage filtering, status, and time grouping. For ads reports, pagination is available through Page ID and Page Size; Keywords IDs can map Google ad group IDs to keyword IDs. Is Ad Account ID and Newest First affect ad-account source reporting. Time Grouping Option is not supported when Is Ad Account ID is enabled.

Output shape

A list of report result items.

Ads reports support pagination using Page ID from the response's nextPageId and Page Size (1–250). Results depend on the chosen level, fields, date range, and optional settings.

Links

Discussion