Retail Media Reporting

Particular Audience's Retail Media platform offers comprehensive reporting capabilities that provide deep insights into your advertising campaigns. These reporting APIs allow you to measure performance, optimize your strategies, and demonstrate ROI to your stakeholders.

Available Reporting APIs

Campaign Metrics

Access comprehensive campaign-level metrics to evaluate overall performance and ROI for your advertising initiatives. These metrics provide a high-level view of how your campaigns are performing across all ad sets.

• Impressions, clicks, and CTR
• Spend and ROAS metrics
• Conversion metrics (views, add-to-carts, purchases)
• Attribution measurement

Explore Campaign Metrics

Ad Set Summary Metrics

Drill down into ad set performance to understand how different audience segments or product groups are performing. These summary metrics help you identify which ad sets are delivering the best results.

• Ad set performance comparison
• Budget utilization metrics
• Performance by targeting criteria
• Time-based performance analysis

Explore Ad Set Summary Metrics

Ad Set Details Metrics

Get granular insights into individual ad set performance with detailed metrics. This level of reporting provides the most comprehensive view of how specific ad sets are performing and where optimizations can be made.

• Product-level performance within ad sets
• Detailed placement effectiveness
• Creative performance metrics
• Advanced attribution analysis

Explore Ad Set Details Metrics

Common Reporting Parameters

All retail media reporting APIs support a common set of parameters that allow you to customize and filter your reports:

Parameter	Description	Example
startDate	Beginning of the reporting period	2023-01-01
endDate	End of the reporting period	2023-01-31
timeZone	Timezone for report data	America/New_York
groupBy	Dimension to group results by	day, week, adSet
campaignIds	Filter by specific campaigns	["camp_123", "camp_456"]
adSetIds	Filter by specific ad sets	["adset_789"]

Authentication

All reporting API requests require authentication using your API key. Include the API key in the request header:

Authorization: Bearer YOUR_API_KEY

Response Format

All reporting APIs return data in a consistent JSON format:

{
  "data": [
    {
      "campaignId": "camp_123",
      "campaignName": "Summer Sale",
      "impressions": 45000,
      "clicks": 1200,
      "ctr": 0.0267,
      "spend": 500.00,
      "purchases": 75,
      "purchaseValue": 3750.00,
      "roas": 7.5
    }
  ],
  "meta": {
    "startDate": "2023-01-01",
    "endDate": "2023-01-31",
    "totalCount": 1
  }
}

Best Practices

To get the most out of the retail media reporting APIs:

1. Use date ranges wisely: Choose appropriate time frames to identify trends and patterns in your data.
2. Compare periods: Look at week-over-week or month-over-month data to track improvements.
3. Segment your analysis: Use the groupBy parameter to view data from different perspectives.
4. Automate reporting: Set up regular API calls to automate your reporting workflows.
5. Look beyond clicks: Pay attention to conversion metrics to truly understand campaign effectiveness.

Next Steps

• Explore detailed documentation for each reporting API
• Learn about campaign setup to optimize your advertising
• Understand ASM integration for advanced ad management