HyrosInstall

Summary

Retrieve the marginal customer acquisition cost curve for one Hyros ad entity, using its ID and level. The optional settings control attribution credit, history dates, and the CAC or lifetime value ceiling.

Inputs

• Entity ID (required) — The ad platform’s ID for the entity being reported on; it must match the selected Level.
• Level (required) — Entity granularity: Account, Ad, Campaign, or Source Link (an ad set on Meta or an ad group elsewhere). Campaign is available on Meta, Google, and LinkedIn. Defaults to Source Link.
• Attribution Model — Choose First Click to credit the first ad that touched the customer, or Last Click to credit the click immediately before purchase. Defaults to First Click.
• CAC Ceiling — Maximum acceptable acquisition cost. Required for Account-level reports, which have no LTV; the source forwards this value only when it is greater than zero.
• End Date — ISO 8601 end date for the history; defaults to today.
• LTV Window — Realized LTV window used as the break-even ceiling when CAC Ceiling is absent. Defaults to 90 Days and is rejected at Account level, where CAC Ceiling must be provided.
• Start Date — ISO 8601 start date for the history; defaults to 90 days before End Date.

Output shape

A single report object, or no result when the entity has no row for the selected date range.

The operation returns the entity's marginal CAC curve. The node source does not specify the report object's fields.

Examples

Example 1: Report on an ad

Set Entity ID to the ad platform ID, Level to Ad, and optionally choose the attribution model, date range, and CAC or LTV ceiling.

Links

• n8n community nodes installation guide