← Adzviser CallTrackingMetricsCONTENT HISTORY

Update to Adzviser CallTrackingMetrics

Snapshot Sep 30, 2026 · 23:13 UTC · version 1.0.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "adzviser-data-mode",
  "description": "Retrieve and analyze model-visible, row-level marketing or sales data with Adzviser. Use when the user asks for Data Mode, reporting_mode=data, raw rows, an audit, calculations, comparisons, trends, insights, optimization recommendations, or any answer that requires ChatGPT to inspect the underlying numbers. Do not use when the user explicitly wants only the interactive Preview UI.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 234
    }
  ],
  "skill_md_contents": "---\nname: adzviser-data-mode\ndescription: Retrieve and analyze model-visible, row-level marketing or sales data with Adzviser. Use when the user asks for Data Mode, reporting_mode=data, raw rows, an audit, calculations, comparisons, trends, insights, optimization recommendations, or any answer that requires ChatGPT to inspect the underlying numbers. Do not use when the user explicitly wants only the interactive Preview UI.\n---\n\n# Adzviser Data Mode\n\nUse Adzviser as the source of truth for connected marketing and sales data. Retrieve the actual rows, inspect them, and answer the user's question with evidence from those rows.\n\n## Route to the data tool\n\n- Call `retrieve_reporting_data` for this workflow.\n- Never call `preview_and_retrieve_reporting_data` for Data Mode. That tool is bound to an iframe and will render the embedded report instead of serving as the raw-data path.\n- Treat `reporting_mode=data` as user intent that selects `retrieve_reporting_data`; it is not an argument to send.\n- Never send `client_id`, `reporting_mode`, or `_widget_action`. They are internal compatibility fields, not model inputs.\n- If a user asks for both analysis and an interactive report, retrieve and analyze the rows first. Open Preview UI afterward only if the user explicitly requested that additional deliverable.\n\n## Follow the reporting workflow\n\n1. Interpret the question and identify the requested data sources, measures, dimensions, time window, and comparison periods. Ask one concise question only when a missing choice would materially change the report.\n2. Resolve relative dates from the current date available to ChatGPT. Pass inclusive `[start_date, end_date]` pairs in `YYYY-MM-DD` format. Never reuse a fixed date from an example or an older conversation.\n3. Call `list_workspace`. Use a user-named workspace when it exists. Otherwise auto-select only when one workspace unambiguously contains every requested connected source; ask when multiple candidates remain.\n4. For every requested source, call its `list_metrics_and_breakdowns_*` tool. Use the exact returned field names. Do not guess close variants.\n5. Build one `adzviser_request` with:\n   - `workspace_name`, except for a documented source that does not require it;\n   - `date_ranges` containing every requested period;\n   - optional `time_granularity` when the user requests a time series;\n   - `assorted_requests` as an object keyed by source request name, such as `google_ads_request` or `fb_ads_request`.\n6. Call `retrieve_reporting_data` once with `{ \"adzviser_request\": ... }`.\n7. Inspect all data sources, date-range segments, headers, rows, and `note_of_assumption` values in `structuredContent.reportingData`. Use the text/CSV content only as a fallback when structured content is absent.\n8. Answer with the requested numbers first, then material patterns and practical recommendations supported by the data. State the workspace, sources, and exact date ranges used when they help the user verify the result.\n\n## Compose valid requests\n\n- `assorted_requests` must be an object, never an array.\n- Include only requested sources. Do not add empty source requests.\n- Each ordinary source request must contain `metrics`; include `breakdowns` only when useful.\n- Keep at least one requested metric or breakdown for every included source.\n- Do not put Date, Week, Month, Quarter, or Year in `breakdowns`; use `time_granularity` instead.\n- Use multiple date-range pairs in one call when the user asks for several periods, including overlapping windows such as the last 30, 14, and 7 days.\n- Adzviser does not apply arbitrary report filters. Retrieve the fields needed to identify rows, then filter or calculate from the returned data.\n\nExample shape:\n\n```json\n{\n  \"adzviser_request\": {\n    \"workspace_name\": \"Workspace Name\",\n    \"date_ranges\": [[\"2026-08-01\", \"2026-08-20\"]],\n    \"time_granularity\": \"Date\",\n    \"assorted_requests\": {\n      \"google_ads_request\": {\n        \"metrics\": [\"Cost\", \"Clicks\"],\n        \"breakdowns\": [\"Campaign Name\"]\n      }\n    }\n  }\n}\n```\n\nThe field labels above illustrate structure only. Always obtain valid labels from the corresponding discovery tool.\n\n## Respect ChatGPT's result boundaries\n\n- `structuredContent` is model-visible and is the preferred basis for analysis. Do not claim the rows are inaccessible when they are present there.\n- `_meta` is hidden from the model. Never depend on it for analysis or describe it as returned report data.\n- Do not call the preview tool after a successful retrieval merely to display the same request.\n- Do not repeat an identical retrieval because a widget or follow-up message appears. Reuse model-visible rows already present in the conversation.\n- A successful response with zero rows is a valid no-data result. Report that clearly with the source and date range; do not silently switch modes or invent values.\n- If a field or request is rejected, refresh the relevant discovery tool output, correct the request once, and retry. Do not work around schema errors by adding internal parameters.\n\n## Produce a useful analysis\n\n- Distinguish facts in the rows from interpretations and recommendations.\n- For audits, check totals and the requested entity-level breakdowns before recommending changes.\n- For comparisons, calculate both absolute and percentage changes when denominators are valid; flag zero or missing baselines.\n- Preserve units and currency as returned. Do not assume currencies match across accounts or sources.\n- Mention assumptions supplied by Adzviser and any material limitations such as missing rows, partial periods, or unavailable fields.\n"
}

SHA-256: d5ab9b204747ba1feec30affe3c4c8f20b3e31fdf4b83d120e982caa9eec0145