activity feed

The Activity Feed shows a history of all actions taken by your guards, including when ads were paused, resumed, or when actions failed.

Understanding Activity Feed

The Activity Feed displays:

  • Guard Name - Which guard performed the action

  • Platforms - Which ad platforms were affected (Meta, Google Ads, or both)

  • Action - What happened (e.g., "Paused 5 ads", "Resumed 3 campaigns")

  • Reason - Why the action was taken (e.g., "Out of stock", "Days of cover: 2")

  • Time - When the action occurred

  • Status - Whether the action succeeded or failed

Activity Batches

Actions are grouped into batches:

  • Batch - A collection of related actions that happened together

  • Action Count - Number of entities successfully acted upon

  • Failed Count - Number of entities that failed to update

Viewing Batch Details

Click View on any activity entry to see:

  • Batch Information - Overall batch details (guard, platforms, reason, etc.)

  • Individual Actions - A table showing each entity that was acted upon

  • Results - Success or failure status for each action

  • Failure Reasons - Why specific actions failed (if any)

Action Types

Successful Actions

  • Paused - Ads were successfully paused

  • Resumed - Ads were successfully resumed

  • Takeover - Ads were taken over by SpendGuard (marked with a badge)

Failed Actions

Failed actions show why they couldn't be completed:

  • Not paused by SpendGuard - Entity was paused outside of SpendGuard and takeover is not enabled

  • Status update failed - The ad platform API returned an error

  • Connection error - Could not connect to the ad platform

  • Permission error - Insufficient permissions to modify the entity

Filtering and Sorting

The Activity Feed:

  • Prioritizes Failures - Batches with failures appear at the top

  • Hides Empty Actions - Batches with 0 successful and 0 failed actions are hidden

  • Sorts by Time - Most recent activity appears first

Understanding Failure Reasons

chevron-right"Not paused by SpendGuard"hashtag

This means:

  • The entity was paused manually or by another system.

  • SpendGuard cannot resume entities it didn't pause (unless takeover is enabled).

  • To fix: Enable takeover when creating/editing the guard.

chevron-right"Status update failed"hashtag

This means:

  • The ad platform API returned an error.

  • The entity may have been deleted or archived.

  • Platform-specific restrictions may apply.

chevron-right"Connection error"hashtag

This means:

  • Could not connect to the ad platform API.

  • The connection may be disconnected.

  • Check your connection status in Settings.

chevron-right"Permission error"hashtag

This means:

  • Insufficient permissions to modify the entity on the ad platform.

  • Verify account permissions and reauthorize if necessary.

Recent Activity on Dashboard

  • The dashboard shows the 5 most recent activities for a quick overview of recent guard actions.

  • Click View All to see the full activity feed.

  • The dashboard entries use the same format as the main Activity page.

circle-info

Best Practices

  • Review the activity feed regularly to ensure guards are working correctly.

  • Investigate failures by checking batch details to understand root causes.

  • Monitor takeover actions to ensure they're working as expected.

  • Check timing to verify actions occur when expected.

  • Creating Guards - How guards work

  • Takeover Behavior - Understanding takeover

  • Troubleshooting - Fixing common issues