# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Snapchat Conversions Conversion Events API
  version: 1.0.0
extends: openapi/snapchat-conversion-events-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/{pixel_id}/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Send website conversion events to a Snap Pixel
      effect: write
      questions:
      - How do I send purchases and page views from my website to Snapchat server-side?
      - Can I report web add-to-cart and sign-up events against my Snap Pixel without the browser tag?
      - How many website conversion events can go in one request to my pixel?
      - Will Snap accept website events with timestamps from a few weeks ago?
      instructions:
      - text: 'Send these website conversion events to Snap Pixel {pixel_id}: {data}.'
        slots:
          pixel_id: path.pixel_id
          data: requestBody.data
      - text: Report yesterday's web purchases to pixel {pixel_id} using access token {access_token}.
        slots:
          pixel_id: path.pixel_id
          access_token: query.access_token
      - text: Upload a batch of site page view and add-to-cart events {data} to my Snap Pixel {pixel_id}.
        slots:
          data: requestBody.data
          pixel_id: path.pixel_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{snap_app_id}/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Send in-app conversion events for a Snap App
      effect: write
      questions:
      - How do I tell Snapchat about installs and in-app purchases from my mobile app?
      - Can I send level completions from my game to Snap as app conversion events?
      - What is the most app events I can batch into a single call for my Snap App ID?
      instructions:
      - text: 'Send these in-app conversion events to Snap App {snap_app_id}: {data}.'
        slots:
          snap_app_id: path.snap_app_id
          data: requestBody.data
      - text: Report today's app installs for Snap App ID {snap_app_id} using token {access_token}.
        slots:
          snap_app_id: path.snap_app_id
          access_token: query.access_token
      - text: Upload in-app purchase events {data} for my mobile app {snap_app_id}.
        slots:
          data: requestBody.data
          snap_app_id: path.snap_app_id
      method: generated
      generated: '2026-10-01'