> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Glossary

> Complete reference of retail media terminology covering auctions, campaigns, metrics, ROAS, attribution models, and ad optimization strategies

export const IntegrationsCard1A = () => {
  return <>
      <style>{`
        .integrations-card-1a {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: nowrap;
        }

        .integrations-card-1a-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a p {
          color: #d1d5db;
        }

        .integrations-card-1a a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a a {
          color: #8280ff;
        }

        .dark .integrations-card-1a a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a">
        <div className="integrations-card-1a-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="Agustin - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="Amelia - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="Bernardita - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="Borumy - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="Felipe - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/gui.webp" alt="Gui - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="Javiera - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/linn.webp" alt="Linn - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="Marcio - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="Mateus - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/max.webp" alt="Max - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="Rodrigo - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
        </div>

        <h2>Need help with your Topsort integration?</h2>

        <p className="integrations-card-1a-subtitle">
          Talk to us, the integrations engineering team.
        </p>

        <p>
          Reach us via <strong>your dedicated messaging channel</strong> or at{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          If you're not a customer yet,{" "}
          <a href="https://www.topsort.com/book-a-demo">book a demo</a> with our
          sales team instead.
        </p>
      </div>
    </>;
};

This glossary provides definitions for common terms used in retail media advertising and campaign management.

## Core Concepts

<CardGroup cols={2}>
  <Card title="Catalog" icon="box">
    The catalog contains the items that will be promoted by advertisers. For retailers, these are products sold by 1P and 3P sellers.
  </Card>

  <Card title="Campaign" icon="bullhorn">
    Tools used by advertisers to promote products, enabling them to promote their catalog on the retailer's platform.
  </Card>

  <Card title="Auction" icon="gavel">
    Every promoted item in a campaign is eligible for auctions. An auction requests the best options to fill a placement, considering optimization parameters for advertiser performance and retailer financial goals.
  </Card>

  <Card title="Attribution" icon="link">
    Purchases made by shoppers who interacted with an ad are attributed to campaigns. Parameters include attribution window and model (last click, multi-touch, etc).
  </Card>
</CardGroup>

## General Terms

<AccordionGroup>
  <Accordion title="Ad Type">
    The format or style of an advertisement. Common types include: Sponsored Listings, Banner Ads, Video Ads, Native Ads, etc.
  </Accordion>

  <Accordion title="Attribution Window">
    The period of time in which conversions or sales are attributed to an ad. Varies by ad format: 7-14 days for Sponsored Listings, 14-30 days for Sponsored Brands, 14-30 days for Banner/Video Ads.
  </Accordion>

  <Accordion title="Device Type">
    The type of device where the ad is viewed or interacted with: Mobile Web, Desktop, or App.
  </Accordion>

  <Accordion title="Placement / Ad Slot">
    The specific location where the ad is displayed within a retail platform (e.g., homepage, search results, product pages).
  </Accordion>

  <Accordion title="Keyword / Search Term">
    Words or phrases used by customers in search queries that trigger ad placement (e.g., "running shoes," "laptop accessories").
  </Accordion>

  <Accordion title="EAS (External Asset String)">
    Internal term for the unique identifier of a product in your catalog. Also called Product ID or SKU. In the API, this is the `id` field in product objects.
  </Accordion>

  <Accordion title="Opaque User ID">
    An anonymized user identifier used when you cannot share actual user IDs. Must be consistent across events for the same user session to enable attribution.
  </Accordion>

  <Accordion title="SIVT (Sophisticated Invalid Traffic)">
    Fraudulent or bot traffic that should be filtered from reporting. Marketplaces are responsible for filtering SIVT before sending events to Topsort.
  </Accordion>
</AccordionGroup>

## Performance Metrics

<AccordionGroup>
  <Accordion title="Impressions">
    The total number of times an ad is shown to users.
  </Accordion>

  <Accordion title="Clicks (Charged/Billable)">
    The number of times users clicked on an ad for which an advertiser will be billed.
  </Accordion>

  <Accordion title="Click-Through Rate (CTR)">
    The percentage of impressions that result in clicks. **Formula:** CTR = (Clicks ÷ Impressions) × 100
  </Accordion>

  <Accordion title="Average CPC">
    The average cost per click. **Formula:** Average CPC = Total Ad Spend ÷ Total Clicks
  </Accordion>

  <Accordion title="Total Ad Spend">
    The total cost of the campaign, including all ad clicks and associated charges.
  </Accordion>

  <Accordion title="Sales ($)">
    The total revenue generated from purchases as a result of the ad campaign.
  </Accordion>

  <Accordion title="Orders (Transactions)">
    The total number of completed orders resulting from clicks on the ad.
  </Accordion>

  <Accordion title="Units Sold">
    The total number of individual items sold as a result of the ad campaign.
  </Accordion>

  <Accordion title="Conversion Rate">
    The percentage of users who completed a purchase after clicking on the ad. **Formula:** Conversion Rate = (Sales ÷ Clicks) × 100
  </Accordion>
</AccordionGroup>

## Advanced Metrics

<AccordionGroup>
  <Accordion title="Total ROAS (Return on Ad Spend)">
    The total revenue generated per dollar spent on ads. **Formula:** ROAS = Sales ÷ Total Ad Spend

    A ROAS of 3.0 means $3 in revenue for every $1 spent on advertising.
  </Accordion>

  <Accordion title="Same SKU Click ROAS">
    The ROAS for the same product (SKU) that was clicked. Tracks revenue generated per dollar spent specifically on the clicked SKU.
  </Accordion>

  <Accordion title="Same BRAND Click ROAS (Halo)">
    The ROAS for products from the same brand that were clicked. Used to track brand lift and halo effects.
  </Accordion>
</AccordionGroup>

## Cost & Pricing Models

<AccordionGroup>
  <Accordion title="Cost Per Mille (CPM)">
    The cost per thousand impressions. A pricing model where advertisers pay for every 1,000 times their ad is shown.

    **Formula:** CPM = (Total Ad Spend ÷ Impressions) × 1,000
  </Accordion>

  <Accordion title="Cost Per Click (CPC)">
    The cost an advertiser pays each time a user clicks on their ad. A performance-based pricing model where payment occurs only when the ad is clicked.

    **Formula:** CPC = Total Ad Spend ÷ Total Clicks
  </Accordion>

  <Accordion title="Cost Per Acquisition (CPA)">
    The cost to acquire a customer through an ad campaign.

    **Formula:** CPA = Total Ad Spend ÷ Conversions (Sales)
  </Accordion>

  <Accordion title="Average Order Value (AOV)">
    The average value of an order generated from an ad click.

    **Formula:** AOV = Sales ÷ Orders
  </Accordion>

  <Accordion title="Average Ad Rank">
    The average position of an ad relative to other ads in a given placement. Higher rank means better visibility.
  </Accordion>

  <Accordion title="Share of Voice (SOV)">
    The percentage of total ad impressions captured by a brand versus competitors.

    **Formula:** SOV = (Your Impressions ÷ Total Market Impressions) × 100
  </Accordion>
</AccordionGroup>

## Attribution Models

<AccordionGroup>
  <Accordion title="Last Click Attribution">
    Attribution model where the final ad click before a purchase is credited with the sale. Most common model for direct response campaigns.
  </Accordion>

  <Accordion title="Multi-Touch Attribution">
    Attribution model where credit is given to multiple touchpoints throughout the customer journey. Useful for understanding the full path to purchase.
  </Accordion>

  <Accordion title="View-Through Attribution (VTA)">
    Attribution model where credit is given to ads shown but not clicked, influencing a purchase after the fact. Common for awareness campaigns.
  </Accordion>

  <Accordion title="Halo Attribution">
    Attribution model where a vendor receives credit when a user clicks on Product A but purchases Product B from the same vendor. Requires `vendorId` in purchase events.
  </Accordion>

  <Accordion title="Resolved Bid ID">
    The unique identifier returned from an auction that connects events (impressions, clicks, purchases) back to the winning bid for attribution purposes.
  </Accordion>
</AccordionGroup>

## Campaign Management

<AccordionGroup>
  <Accordion title="Bid Adjustments">
    Changes made to bids to optimize ad placement, typically based on factors like time of day, device type, location, or keyword performance.
  </Accordion>

  <Accordion title="Budget Allocation">
    The distribution of ad spend across different campaigns, keywords, or placements to maximize ROI.
  </Accordion>

  <Accordion title="Average Ad Spend (Per Campaign)">
    The average total spend across all campaigns or ads.

    **Formula:** Average Ad Spend = Total Ad Spend ÷ Number of Campaigns
  </Accordion>

  <Accordion title="SKU # / Product Identifier #">
    The unique product identifier (e.g., SKU, UPC, or ASIN) associated with the product(s) being advertised.
  </Accordion>

  <Accordion title="Creative Size">
    The dimensions and format of the ad creative (e.g., 970x90, 300x250 pixels for banner ads, 16:9 for video ads).
  </Accordion>
</AccordionGroup>

## Ad Formats

<AccordionGroup>
  <Accordion title="Sponsored Listings">
    Ads that appear within product search results or category pages, typically appearing as "sponsored" or "promoted" products. High purchase intent format.
  </Accordion>

  <Accordion title="Banner Ads (Display / Audience Ads)">
    Ads displayed in fixed sections of a webpage, such as at the top, side, or bottom of the page. Used for awareness and discovery.
  </Accordion>

  <Accordion title="Native Ads">
    Ads designed to blend seamlessly with the content of the website or platform, making them look like part of the organic content (e.g., sponsored articles).
  </Accordion>

  <Accordion title="Carousel Ads">
    A type of ad that allows multiple products to be displayed in a sliding format. Often used for showcasing different product variations or collections.
  </Accordion>

  <Accordion title="Dynamic Retargeting">
    Ads targeted at users who have previously interacted with the brand or product but have not yet converted.
  </Accordion>
</AccordionGroup>

<IntegrationsCard1A />
