Sponsor ads

Sponsor ads: available fields, filters, associations, and API operations.

Path: events/{event_id}/sponsor-ads
Methods: GET collection/record, POST, PATCH. There is no DELETE operation; use archived on PATCH.

GET

Fields: event-id, sponsor-id, pitch, image-url, cover-image-url, featured-tile-image-url, featured-tile-text, display-share, display-count, collection-display-count, archived-at, registrant-id, created-at, updated-at, clicks-count, unique-click-registrants-count, clicks-by-day.
Filters: sponsor_id, active, created_from, created_to.
Association: sponsor, linkage only.
Row restriction: by the sponsor association.

GET .../sponsor-ads?sponsor_id=103705&active=true

POST requires sponsor_id. Other inputs are pitch, featured_tile_text, display_share, image, cover_image, and featured_tile_image.

{
  "sponsor_id": 103705,
  "pitch": "Meet the team",
  "featured_tile_text": "Visit our booth",
  "display_share": 20,
  "image": "data:image/png;base64,..."
}

PATCH accepts pitch, featured_tile_text, display_share, image, cover_image, featured_tile_image, and archived.

{ "archived": true }

Archiving sets archived-at and forces display-share to zero. archived: false restores the record. Image inputs accept base64 data URIs; a blank image value on PATCH removes that image. Sponsor restrictions apply to reads and writes.