---
updatedAt: 2026-08-25T12:13:04.000Z
agentTools:
  siteIndex: https://developers.liveramp.com/llms.txt
  projectIndex: https://developers.liveramp.com/authenticatedtraffic-api/llms.txt
---

# Send online conversion events (app)

Submit one or more app conversion events associated with an ATS configuration. Events are validated and routed to each enabled CAPI platform that supports the given event type.

**Timing rules:** - Do not send conversions that occurred more than 7 days ago. - Do not send conversions with a conversion date in the future.


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "LiveRamp Online Conversions API (CAPI) - App Events",
    "description": "Endpoint for sending online conversion events for **app** sources to LiveRamp's Online Conversions API program. LiveRamp translates these unified schema parameters into each supported ad platform's own event format (Meta, Pinterest, Snapchat, TikTok, Yahoo).\n\nField names in this spec use the **Universal Key** values documented in [Universal Events and Parameters for Online Conversions API Program](https://docs.liveramp.com/privacy-manager/en/universal-events-and-parameters-for-online-conversions-api.html).\n\nFor web events, see the companion spec: `online-capi-openapi-web.yaml`.\n",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api-ingest-console.liveramp.com"
    }
  ],
  "paths": {
    "/ingest/{ats_config_id}": {
      "post": {
        "summary": "Send online conversion events (app)",
        "description": "Submit one or more app conversion events associated with an ATS configuration. Events are validated and routed to each enabled CAPI platform that supports the given event type.\n\n**Timing rules:** - Do not send conversions that occurred more than 7 days ago. - Do not send conversions with a conversion date in the future.\n",
        "operationId": "sendOnlineConversionEventsApp",
        "tags": [
          "Online Conversions API - App"
        ],
        "parameters": [
          {
            "name": "ats_config_id",
            "in": "path",
            "required": true,
            "description": "The unique identifier of the ATS configuration that this event batch is associated with.",
            "schema": {
              "type": "string"
            },
            "example": "8f3a1c2d-4b5e-4a11-9c77-example12345"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/conversion_event_batch"
              },
              "example": {
                "events": [
                  {
                    "event_id": "evt_67897",
                    "event_name": "Purchase",
                    "event_source": "App",
                    "event_source_url": "https://example.com/confirmation",
                    "event_time": 1752505804,
                    "user_data": {
                      "envelope": "id_env",
                      "fb_envelope": "id_fb_envelope",
                      "gaid": "38400000-8cf0-11bd-b23e-10b96e40000d",
                      "ip_address": "192.0.2.100",
                      "user_agent": "Mozilla/5.0 (Linux; Android 10; SM-G960F)"
                    },
                    "custom_data": {
                      "content_ids": [
                        "item_123",
                        "item_456"
                      ],
                      "content_name": [
                        "Example Shoe",
                        "Example Hoodie"
                      ],
                      "content_type": [
                        "product"
                      ],
                      "content_category": [
                        "Apparel"
                      ],
                      "content_brand": [
                        "ExampleBrand"
                      ],
                      "order_id": [
                        "order_789"
                      ],
                      "currency": [
                        "USD"
                      ],
                      "value": [
                        "105.00"
                      ],
                      "num_items": [
                        "2"
                      ],
                      "limited_data_use": false,
                      "anon_id": [
                        "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                      ],
                      "contents": [
                        {
                          "item_id": [
                            "item_123"
                          ],
                          "item_price": [
                            "55.00"
                          ],
                          "item_quantity": [
                            "1"
                          ],
                          "item_name": [
                            "Example Shoe"
                          ],
                          "item_brand": [
                            "ExampleBrand"
                          ],
                          "item_category": [
                            "Footwear"
                          ]
                        },
                        {
                          "item_id": [
                            "item_456"
                          ],
                          "item_price": [
                            "50.00"
                          ],
                          "item_quantity": [
                            "1"
                          ],
                          "item_name": [
                            "Example Hoodie"
                          ],
                          "item_brand": [
                            "ExampleBrand"
                          ],
                          "item_category": [
                            "Clothing"
                          ]
                        }
                      ]
                    },
                    "app_data": {
                      "advertiser_tracking_enabled": "true",
                      "application_tracking_enabled": "true",
                      "app_id": "1",
                      "app_name": "CAPI",
                      "device_type": "Motorola",
                      "device_brand": "Motorola",
                      "language": "en",
                      "wifi": "false",
                      "extinfo_version": "android",
                      "app_pack_name": "com.some.app",
                      "short_version": "771",
                      "long_version": "Version 7.7.1",
                      "os_version": "10.1.1",
                      "device_model": "OnePlus6",
                      "locale": "en_US",
                      "timezone_abbr": "GMT-1",
                      "carrier": "TMobile",
                      "screen_width": "1920",
                      "screen_height": "1080",
                      "screen_density": "2.00",
                      "cpu_core": "2",
                      "ext_storage_size": "128",
                      "free_space": "8",
                      "device_timezone": "USA/New York",
                      "form_factor": "cellphone",
                      "network_type": "wifi",
                      "os_family": "android"
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Event call processed. The response includes a REQUEST_ID that can be used to look up this specific event call for debugging purposes.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ingest_response"
                },
                "example": {
                  "REQUEST_ID": [
                    "cc07bb43-8f5e-43c0-970f-2a6b7b81d4c2"
                  ],
                  "providers": {
                    "data": {}
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "conversion_event_batch": {
        "type": "object",
        "required": [
          "events"
        ],
        "properties": {
          "events": {
            "type": "array",
            "description": "One or more app conversion events to send in this request.",
            "items": {
              "$ref": "#/components/schemas/event"
            }
          }
        }
      },
      "event": {
        "type": "object",
        "description": "A single app conversion event.",
        "required": [
          "event_id",
          "event_name",
          "event_source",
          "event_source_url",
          "event_time",
          "app_data"
        ],
        "properties": {
          "event_id": {
            "type": "string",
            "description": "A unique string that identifies the event and can be used for deduplication between events.",
            "example": "evt_67897"
          },
          "event_name": {
            "type": "string",
            "description": "The event type key. Must be one of the universal event types that support app as an event source. Each event is only sent to the ad platforms that support it (see table below).\n\n| Event | Supported Platforms |\n| --- | --- |\n| AchieveLevel | TikTok, Yahoo |\n| AchievementUnlocked | Snapchat, TikTok, Yahoo |\n| AddBilling | Snapchat, Yahoo |\n| AddPaymentInfo | Meta, Pinterest, TikTok, Yahoo |\n| AddToCart | Amazon, Meta, OpenAI, Pinterest, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo |\n| AddToWishlist | Meta, Pinterest, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo |\n| AdClick | Snapchat, Yahoo |\n| AdView | Snapchat, Yahoo |\n| AppInstall | OpenAI, Pinterest, Snapchat, TikTok, Yahoo |\n| AppOpen | OpenAI, Snapchat, TikTok, Yahoo |\n| Checkout | TikTok, Yahoo |\n| CompleteRegistration | Amazon, Meta, Pinterest, Reddit, Snapchat, TikTok, Yahoo |\n| CompleteTutorial | TikTok, Snapchat, Yahoo |\n| ConvertedLead | Yahoo |\n| CreateGroup | TikTok, Yahoo |\n| CreateRole | TikTok, Yahoo |\n| Donate | Meta, Yahoo |\n| Engagement | Yahoo |\n| GenerateLead | TikTok, Yahoo |\n| ImportedLead | Yahoo |\n| InAppAdClick | TikTok, Yahoo |\n| InAppAdImpr | TikTok, Yahoo |\n| Invite | Snapchat, Yahoo |\n| JoinGroup | TikTok, Yahoo |\n| Lead | Meta, OpenAI, Pinterest, Amazon, Reddit, Yahoo |\n| LevelComplete | Snapchat, Yahoo |\n| ListView | Snapchat, Yahoo |\n| LoanApplication | TikTok, Yahoo |\n| LoanApproval | TikTok, Yahoo |\n| LoanDisbursal | TikTok, Yahoo |\n| Login | Snapchat, TikTok, The Trade Desk, Yahoo |\n| Other | Amazon, Yahoo |\n| OutboundClick | Yahoo |\n| PageView | Amazon, Meta, OpenAI, Pinterest, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo |\n| Purchase | Amazon, Meta, OpenAI, Pinterest, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo |\n| QualifiedLead | Yahoo |\n| Rate | Snapchat, Yahoo |\n| Registration | OpenAI, TikTok, Yahoo |\n| RequestQuote | Yahoo |\n| Reserve | Snapchat, Yahoo |\n| Save | Snapchat, Yahoo |\n| Search | Amazon, Meta, Pinterest, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo |\n| SearchCategory | The Trade Desk, Yahoo |\n| Share | Snapchat, Yahoo |\n| SpentCredits | Snapchat, TikTok, Yahoo |\n| StartTrial | Meta, OpenAI, Snapchat, TikTok, Yahoo |\n| StoreSale | Yahoo |\n| StoreVisit | Yahoo |\n| SubmitForm | TikTok, Yahoo |\n| Subscribe | Amazon, Meta, OpenAI, Pinterest, Snapchat, TikTok, Yahoo |\n| ViewCart | The Trade Desk, Yahoo |\n| ViewCategory | Pinterest, Yahoo |\n| ViewContent | Meta, OpenAI, Pinterest, Snapchat, TikTok, The Trade Desk, Yahoo |\n| WatchVideo | Pinterest, Yahoo |",
            "enum": [
              "AchieveLevel",
              "AchievementUnlocked",
              "AddBilling",
              "AddPaymentInfo",
              "AddToCart",
              "AddToWishlist",
              "AdClick",
              "AdView",
              "AppInstall",
              "AppOpen",
              "Checkout",
              "CompleteRegistration",
              "CompleteTutorial",
              "ConvertedLead",
              "CreateGroup",
              "CreateRole",
              "Donate",
              "Engagement",
              "GenerateLead",
              "ImportedLead",
              "InAppAdClick",
              "InAppAdImpr",
              "Invite",
              "JoinGroup",
              "Lead",
              "LevelComplete",
              "ListView",
              "LoanApplication",
              "LoanApproval",
              "LoanDisbursal",
              "Login",
              "Other",
              "OutboundClick",
              "PageView",
              "Purchase",
              "QualifiedLead",
              "Rate",
              "Registration",
              "RequestQuote",
              "Reserve",
              "Save",
              "Search",
              "SearchCategory",
              "Share",
              "SpentCredits",
              "StartTrial",
              "StoreSale",
              "StoreVisit",
              "SubmitForm",
              "Subscribe",
              "ViewCart",
              "ViewCategory",
              "ViewContent",
              "WatchVideo"
            ],
            "example": "Purchase"
          },
          "event_source": {
            "type": "string",
            "description": "Where the event occurred.",
            "enum": [
              "app"
            ],
            "example": "App"
          },
          "event_source_url": {
            "type": "string",
            "format": "uri",
            "description": "The browser URL when the event happened.",
            "example": "https://example.com/confirmation"
          },
          "event_time": {
            "type": "integer",
            "format": "int64",
            "description": "The date/time of the event as a Unix timestamp in seconds. Must not be in the future. Must not be more than 7 days ago.\n",
            "example": 1752505804
          },
          "user_data": {
            "$ref": "#/components/schemas/user_data"
          },
          "custom_data": {
            "$ref": "#/components/schemas/custom_data"
          },
          "app_data": {
            "$ref": "#/components/schemas/app_data"
          }
        }
      },
      "user_data": {
        "type": "object",
        "description": "Identifier data used to enrich events and improve match rates. Recommended for all events, especially upper-funnel events (e.g. PageView, ViewContent, Search) that often lack identifiers.\n",
        "properties": {
          "envelope": {
            "type": "string",
            "description": "Identity envelope value. If pulled from storage, the value must be Base64-decoded before sending."
          },
          "fb_envelope": {
            "type": "string",
            "description": "Facebook-scoped envelope value. If pulled from storage, the value must be Base64-decoded before sending."
          },
          "gaid": {
            "type": "string",
            "description": "Advertising identifier for Android devices."
          },
          "idfa": {
            "type": "string",
            "description": "Advertising identifier for iOS devices."
          },
          "idvf": {
            "type": "string",
            "description": "Vendor identifier assigned to apps on iOS devices."
          },
          "user_agent": {
            "type": "string",
            "description": "The user agent from the user's device where the event occurred. If not present in the payload, the adapter will retrieve it from the request header.\n"
          },
          "ip_address": {
            "type": "string",
            "description": "The IP address of the user's device. If not present in the payload, the adapter will retrieve it from the request header.\n"
          }
        }
      },
      "custom_data": {
        "type": "object",
        "description": "Additional event and transaction-level data. Recommended parameters improve conversion data accuracy; optional parameters add further context.\n\n**Note:** `currency` and `value` are required whenever `event_name` is `Purchase`.",
        "properties": {
          "content_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The product IDs (or SKUs) associated with the event.\n\n**Supported platforms:** Meta, Pinterest, Snapchat, TikTok"
          },
          "content_category": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The category of the product.\n\n**Supported platforms:** Meta, Pinterest, Snapchat"
          },
          "content_name": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The name of the product.\n\n**Supported platforms:** Meta, Pinterest, Snapchat"
          },
          "content_type": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Indicates what the content IDs represent (individual item vs. multiple items in a group).\n\n**Supported platforms:** Meta, Snapchat, TikTok"
          },
          "currency": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "ISO 4217 code of the currency associated with the value.\n\n**Required for `Purchase` events.**\n\n**Supported platforms:** Amazon, Meta, OpenAI, Pinterest, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo"
          },
          "email": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The user's email address.\n**Required by OpenAI to allow matching.**\n**Supported platforms:** Meta, OpenAI, Reddit"
          },
          "num_items": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The number of items the user has during checkout.\n\n**Supported platforms:** Amazon, Meta, Pinterest, Reddit, Snapchat, TikTok"
          },
          "order_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "A string ID for this specific transaction.\n\n**Supported platforms:** Meta, Pinterest, Snapchat, TikTok, The Trade Desk, Yahoo"
          },
          "description": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "A string description of the product.\n\n**Supported platforms:** TikTok"
          },
          "phone_number": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The user's phone number.\n\n**Supported platforms:** Meta, Reddit"
          },
          "predicted_ltv": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The predicted lifetime value of a conversion event (stringified float).\n\n**Supported platforms:** Meta, Snapchat"
          },
          "search_string": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The text that was used for the search event.\n\n**Supported platforms:** Meta, Pinterest, Snapchat, TikTok"
          },
          "value": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Total value of items with the item_price attribute within the contents object (basket-level value), stringified float.\n\n**Required for `Purchase` events.**\n\n**Supported platforms:** Amazon, Meta, OpenAI, Pinterest, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo"
          },
          "content_brand": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The brand associated with the content ID.\n\n**Supported platforms:** Pinterest"
          },
          "event_tag": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Custom event set label.\n\n**Supported platforms:** Snapchat"
          },
          "shop_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The shop ID.\n\n**Supported platforms:** TikTok"
          },
          "first_name": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The user's first name.\n\n**Supported platforms:** Meta"
          },
          "last_name": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The user's last name.\n\n**Supported platforms:** Meta"
          },
          "zip_code": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The user's zip code.\n\n**Supported platforms:** Meta, OpenAI, The Trade Desk"
          },
          "date_of_birth": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The user's date of birth.\n\n**Supported platforms:** Meta"
          },
          "gender": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The user's gender.\n\n**Supported platforms:** Meta, Pinterest, Snapchat"
          },
          "city": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The city associated with the event.\n\n**Supported platforms:** Meta, OpenAI, Pinterest, Snapchat, TikTok, The Trade Desk"
          },
          "country": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The country associated with the event.\n\n**Supported platforms:** Amazon, Meta, OpenAI, Pinterest, Snapchat, TikTok, The Trade Desk, Yahoo"
          },
          "state": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The state associated with the event.\n\n**Supported platforms:** Meta, Pinterest, Snapchat, TikTok, The Trade Desk, Yahoo"
          },
          "fb_login_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The App-Scoped ID issued by Meta when a person first logs into an instance of an app.\n\n**Supported platforms:** Meta"
          },
          "lead_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The ID associated with a lead.\n\n**Supported platforms:** Meta, Snapchat"
          },
          "subscription_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The subscription ID of the user in the event.\n\n**Supported platforms:** Meta, Snapchat"
          },
          "anon_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Unique application install ID.\n\n**Supported platforms:** Meta, Snapchat"
          },
          "limited_data_use": {
            "type": "boolean",
            "description": "Data processing options to enable for specific events, to help comply with various US state privacy regulations.\n\n**Supported platforms:** Amazon, Meta, OpenAI, Pinterest, Reddit, Snapchat, TikTok, Yahoo",
            "example": false
          },
          "contents": {
            "type": "array",
            "description": "SKU-level detail for each individual item in the event.",
            "items": {
              "$ref": "#/components/schemas/content"
            }
          }
        }
      },
      "content": {
        "type": "object",
        "description": "Detail for a single item within the \"contents\" array.",
        "required": [
          "item_id"
        ],
        "properties": {
          "item_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Unique ID of the individual item. Required if contents is used.\n\n**Supported platforms:** Meta, Pinterest, OpenAI, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo"
          },
          "item_price": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Price of the individual item (stringified float).\n\n**Supported platforms:** Meta, Pinterest, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo"
          },
          "item_quantity": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Quantity of the individual item (stringified integer).\n\n**Supported platforms:** Meta, Pinterest, OpenAI, Reddit, Snapchat, TikTok, The Trade Desk, Yahoo"
          },
          "item_name": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Name of the individual item or page.\n\n**Supported platforms:** OpenAI, Pinterest, Reddit, TikTok, The Trade Desk, Yahoo"
          },
          "item_brand": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Brand of the individual item.\n\n**Supported platforms:** Meta, Pinterest, Snapchat, TikTok, Yahoo"
          },
          "item_brand_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Brand ID of the individual item.\n\n**Supported platforms:** Pinterest"
          },
          "item_category": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Product category of the individual item.\n\n**Supported platforms:** OpenAI, Pinterest, Reddit, TikTok, The Trade Desk, Yahoo"
          },
          "item_subcategory": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Sub-category of the individual item.\n\n**Supported platforms:** Yahoo"
          }
        }
      },
      "app_data": {
        "type": "object",
        "description": "Required for app events in addition to the standard required event data. All fields listed below must be present as keys in the app_data object, but not all fields require a value — pass an empty string (\"\") for fields that don't require a value. See each field's description for whether a value is required.",
        "required": [
          "advertiser_tracking_enabled",
          "application_tracking_enabled",
          "app_id",
          "app_name",
          "device_type",
          "device_brand",
          "language",
          "wifi",
          "extinfo_version",
          "app_pack_name",
          "short_version",
          "long_version",
          "os_version",
          "device_model",
          "locale",
          "timezone_abbr",
          "carrier",
          "screen_width",
          "screen_height",
          "screen_density",
          "cpu_core",
          "ext_storage_size",
          "free_space",
          "device_timezone",
          "form_factor",
          "network_type",
          "os_family"
        ],
        "properties": {
          "advertiser_tracking_enabled": {
            "type": "string",
            "description": "Use this field to specify ATT permission on an iOS 14.5+ device. Set value to \"true\" or \"false\" to indicate an opt-in or opt-out.\n**Value required**\n\n**Supported platforms:** Meta, Pinterest, Snapchat, TikTok",
            "example": "true"
          },
          "application_tracking_enabled": {
            "type": "string",
            "description": "Use this field to specify the user's choice regarding tracking on an app level. Set value to \"true\" or \"false\" to indicate an opt-in or opt-out.\n**Value required**\n\n**Supported platforms:** Meta",
            "example": "true"
          },
          "app_id": {
            "type": "string",
            "description": "The unique ID assigned for a given application.\n\n**Supported platforms:** Pinterest, Snapchat, TikTok",
            "example": "1"
          },
          "app_name": {
            "type": "string",
            "description": "Name of the app.\n\n**Supported platforms:** Pinterest",
            "example": "CAPI"
          },
          "device_type": {
            "type": "string",
            "description": "Type of the user device.\n\n**Supported platforms:** Pinterest",
            "example": "Motorola"
          },
          "device_brand": {
            "type": "string",
            "description": "Brand of the user device.\n\n**Supported platforms:** Pinterest",
            "example": "Motorola"
          },
          "language": {
            "type": "string",
            "description": "Two-character ISO-639-1 language code indicating the user's language.\n\n**Supported platforms:** Pinterest",
            "example": "en"
          },
          "wifi": {
            "type": "string",
            "description": "Whether the event occurred when the user device was connected to wifi.\n\n**Supported platforms:** Pinterest",
            "example": "false"
          },
          "extinfo_version": {
            "type": "string",
            "description": "Device version. Value can be `ios` or `android`.\n**Value required**\n**Supported platforms:** Meta, Snapchat",
            "example": "Android"
          },
          "app_pack_name": {
            "type": "string",
            "description": "App package name. Example: com.liveramp.sdk.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "com.some.app"
          },
          "short_version": {
            "type": "string",
            "description": "App version (short). Example: 1.0.\n\n**Supported platforms:** Meta, Snapchat",
            "example": "771"
          },
          "long_version": {
            "type": "string",
            "description": "App version (long). Example: 1.0 long.\n\n**Supported platforms:** Meta, Pinterest, Snapchat, TikTok",
            "example": "Version 7.7.1"
          },
          "os_version": {
            "type": "string",
            "description": "The OS version. Example: 13.4.1.\n**Value required**\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "10.1.1"
          },
          "device_model": {
            "type": "string",
            "description": "Device model name. Example: iPhone13.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "OnePlus6"
          },
          "locale": {
            "type": "string",
            "description": "The device's region. Example: En_US.\n\n**Supported platforms:** Meta, Pinterest, Snapchat, TikTok",
            "example": "en_US"
          },
          "timezone_abbr": {
            "type": "string",
            "description": "Timezone abbreviation. Example: PDT.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "GMT-1"
          },
          "carrier": {
            "type": "string",
            "description": "The device data carrier. Example: AT&T.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "TMobile"
          },
          "screen_width": {
            "type": "string",
            "description": "The device's screen width. Example: 320.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "1920"
          },
          "screen_height": {
            "type": "string",
            "description": "The device's screen height. Example: 568.\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "1080"
          },
          "screen_density": {
            "type": "string",
            "description": "The device's screen density. Example: 2.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "2.00"
          },
          "cpu_core": {
            "type": "string",
            "description": "The CPU core. Example: 2. Field required, value optional.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "2"
          },
          "ext_storage_size": {
            "type": "string",
            "description": "The external storage size in GB. Example: 13.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "128"
          },
          "free_space": {
            "type": "string",
            "description": "The free space on the external storage in GB. Example: 8.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "8"
          },
          "device_timezone": {
            "type": "string",
            "description": "The device's time zone. Example: USA/New York.\n\n**Supported platforms:** Meta, Pinterest, Snapchat",
            "example": "USA/New York"
          },
          "form_factor": {
            "type": "string",
            "description": "Device form factor. Example: cellphone.\n\n**Supported platforms:** Pinterest",
            "example": "cellphone"
          },
          "network_type": {
            "type": "string",
            "description": "The device's network type or capability. Example: 4G, 5G.\n\n**Supported platforms:** Pinterest",
            "example": "wifi"
          },
          "os_family": {
            "type": "string",
            "description": "The device's OS family. Example: ios.\n\n**Supported platforms:** Pinterest",
            "example": "android"
          }
        }
      },
      "ingest_response": {
        "type": "object",
        "description": "Response returned for the event call. Contains a request ID that can be used to look up this specific call for debugging purposes.\n",
        "properties": {
          "REQUEST_ID": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Unique identifier(s) for this event call, used for debugging and support lookups.",
            "example": [
              "cc07bb43-8f5e-43c0-970f-2a6b7b81d4c2"
            ]
          },
          "providers": {
            "type": "object",
            "description": "Platform-level response data returned by each enabled CAPI provider.",
            "properties": {
              "data": {
                "type": "object",
                "description": "Per-provider response details. Structure varies by provider."
              }
            }
          }
        }
      }
    }
  }
}
```