Ad Squad Outcomes

The Ad Squad outcome estimation endpoint takes in a list of adsquads and returns daily and/or weekly estimates of reach/conversions/impressions as well as how much of the budget would be left over.

Create an Ad Squad Outcome Request

curl -X POST -H "Content-Type: application/json" \
  -H "Authorization: Bearer meowmeowmeow" \
  -d '{"ad_squad_outcome_estimates_v2":[{"placement_v2":{"config":"CUSTOM","inclusion":{"premium_content_bundle_ids":["1856c724-7cec-4139-a8a8-b87fc609f13e"]},"platforms":["SNAPCHAT"],"snapchat_positions":["INSTREAM"]},"status":"ACTIVE","type":"SNAP_ADS","targeting":{"geos":[{"country_code":"uk"}],"demographics":[{"min_age":"18"}],"enable_targeting_expansion":true,"auto_expansion_options":{"interest_expansion_option":{"enabled":true},"custom_audience_expansion_option":{"enabled":true}}},"bid_strategy":"AUTO_BID","daily_budget_micro":50000000,"delivery_constraint":"DAILY_BUDGET","start_time":"2024-11-05T11:58:03.794Z","optimization_goal":"IMPRESSIONS","forced_view_setting":"FULL_DURATION","estimate_ad_types":["SNAP_AD","REMOTE_WEBPAGE","APP_INSTALL","AD_TO_LENS"],"pixel_id":"5eda10b7-a5fe-4ac6-80f4-417e68d748"}]}' \
   "https://adsapi.snapchat.com/v1/adaccounts/22225ba6-7559-4000-9663-bace8adff5f2/ad_squad_outcome_estimates_v2?has_no_ads=true&source_currency=USD"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "2f0906a2-9ff8-4f8a-8faa-169436aba563",
  "ad_squad_outcome_estimates_v2": [
    {
      "sub_request_status": "SUCCESS",
      "ad_squad_outcome_estimate_v2": {
        "request_id": "a7602cc2-bc83-463c-83a1-00bba986b046",
        "message": "",
        "error_code": "",
        "daily": {
          "conversions_lower": 3300,
          "conversions_upper": 9700,
          "reaches_lower": 3300,
          "reaches_upper": 9700,
          "impressions_lower": 3300,
          "impressions_upper": 9700,
          "is_budget_hit": true,
          "budget_left": 0.0,
          "budget_spent_ratio": 1.0
        },
        "weekly": {
          "conversions_lower": 23000,
          "conversions_upper": 68000,
          "reaches_lower": 22000,
          "reaches_upper": 66000,
          "impressions_lower": 23000,
          "impressions_upper": 68000,
          "is_budget_hit": true,
          "budget_left": 0.0,
          "budget_spent_ratio": 1.0
        },
        "use_case": "HAS_NO_ADS"
      }
    }
  ]
}

HTTP Request

POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/ad_squad_outcome_estimates_v2?has_no_ads={has_no_ads}&source_currency={source_currency}

Request Parameters

Parameter	Required	Description	Possible Values
ad_account_id	Yes	Ad Account ID
has_no_ads			true
source_currency			USD, GBP, etc.

Body Parameters

Parameter	Required	Description
ad_squad_outcome_estimates_v2	Yes	An array of Ad Squad descriptions.