Skip to main content

Asynchronous Analytics and Reporting

analyse_and_report_async is the asynchronous reporting method in Adstract. It analyzes the final LLM response after enhancement and sends acknowledgment payloads to Adstract using async transport.

Why this method is critical​

This method closes the full ad workflow cycle in async pipelines.

  • It confirms that the enhancement flow reached final output handling.
  • It submits the required acknowledgment data for reporting.
  • It is required for publisher-side monetization flow, because the reporting confirmation is part of how ad placement opportunity is accounted for.

Method signature​

await client.analyse_and_report_async(
    enhancement_result=result,
    llm_response=llm_response,
)

Inputs​

  • enhancement_result

    • Type: EnhancementResult
    • Meaning: Result returned from the enhancement method.
    • Role: Source object used for analytics/reporting context.

  • llm_response

    • Type: str
    • Meaning: Final text returned by your LLM.
    • Role: Content analyzed for ad usage and reporting metrics.

For result object details, see EnhancementResult.

Output​

This method returns None.

Behavior model​

The method flow is:

  1. Check whether enhancement succeeded.
  2. If enhancement did not succeed, reporting is skipped.
  3. If enhancement succeeded, build analytics and acknowledgment payload.
  4. Send the reporting payload to Adstract asynchronously.
  5. If analysis/reporting fails, attempt to send an error acknowledgment payload.
  6. Re-raise the original analysis/reporting exception after error reporting attempt.

Exception behavior​

Unlike fallback enhancement methods, analyse_and_report_async may raise.

  • If reporting/analysis fails, the method tries to submit an error reporting payload first.
  • After that attempt, it re-raises the original exception so callers can handle failure explicitly.

For full exception reference, see Exception.

Privacy and data-protection note​

The raw final LLM response text is not sent to the backend.

  • Reporting sends derived analytics and tracking metadata.
  • Sensitive content handling is minimized by design.
  • The flow is designed with privacy, safety, and data-protection constraints in mind.

Minimal async integration pattern​

import asyncio
from adstractai import Adstract
from adstractai.models import AdRequestConfiguration


async def main() -> None:
    client = Adstract(api_key="your-api-key")

    config = AdRequestConfiguration(
        session_id="session-abc",
        user_agent="Mozilla/5.0 (X11; Linux x86_64)",
        x_forwarded_for="203.0.113.10",
    )

    result = await client.request_ad_or_default_async(
        prompt="How can I improve user retention?",
        config=config,
    )

    llm_response = "Your final model output here"

    await client.analyse_and_report_async(
        enhancement_result=result,
        llm_response=llm_response,
    )

    await client.aclose()


asyncio.run(main())

Next steps​