--- title: "Query given Campaigns' setting overview" method: GET path: "/cm/v1/campaign-overviews" tags: ["Campaign"] --- # Query given Campaigns' setting overview `GET /cm/v1/campaign-overviews` Retrieve not only Campaign itself but all the entities related to the Campaign ## Query parameters - `ad_account_id` string, required - `product_id` string, required - `campaign_ids` string[], required ## Response `200` A successful response. - MessagesQueryCampaignOverviewsResponse - `ad_account` DspAdAccount — AdAccount represents a person or organization who owns Products and aims to promote the Products with advertising Campaigns. - `id` string — Unique identifier of the AdAccount. Automatically set by server on creation. - `title` string, required — A descriptive name of the AdAccount. - `description` string — An optional description of the AdAccount. - `timezone` string — [IANA timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) name. e.g. America/Los_Angeles. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `custom_key_values` object — Custom key/values managed by the Moloco Ads client platform. It's up to the client ads platform to define the schema for the values and their optionality. The keys are recommended, but not required, to be prefixed with the reversed internet domain of the AdCloud client platform company. For example, keys defined by the client ads platform company "example.com" should have "com.example." as the prefix. For complex values, JSON payload is recommended. Moloco doesn't interpret these data in any way for ads serving. Upon serving, the custom key/values in the AdAccount, Campaign, and Creative models will be combined into the serving Creative proto in the order of precedence, with Creative's value having the highest precedence on the same key. - `billing_account_id` string — BillingAccount to be applied by default. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `targets_future_preferences` object — targets_future_preferences maps each target_id to corresponding TargetFuturePreferenceInfo. - `product` DspProduct — Product represents an app (per device OS) or a website that an AdAccount want to promote with a Campaign. A Campaign should be associated with a single Product. - `id` string — Unique identifier of the Product. Automatically set by server on creation. - `ad_account_id` string — The ID of the AdAccount the Product belongs to. - `title` string, required — A descriptive name of the Product. - `description` string — A short description of the Product. - `advertiser_domain` string, required — Advertiser domain (e.g., "ford.com"). Usually the domain of AdAccounts's web page. From v1.7.4, it should be non empty if the value of allow_empty_advertiser_domain is false. If the value is empty, some exchanges may deny campaigns under the product. - `allow_empty_advertiser_domain` boolean — A flag to allow empty value of advertiser_domain. Setting this flag to true acknowledges that some exchanges may deny campaigns if the advertiser_domain is empty. From v1.7.4, the value should be true if the value of advertiser_domain is empty. - `device_os` 'UNKNOWN_DEVICE_OS' | 'ANDROID' | 'IOS' | 'VERSATILE' | 'MOBILE_WEB' | 'MACOS' | 'WINDOWS' | 'NEXT_VERSATILE' — Enumeration of device OS types supported by Moloco Ads. This value is not part of the specification. - ANDROID: Android device OS. - IOS: iOS device OS. - VERSATILE: Product with multiple OSes. Specifically for CTV. - MOBILE_WEB: OS for mobile web traffic. - MACOS: OS for MacOS traffic. - WINDOWS: OS for Windows traffic. - NEXT_VERSATILE: OS for Next web product. - `developer_name` string — The developer name of the Product. Some publishers request the sponsor information for the native Creative. The value of developer_name will be used to fill that information. Please note that this value could be displayed on user's screen. If this field is empty, native Creative's title will be used. - `type` 'UNKNOWN_TYPE' | 'APP' | 'WEB', required — Product type. - UNKNOWN_TYPE: This value is not part of the specification. - APP: App type. - WEB: Web type. - `app` ProductAppProperties — AppProperties defines the App type Product specific properties. Should contain only one of 'app' or 'web'. - `bundle_id` string, required — App bundle ID. Immutable. - `category` string — The main IAB content category of the App. This field is now output only and will be removed after v1.10. Before that, it is auto-filled from the categories field. Please use 'categories' field instead. Valid category values can be found in section "5.1 Content Categories" in the [OpenRTB API Specification] (https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf). - `categories` string[] — The IAB categories of the App. All the categories must be valid IAB categories. On create Product, the system checks the App Metadata Inventory: if the app is found, the Inventory values override user input; otherwise, the API uses the provided input. This field is editable only when the app is not in Inventory, and becomes read-only if the app exists there. Valid category values can be found in section "5.1 Content Categories" in the [OpenRTB API Specification] (https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf). - `category_readable` string - `rating` number, double — App rating in the range of [0, 5]. - `rating_cnt` string, int64 - `app_store_url` string — App store URL for Google Play, Apple App Store or Other App Markets. - `available_countries` string[] — Country codes where the app is available in the store. The value format is ISO-3166-1 Alpha-2 using uppercase letters only, such as "KR" or "US". - `unavailable_countries` string[] — Country codes where the app is unavailable in the store. The value format is ISO-3166-1 Alpha-2 using uppercase letters only, such as "KR" or "US". - `rtb_bundle_ids` string[] — RTB bundle names that related to the target app for which a Campaign runs. This field is useful when the target app and/or its family apps send out bid requests to the exchanges: (1) by nature, the Campaign must not deliver ad to the AdAccount's own apps; (2) it's better to ignore such apps for ads serving model training. - `postback_integration` DspPostbackIntegration — PostbackIntegration represents the postback integration information. - `mmp` 'UNKNOWN_TRACKING_COMPANY' | 'KOCHAVA' | 'ADJUST' | 'MAT' | 'MOLOCO_PIXEL' | 'APPSFLYER' | 'ADBRIX' | 'WEB' | 'GENERIC' | 'TRACKFNT' | 'AIRBRIDGE' | 'MOLOCO_E2E' | 'APSALAR' | 'BRANCH' | 'TENJIN' | 'SINGULAR' | 'ADBRIX_V2' | 'TRAFFICGUARD' | 'GAMELOFT' | 'SKADNETWORK' | 'MYTRACKER' | 'MOLOCO_RMP' | 'MOLOCO_PIXEL_V2' | 'JUSTTRACK' | 'SHOPEE' | 'KOCHAVA_FOR_PUBLISHER' | 'GAMESIGHT' | 'CAULY' | 'HASOFFER' | 'ADACTION' | 'CURATE' — Enumeration for tracking companies supported by Moloco Ads. - WEB: Unnamed trackers - AIRBRIDGE: Moloco's e2e tracker (test purpose only) - KOCHAVA_FOR_PUBLISHER: Kochava's CTV to web event dedicated tracking company. - `bundle_id` string — bundle_id to be used in the MMP integration. This corresponds to app_bundle in postback table. We've relied on the identifier sent by the tracker to keep track of events in our internal database. When we want to target to the audience of a Campaign, we need to exactly specify the identifier in the target description. Unfortunately, it depends on tracker's policy especially for iOS app as follows: - Appsflyer: "id" + NUMBER, where NUMBER is app bundle. - Tune: independent string to NUMBER. e.g., memebox is denoted as "com.memebox.ios.memebox" while app bundle is 896990789 - Adjust: same with the app_bundle - trackfnt: same with the app_bundle Note that 'bundle' field will be used as tracking bundle if 'tracking_bundle' is not given. In many case, this field can be filled after we receive the very first event from tracker for an app. - `mmp_integration` DspMmpIntegration — MmpIntegration represents the MMP integration information. - `id` string — The unique identifier of the MmpIntegration. - `mmp_bundle_id` string — Exact key which is used in MMP. - `mmp` 'UNKNOWN_TRACKING_COMPANY' | 'KOCHAVA' | 'ADJUST' | 'MAT' | 'MOLOCO_PIXEL' | 'APPSFLYER' | 'ADBRIX' | 'WEB' | 'GENERIC' | 'TRACKFNT' | 'AIRBRIDGE' | 'MOLOCO_E2E' | 'APSALAR' | 'BRANCH' | 'TENJIN' | 'SINGULAR' | 'ADBRIX_V2' | 'TRAFFICGUARD' | 'GAMELOFT' | 'SKADNETWORK' | 'MYTRACKER' | 'MOLOCO_RMP' | 'MOLOCO_PIXEL_V2' | 'JUSTTRACK' | 'SHOPEE' | 'KOCHAVA_FOR_PUBLISHER' | 'GAMESIGHT' | 'CAULY' | 'HASOFFER' | 'ADACTION' | 'CURATE' — Enumeration for tracking companies supported by Moloco Ads. - WEB: Unnamed trackers - AIRBRIDGE: Moloco's e2e tracker (test purpose only) - KOCHAVA_FOR_PUBLISHER: Kochava's CTV to web event dedicated tracking company. - `ownership` boolean — Whether the Product's AdAccount has ownership for the MmpIntegration. - `status` 'UNKNOWN_STATUS' | 'UNDER_REVIEW' | 'DENIED' | 'ACTIVE' - `denied_reason` string — Review denied reason if its status is DENIED. - `cv_config_item` MmpIntegrationConversionValueConfigurationItem — Conversion value configuration. Show the valid item among the history in the storage entity. (Most recent item of which the effective date is not later than current date.) Use case in MCP: https://help.moloco.com/hc/en-us/articles/1500012981641-SKAdNetwork-Conversion-Value-Configuration- . - `effective_date` string — The start date of the CV configuration in the form of YYYY-MM-DD. - `scheme` 'UNKNOWN_CONVERSION_VALUE_SCHEME' | 'CONVERSION_VALUE_SCHEME_SINGLE_EVENT' | 'CONVERSION_VALUE_SCHEME_MULTIPLE_EVENTS' | 'CONVERSION_VALUE_SCHEME_CUSTOM_EVENTS' | 'CONVERSION_VALUE_SCHEME_SKAN_V4_EVENTS' - `cv_single` ConversionValueConfigurationItemCvConfigurationForSingleEvent - `cv_revenue_events` object — Information on relationships between conversion value and (event name & revenue interval) for single event scheme. The key of this map is the registered conversion value between 1 to 63. The value of this map is a EventInfo message. EventInfo without revenue value should be unique. For the same event name, conversion value should be consecutive. Range min value cannot be smaller than previous range's max value. At least 4 Purchase Value should be registered for each event. - `cv_multi` ConversionValueConfigurationItemCvConfigurationForMultipleEvents - `cv_events` object — Information on relationships between conversion value and event name for multiple events scheme. The key of this map is the registered conversion value between 0 to 5. The value of this map is the event name. - `cv_custom` ConversionValueConfigurationItemCvConfigurationForCustomEvents - `cv_events` object — Information on relationships between conversion value and events for custom event scheme. The key of this map is the registered conversion value between 1 to 63. The value of this map is the list of events for each conversion value. - `cv_skan_v4` ConversionValueConfigurationItemCvConfigurationForSkanV4Events - `postbacks` CvConfigurationForSkanV4EventsPostback[] - … - `auto_refresh` ConversionValueConfigurationItemCvConfigurationAutoRefresh — Settings for automatically importing and updating SKAdNetwork conversion value configuration from MMP. - `enable_auto_refresh` boolean — Enables automatically importing the latest SKAdNetwork CV configuration from the integrated MMP and updating CV config items. - `refresh_result` 'UNKNOWN' | 'OK' | 'ERROR' - `refresh_error_message` string — Auto refresh error message in case the refresh request failed. - `last_auto_refreshed_at` string, date-time — Timestamp when the last auto SKAdNetwork CV configuration refresh occurred. - `mmp_context` MmpIntegrationMmpContext - `adjust` MmpContextAdjustContext - `url_host_universal_link` string - `url_host_branded_link` string - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `allow_fingerprinting` boolean — Whether the app owner has allowed the MMP's fingerprinting for attributions. - `fingerprinting_last_auto_refreshed_at` string, date-time — Timestamp for last update of "allow_fingerprinting". - `skadn_mmp_integration` DspMmpIntegration — MmpIntegration represents the MMP integration information. - `id` string — The unique identifier of the MmpIntegration. - `mmp_bundle_id` string — Exact key which is used in MMP. - `mmp` 'UNKNOWN_TRACKING_COMPANY' | 'KOCHAVA' | 'ADJUST' | 'MAT' | 'MOLOCO_PIXEL' | 'APPSFLYER' | 'ADBRIX' | 'WEB' | 'GENERIC' | 'TRACKFNT' | 'AIRBRIDGE' | 'MOLOCO_E2E' | 'APSALAR' | 'BRANCH' | 'TENJIN' | 'SINGULAR' | 'ADBRIX_V2' | 'TRAFFICGUARD' | 'GAMELOFT' | 'SKADNETWORK' | 'MYTRACKER' | 'MOLOCO_RMP' | 'MOLOCO_PIXEL_V2' | 'JUSTTRACK' | 'SHOPEE' | 'KOCHAVA_FOR_PUBLISHER' | 'GAMESIGHT' | 'CAULY' | 'HASOFFER' | 'ADACTION' | 'CURATE' — Enumeration for tracking companies supported by Moloco Ads. - WEB: Unnamed trackers - AIRBRIDGE: Moloco's e2e tracker (test purpose only) - KOCHAVA_FOR_PUBLISHER: Kochava's CTV to web event dedicated tracking company. - `ownership` boolean — Whether the Product's AdAccount has ownership for the MmpIntegration. - `status` 'UNKNOWN_STATUS' | 'UNDER_REVIEW' | 'DENIED' | 'ACTIVE' - `denied_reason` string — Review denied reason if its status is DENIED. - `cv_config_item` MmpIntegrationConversionValueConfigurationItem — Conversion value configuration. Show the valid item among the history in the storage entity. (Most recent item of which the effective date is not later than current date.) Use case in MCP: https://help.moloco.com/hc/en-us/articles/1500012981641-SKAdNetwork-Conversion-Value-Configuration- . - `effective_date` string — The start date of the CV configuration in the form of YYYY-MM-DD. - `scheme` 'UNKNOWN_CONVERSION_VALUE_SCHEME' | 'CONVERSION_VALUE_SCHEME_SINGLE_EVENT' | 'CONVERSION_VALUE_SCHEME_MULTIPLE_EVENTS' | 'CONVERSION_VALUE_SCHEME_CUSTOM_EVENTS' | 'CONVERSION_VALUE_SCHEME_SKAN_V4_EVENTS' - `cv_single` ConversionValueConfigurationItemCvConfigurationForSingleEvent - `cv_revenue_events` object — Information on relationships between conversion value and (event name & revenue interval) for single event scheme. The key of this map is the registered conversion value between 1 to 63. The value of this map is a EventInfo message. EventInfo without revenue value should be unique. For the same event name, conversion value should be consecutive. Range min value cannot be smaller than previous range's max value. At least 4 Purchase Value should be registered for each event. - `cv_multi` ConversionValueConfigurationItemCvConfigurationForMultipleEvents - `cv_events` object — Information on relationships between conversion value and event name for multiple events scheme. The key of this map is the registered conversion value between 0 to 5. The value of this map is the event name. - `cv_custom` ConversionValueConfigurationItemCvConfigurationForCustomEvents - `cv_events` object — Information on relationships between conversion value and events for custom event scheme. The key of this map is the registered conversion value between 1 to 63. The value of this map is the list of events for each conversion value. - `cv_skan_v4` ConversionValueConfigurationItemCvConfigurationForSkanV4Events - `postbacks` CvConfigurationForSkanV4EventsPostback[] - … - `auto_refresh` ConversionValueConfigurationItemCvConfigurationAutoRefresh — Settings for automatically importing and updating SKAdNetwork conversion value configuration from MMP. - `enable_auto_refresh` boolean — Enables automatically importing the latest SKAdNetwork CV configuration from the integrated MMP and updating CV config items. - `refresh_result` 'UNKNOWN' | 'OK' | 'ERROR' - `refresh_error_message` string — Auto refresh error message in case the refresh request failed. - `last_auto_refreshed_at` string, date-time — Timestamp when the last auto SKAdNetwork CV configuration refresh occurred. - `mmp_context` MmpIntegrationMmpContext - `adjust` MmpContextAdjustContext - `url_host_universal_link` string - `url_host_branded_link` string - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `allow_fingerprinting` boolean — Whether the app owner has allowed the MMP's fingerprinting for attributions. - `fingerprinting_last_auto_refreshed_at` string, date-time — Timestamp for last update of "allow_fingerprinting". - `content_rating` string — Content rating(App store age information) of the App. - `storekit_enabled` boolean — StoreKit can be applied only for iOS app. - `autoinline_enabled` boolean — AutoInline can be applied only for Android app. - `localized_app_name` object - `localized_app_icon_url` object — Field for url of app icon. - `localized_app_screenshots` object — App screenshots from the app store. - `app_event_types` object — Information on relationships between in-app events and its event type. This field is to categorize in-app events and categorized event types for each in-app event are used to optimize training of ML model. - `description` string - `short_description` string — Short description (promo text) from the app store. - `ios_primary_measurement` 'IOS_PRIMARY_MEASUREMENT_UNKNOWN' | 'IOS_PRIMARY_MEASUREMENT_NONE' | 'IOS_PRIMARY_MEASUREMENT_SKAN' | 'IOS_PRIMARY_MEASUREMENT_MMP' — Primary measurement used for iOS apps. - IOS_PRIMARY_MEASUREMENT_UNKNOWN: Zero value. Every non-iOS app must have this value. - IOS_PRIMARY_MEASUREMENT_NONE: Unset value for iOS app. It means the primary measurement is not decided yet. - IOS_PRIMARY_MEASUREMENT_SKAN: SKAdNetwork (SKAN) - IOS_PRIMARY_MEASUREMENT_MMP: MMP Probabilistic Attribution - `ios_secondary_measurement` 'IOS_SECONDARY_MEASUREMENT_UNKNOWN' | 'IOS_SECONDARY_MEASUREMENT_NONE' | 'IOS_SECONDARY_MEASUREMENT_NA' | 'IOS_SECONDARY_MEASUREMENT_SKAN' | 'IOS_SECONDARY_MEASUREMENT_MMP' | 'IOS_SECONDARY_MEASUREMENT_OTHER_MMP' | 'IOS_SECONDARY_MEASUREMENT_OTHER_3P' | 'IOS_SECONDARY_MEASUREMENT_INCREMENTALITY' | 'IOS_SECONDARY_MEASUREMENT_CUSTOM' — Secondary measurement used for iOS apps. - IOS_SECONDARY_MEASUREMENT_UNKNOWN: Zero value. Every non-iOS app must have this value. - IOS_SECONDARY_MEASUREMENT_NONE: Unset value for iOS app. It means the secondary measurement is not decided yet. - IOS_SECONDARY_MEASUREMENT_NA: Not applicable. It means the iOS app does not use any secondary measurement. - IOS_SECONDARY_MEASUREMENT_SKAN: SKAdNetwork (SKAN). SKAN cannot be configured as both the primary and secondary measurement. If a secondary measurement is not required, use 'NA'. - IOS_SECONDARY_MEASUREMENT_MMP: MMP Probabilistic Attribution. MMP cannot be configured as both the primary and secondary measurement. If a secondary measurement is not required, use 'NA'. - IOS_SECONDARY_MEASUREMENT_OTHER_MMP: Other MMP measurements (e.g., unified iOS reporting, AppsFlyer SSOT, etc.) - IOS_SECONDARY_MEASUREMENT_OTHER_3P: Other 3P measurement tool (e.g., some customers are using other BI tools) - IOS_SECONDARY_MEASUREMENT_INCREMENTALITY: Incrementality measurement - IOS_SECONDARY_MEASUREMENT_CUSTOM: Custom measurement - `ios_custom_measurement` string - `web` ProductWebProperties — WebProperties defines the Web type Product specific properties. Should contain only one of 'app' or 'web'. - `category` string — The main IAB content category of the web product. When creating a WEB product, provide exactly one of 'category' or 'categories'; the other field is derived automatically. Providing both is rejected. REQUIRED was dropped to allow 'categories'-only WEB creates; BRAND products reuse this message via 'brand.web' and still require 'category' (enforced at the API layer). Valid category values can be found in section "5.1 Content Categories" in the [OpenRTB API Specification] (https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf) - `landing_url` string — URL of the final destination page the audience users will be redirected to. Length of the URL should not exceed 10000 characters. - `categories` string[] — Multiple IAB categories of the web product. When creating a product, provide exactly one of 'category' or 'categories'; the other field is derived automatically. Providing both is rejected. Valid category values can be found in section "5.1 Content Categories" in the [OpenRTB API Specification] (https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf). - `dynamic_creative_property` ProductDynamicCreativeProperty — Dynamic Creative specific properties. - `permission` boolean — Permission to use dynamic CreativeGroups. - `suspension_history` ProductSuspensionAction[] — List of suspension actions. It is sorted by timestamp in descending order, so the first one is the current suspension result. - `user_name` string — Name who judges the product to be suspended. - `user_email` string — Email who judges the product to be suspended. - `reason` string — The reason for the product suspension. - `kind` 'UNKNOWN_KIND' | 'CREATE' | 'UPDATE' — The kind to represent whether the current action is newly created, or is for updating the previous action. - CREATE: This suspension action is independently created. - UPDATE: This suspension action is for updating the previous suspension action. - `type` 'UNKNOWN_TYPE' | 'SUSPEND_UNTIL' | 'SUSPEND_INDEFINITELY' | 'STOP_SUSPENSION' — The type which the current action achieves. - SUSPEND_UNTIL: The current action is for product suspension until someday. - SUSPEND_INDEFINITELY: The current action is for product suspension indefinitely. - STOP_SUSPENSION: The current action is to stop product suspension. - `effective_from` string, date-time — The time from the app suspension will have been effective. - `effective_until` string, date-time — The time until the app suspension will have been effective. If the value of Type is set to STOP_SUSPENSION, SUSPEND_INDEFINITELY, there is no need to enter a value and the system automatically enters a value for you. - `created_at` string, date-time — The time when the current suspension action is created. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `campaigns` DspCampaign[] — List of Campaign and it's following AdGroups. - `id` string — Unique identifier of the Campaign. Automatically set by server on creation. - `ad_account_id` string — ID of the AdAccount the Campaign belongs to. - `product_id` string — ID of the Product the Campaign belongs to. - `title` string, required — A descriptive name of the Campaign. - `description` string — An optional description of the Campaign. - `enabling_state` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED' — Enumeration of the enabling states with a default UNSPECIFIED state. - `type` 'UNKNOWN_CAMPAIGN_TYPE' | 'GENERIC' | 'APP_USER_ACQUISITION' | 'APP_REENGAGEMENT' | 'WEBSITE_VISIT' | 'CTV_GENERIC' | 'CTV_APP_USER_ACQUISITION' | 'WEB_USER_ACQUISITION' | 'CTV_WEBSITE_VISIT' | 'WEB_RETARGETING', required — CampaignType represents the type of a Campaign. It captures the goal of the Campaign at a high level. This value is not part of the specification. - GENERIC: Campaign is for generic purpose (only for legacy Campaigns). - APP_USER_ACQUISITION: The goal of the Campaign is to drive app user acquisitions. - APP_REENGAGEMENT: The goal of the Campaign is to drive app reengagement. - WEBSITE_VISIT: The goal of the Campaign is to drive website visits. - CTV_GENERIC: Campaign is for the general CTV ad. - CTV_APP_USER_ACQUISITION: Campaign is for the mobile app install CTV ad. - WEB_USER_ACQUISITION: The goal of the Campaign is to drive web user acquisitions. Originally, this was used for APP to WEB user acquisition. However, it is now also used for WEB to WEB user acquisition. - CTV_WEBSITE_VISIT: Campaign is for the website visit CTV ad. - WEB_RETARGETING: The goal of the Campaign is to drive web retargeting. Currently, this is used for WEB to WEB retargeting. - `device_os` 'UNKNOWN_DEVICE_OS' | 'ANDROID' | 'IOS' | 'VERSATILE' | 'MOBILE_WEB' | 'MACOS' | 'WINDOWS' | 'NEXT_VERSATILE', required — Enumeration of device OS types supported by Moloco Ads. This value is not part of the specification. - ANDROID: Android device OS. - IOS: iOS device OS. - VERSATILE: Product with multiple OSes. Specifically for CTV. - MOBILE_WEB: OS for mobile web traffic. - MACOS: OS for MacOS traffic. - WINDOWS: OS for Windows traffic. - NEXT_VERSATILE: OS for Next web product. - `state` 'UNKNOWN_CAMPAIGN_STATE' | 'SUBMITTED' | 'READY' | 'UPCOMING' | 'ACTIVE' | 'PAUSED' | 'SUSPENDED' | 'COMPLETED' — CampaignState represents various states of a Campaign. This value is not part of the specification. - SUBMITTED: All the required data are entered and passed all the validation. It's eligible to be reviewed by Moloco for activation. - READY: Campaign is before schedule and internally ready but disabled. Will transit to PAUSED when it becomes on schdule. - UPCOMING: Campaign is before schedule and internally ready and disabled. Will transit to ACTIVE when it becomes on schdule. - ACTIVE: Campaign is on schedule and spending the budget. - PAUSED: Campaign is paused and not spending the budget. - SUSPENDED: Campaign activation is suspended by the system for the following reasons: - App has been found to be in violation of Moloco's creative policy. - COMPLETED: Campaign is completed but may still get attributions for some time. - `countries` string[], required — Countries in which this Campaign runs. The value format is ISO-3166-1 Alpha-3 using uppercase letters only, such as "KOR" or "USA". Note that the values for this field will be used to filter bid requests by country name. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `schedule` CommonTimeInterval, required — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `budget_schedule` DspBudgetSchedule — BudgetSchedule represents the AdAccount's plan for budget spending. Any change in this object takes effect immediately. - `daily_schedule` DspDailyBudgetSchedule - `daily_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `weekly_schedule` DspDayOfWeekBudgetSchedule — Budget for each day of the week; all 7-day budgets need be filled for use. - `monday_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `tuesday_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `wednesday_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `thursday_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `friday_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `saturday_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `sunday_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `weekly_flexible_schedule` DspWeeklyFlexibleBudgetSchedule - `weekly_budget` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `tracking_company` 'UNKNOWN_TRACKING_COMPANY' | 'KOCHAVA' | 'ADJUST' | 'MAT' | 'MOLOCO_PIXEL' | 'APPSFLYER' | 'ADBRIX' | 'WEB' | 'GENERIC' | 'TRACKFNT' | 'AIRBRIDGE' | 'MOLOCO_E2E' | 'APSALAR' | 'BRANCH' | 'TENJIN' | 'SINGULAR' | 'ADBRIX_V2' | 'TRAFFICGUARD' | 'GAMELOFT' | 'SKADNETWORK' | 'MYTRACKER' | 'MOLOCO_RMP' | 'MOLOCO_PIXEL_V2' | 'JUSTTRACK' | 'SHOPEE' | 'KOCHAVA_FOR_PUBLISHER' | 'GAMESIGHT' | 'CAULY' | 'HASOFFER' | 'ADACTION' | 'CURATE' — Enumeration for tracking companies supported by Moloco Ads. - WEB: Unnamed trackers - AIRBRIDGE: Moloco's e2e tracker (test purpose only) - KOCHAVA_FOR_PUBLISHER: Kochava's CTV to web event dedicated tracking company. - `tracking_link_id` string — MMP specific impression and click TrackingLinks defined specifically for this Campaign. Campaign can be either WEB type or APP type. Required for APP type campaign, not allowed for WEB type Campaign. - `landing_url` string — The URL of the website that a Campaign wants to show to the audience. Required for web type Campaign. - `goal` DspCampaignGoal, required — CampaignGoal describes the details of goal of a Campaign. - `type` 'UNKNOWN_TYPE' | 'OPTIMIZE_NONE' | 'FIXED_CPM_FOR_APP_UA' | 'FIXED_CPM_FOR_APP_RE' | 'OPTIMIZE_CPI_FOR_APP_UA' | 'OPTIMIZE_CPA_FOR_APP_UA' | 'OPTIMIZE_CPC_FOR_APP_UA' | 'OPTIMIZE_ROAS_FOR_APP_UA' | 'OPTIMIZE_ROAS_FOR_APP_RE' | 'OPTIMIZE_CPC_FOR_APP_RE' | 'OPTIMIZE_CPC_FOR_WEB_VISIT' | 'OPTIMIZE_APP_INSTALLS' | 'OPTIMIZE_APP_ROAS' | 'OPTIMIZE_CLICKS_TO_WEB' | 'OPTIMIZE_CLICKS_TO_APP' | 'OPTIMIZE_CPA_FOR_APP_RE' | 'OPTIMIZE_RETENTION_FOR_APP_UA' | 'OPTIMIZE_REATTRIBUTION_FOR_APP' | 'OPTIMIZE_CPA_REPEATED_FOR_APP_UA' | 'FIXED_CPM_GENERIC' | 'FIXED_CPM_FOR_CTV' | 'FIXED_CPM_FOR_WEB_VISIT' | 'OPTIMIZE_LANDING_FOR_WEB_UA' | 'OPTIMIZE_CPA_FOR_WEB_UA', required — Type enumerates available Campaign goal types. Corresponding details to the type must be specified. - OPTIMIZE_NONE: Goal type for the Campaigns which do not use any of pricing engines. - FIXED_CPM_FOR_APP_UA: Goal type for the UA Campaigns which do not use any of pricing engines. - FIXED_CPM_FOR_APP_RE: Goal type for the RE Campaigns which do not use any of pricing engines. - OPTIMIZE_CPI_FOR_APP_UA: Aim to drive app installs while satisfying the long-term cost per install. - OPTIMIZE_CPA_FOR_APP_UA: Aim to drive app installs while satisfying long-term cost per (certain) action. - OPTIMIZE_CPC_FOR_APP_UA: Aim to drive app installs while satisfying long-term cost per click. - OPTIMIZE_ROAS_FOR_APP_UA: Aim to drive app installs while satisfying long-term return on advertising spend (ROAS). - OPTIMIZE_ROAS_FOR_APP_RE: Aim to drive the user re-engagements while satisfying long-term return on advertising spend (ROAS). - OPTIMIZE_CPC_FOR_APP_RE: Aim to drive the user re-engagements while satisfying long-term cost per click. - OPTIMIZE_CPC_FOR_WEB_VISIT: Aim to drive the web-site visit while satisfying long-term cost per click. - OPTIMIZE_APP_INSTALLS: Deprecated. Aim to drive app installs while satisfying long-term cost per install. - OPTIMIZE_APP_ROAS: Deprecated. Aim to drive certain in-app actions while satisfying long-term return on advertising spend (ROAS). - OPTIMIZE_CLICKS_TO_WEB: Deprecated. Aim to drive clicks for web-site Product while satisfying long-term cost per click. - OPTIMIZE_CLICKS_TO_APP: Deprecated. Aim to drive clicks for web-site Product while satisfying long-term cost per click. - OPTIMIZE_CPA_FOR_APP_RE: Aim to drive the user re-engagements while satisfying long-term cost per (certain) action. - OPTIMIZE_RETENTION_FOR_APP_UA: Aim to drive the user retention. - OPTIMIZE_REATTRIBUTION_FOR_APP: Aim to drive user's app reattribution. - OPTIMIZE_CPA_REPEATED_FOR_APP_UA: Aim to drive app installs while satisfying long-term cost per (certain) action - repeated count. - FIXED_CPM_GENERIC: Default goal type for generic fixed-cpm. Fixed cpm with budget-pacing option is given. - FIXED_CPM_FOR_CTV: Default goal type for CTV. Fixed cpm with budget-pacing option is given. - FIXED_CPM_FOR_WEB_VISIT: Goal type for the WEB_VISIT Campaigns which do not use any of pricing engines. - OPTIMIZE_LANDING_FOR_WEB_UA: Goal type for optimizing landing event for web user acquisition campaign. - OPTIMIZE_CPA_FOR_WEB_UA: Goal type for optimizing cost per action for web user acquisition campaign. - `optimize_app_installs` CampaignGoalOptimizeAppInstalls - `mode` 'UNKNOWN_MODE' | 'TARGET_CPI_CENTRIC' | 'BUDGET_CENTRIC' | 'MARGIN_CENTRIC' | 'FIXED' — - FIXED: Read-only for AdCloud. - `target_cpi` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `margin` number, double — The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC. The rate should be in [-1.0, 1.0]. - `optimize_cpa_for_app_ua` CampaignGoalOptimizeCpaForAppUa — Detailed configuration of OPTIMIZE_CPA_FOR_APP_UA goal. - `action` string, required — In-app action events having revenue value the AdAccount wants to achieve. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'MARGIN_CENTRIC' | 'TARGET_PRIMARY_KPI_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `margin` number, double — The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC. The rate should be in [-1.0, 1.0]. - `target_kpi` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `optimize_app_roas` CampaignGoalOptimizeAppRoas - `target_roas` number, double — Target return on advertising spend (ROAS) in percent. For example, a value 312.5 denotes 312.5% ROAS. - `revenue_actions` string[], required — In-app action events having revenue value the AdAccount wants to achieve. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - ROAS computation will rely on the accompanied revenue value to each action. - `target_cpi` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'MARGIN_CENTRIC' | 'TARGET_PRIMARY_KPI_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `margin` number, double — The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC. The rate should be in [-1.0, 1.0]. - `optimize_clicks_to_web` CampaignGoalOptimizeClicksToWeb — Detailed configuration of OPTIMIZE_CPC_FOR_WEB_VISIT goal. - `target_cpc` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'TARGET_CPC_CENTRIC' - `rate` number, double — Budget-centric uses one ratio of daily budget for the autopilot to spend. It's only for DCPM. Required when the mode is BUDGET_CENTRIC. Its rate should be in (0, 2]. - `optimize_clicks_to_app` CampaignGoalOptimizeClicksToApp — Detailed configuration of OPTIMIZE_CPC_FOR_APP_UA goal. - `target_cpc` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'TARGET_CPC_CENTRIC' - `rate` number, double — Budget-centric uses one ratio of daily budget for the autopilot to spend. It's only for DCPM. Required when the mode is BUDGET_CENTRIC. Its rate should be in (0, 2]. - `optimize_roas_for_app_re` CampaignGoalOptimizeRoasForAppRe — Detailed configuration of OPTIMIZE_ROAS_FOR_APP_RE goal. - `target_roas` number, double — Target return on advertising spend (ROAS) in percent. For example, a value 312.5 denotes 312.5% ROAS. - `reengagement_action` string — Re-engagement action to measure re-engaging a user. This action is also used as a cohort base action. - `revenue_actions` string[], required — In-app action events having revenue value the AdAccount wants to achieve. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - ROAS computation will rely on the accompanied revenue value to each action. - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. - `optimize_cpc_for_app_re` CampaignGoalOptimizeCpcForAppRe — Detailed configuration of OPTIMIZE_CPC_FOR_APP_RE goal. - `target_cpc` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `reengagement_action` string — Re-engagement action to measure re-engaging a user. This action is also used as a cohort base action. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'TARGET_CPC_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. Required when the mode is BUDGET_CENTRIC. - `optimize_fixed_cpm` CampaignGoalOptimizeFixedCpm — Detailed configuration of FIXED_CPM_* goal. - `target_cpm` AdcloudcommonMoney, required — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `optimize_cpa_for_app_re` CampaignGoalOptimizeCpaForAppRe — Detailed configuration of OPTIMIZE_CPA_FOR_APP_RE goal. - `action` string, required — In-app action events the AdAccount wants to optimize. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - `reengagement_action` string — Re-engagement action to measure re-engaging a user. This action is also used as a cohort base action. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `optimize_app_retention` CampaignGoalOptimizeAppRetention — Detailed configuration of OPTIMIZE_RETENTION_FOR_APP_UA goal. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'MARGIN_CENTRIC' - `target_cpi` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC and target_cpi is unset. The rate should be in (0, 2]. - `margin` number, double — The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC. The rate should be in [-1.0, 1.0]. - `optimize_app_reattribution` CampaignGoalOptimizeAppReattribution — Detailed configuration of OPTIMIZE_REATTRIBUTION_FOR_APP goal. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. - `optimize_cpa_repeated_for_app_ua` CampaignGoalOptimizeCpaRepeatedForAppUa — Detailed configuration of OPTIMIZE_CPA_REPEATED_FOR_APP_UA goal. - `action` string, required — In-app action events the AdAccount wants to optimize. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `optimize_fixed_cpm_pacing` CampaignGoalOptimizeFixedCpmPacing — General fixed-cpm goal with pacing option. Currently for FIXED_CPM_FOR_CTV and FIXED_CPM_GENERIC. - `target_cpm` AdcloudcommonMoney, required — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `pacing_mode` 'NONE' | 'BY_FREQUENCY' — Force pacing option. - `rate` number, double — Budget consume rate. The rate should be in (0, 2]. - `optimize_landing_for_web_ua` CampaignGoalOptimizeLandingForWebUa - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. - `optimize_cpa_for_web_ua` CampaignGoalOptimizeCpaForWebUa - `action` string, required — Web action events having revenue value the AdAccount wants to achieve. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. Note(jiyeon): Currently, we optimize `install` events regardless of this action. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. - `kpi_actions` string[] — List of KPI actions. - `skadn_input` DspSKAdNetworkInput — SKAdNetworkInput represents various configurations w.r.t SKAdNetwork traffic. It's meaningful only for IOS. Use case in MCP: https://help.moloco.com/hc/en-us/articles/1500005837321-SKAdNetwork-Campaign-Settings. - `targeting_state` 'UNKNOWN_TARGETING_STATE' | 'TARGET_DO_NOT_CARE' | 'TARGET_ALL' | 'TARGET_SKADN_ONLY' | 'TARGET_NON_SKADN_ONLY' | 'TARGET_CUSTOM' — Enumeration of all supported targeting state w.r.t SKAdNetwork traffic. TARGET_ALL, TARGET_SKADN_ONLY, TARGET_NON_SKADN_ONLY is a predefined set of traffic. TARGET_CUSTOM is to support DIY configuration of traffic. This value is not part of the specification. - TARGET_DO_NOT_CARE: Do not care whether the Campaign targets SKAdNetwork traffic or not. - TARGET_ALL: Target all traffic including SKAdNetwork and others. It includes SKAN_CUSTOM_OPTION_MMP_ATTRIBUTABLE, SKAN_CUSTOM_OPTION_BI_ATTRIBUTABLE, SKAN_CUSTOM_OPTION_SKAN_ATTRIBUTABLE. - TARGET_SKADN_ONLY: Target only SKAdNetwork traffic. It includes SKAN_CUSTOM_OPTION_SKAN_ATTRIBUTABLE. - TARGET_NON_SKADN_ONLY: Target only non-SKAdNetwork traffic. It includes SKAN_CUSTOM_OPTION_MMP_ATTRIBUTABLE, SKAN_CUSTOM_OPTION_BI_ATTRIBUTABLE. - TARGET_CUSTOM: Target customized configuration traffic. When the targeting_state is set with this value, then custon_options should be also set. - `include_traffic_without_attributions` boolean — It adds SKAN_CUSTOM_OPTION_NON_ATTRIBUTABLE to target traffic. It is only effective when the targeting_state is 'TARGET_ALL' or 'TARGET_SKADN_ONLY'. - `custom_options` SKAdNetworkInputCustomOption[] — custom_options hold all the traffic the Campaign want to target. It is only effective when the targeting_state is 'TARGET_CUSTOM'. - `prefer_mmp_attribution` boolean — 1) targeting_state is TARGET_NON_SKADN_ONLY 2) targeting_state is TARGET_CUSTOM and custom_options is set exclusively to SKAN_CUSTOM_OPTION_BI_ATTRIBUTABLE. If true, the Campaign skips SKAN allocation. - `custom_key_values` object — Custom key/values managed by the Moloco Ads client platform. It's up to the client ads platform to define the schema for the values and their optionality. The keys are recommended, but not required, to be prefixed with the reversed internet domain of the AdCloud client platform company. For example, keys defined by the client ads platform company "example.com" should have "com.example." as the prefix. For complex values, JSON payload is recommended. Moloco doesn't interpret these data in any way for ads serving. Upon serving, the custom key/values in the AdAccount, Campaign, and Creative models will be combined into the serving Creative proto in the order of precedence, with Creative's value having the highest precedence on the same key. - `ad_tracking_allowance` 'UNKNOWN_AD_TRACKING_ALLOWANCE' | 'NON_LAT_ONLY' | 'LAT_ONLY' | 'DO_NOT_CARE' — AdTrackingAllowance represents targeting conditions regarding personalized ad tracking. This value is not part of the specification. - NON_LAT_ONLY: Campaign will bid only to the traffic with IDFA as usual Campaigns. - LAT_ONLY: Campaign will bid only to the traffic without IDFA. Limited Ad Tracking only. - DO_NOT_CARE: Campaign will not care whether it has an IDFA or not. Default as of now. - `is_deleted` boolean — True for deleted Campaign. - `auto_delete_at` string, date-time — Campaign in Paused or Finished state for specific time will be removed automatically. It represents when this will be deleted in UTC. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `serving_status` CampaignServingStatus — ServingStatus stores current serving status of the campaign, such as whether it is blocked and when it is blocked. - `serving_blocked` boolean — serving_blocked is true when this campaign is blocked in the serving side for some reason. - `serving_blocked_timestamp` string, date-time — The timestamp of the latest serving block. - `launch_notices` CommonLaunchNotice[] — A list of notices that the user must review and acknowledge to enable the campaign. This field represents pending notices requiring user confirmation. The client should store these notices and include them in the subsequent request via the 'launch_notice_confirmations' field to prove that the user has seen them. - `type` 'UNKNOWN' | 'WARNING' | 'DISCLAIMER' — NoticeType defines the severity or category of the notice. - WARNING: Warning: Informational message that does not block the launch but requires attention. - DISCLAIMER: Disclaimer: Explicit agreement or acknowledgement is required from the user. - `message` 'UNKNOWN_MESSAGE' | 'MMP_PROBABILISTIC_ATTRIBUTION_STATUS_DISABLED' | 'MMP_VIEW_THROUGH_PROBABILISTIC_ATTRIBUTION_STATUS_DISABLED' | 'MMP_ADVANCED_PRIVACY_STATUS_ENABLED' | 'MMP_PROBABILISTIC_ATTRIBUTION_STATUS_UNKNOWN' | 'CAMPAIGN_WILL_PAUSE_IF_ADVANCED_PRIVACY_ENABLED_AFTER_48H' — - UNKNOWN_MESSAGE: Default fallback for unrecognized message types. - MMP_PROBABILISTIC_ATTRIBUTION_STATUS_DISABLED: MMP Probabilistic Attribution (PA) is disabled. User should enable PA from MMP side. - MMP_VIEW_THROUGH_PROBABILISTIC_ATTRIBUTION_STATUS_DISABLED: View-Through Probabilistic Attribution (VT PA) is disabled in MMP settings. - MMP_ADVANCED_PRIVACY_STATUS_ENABLED: Appsflyer Advanced Privacy is currently enabled. - MMP_PROBABILISTIC_ATTRIBUTION_STATUS_UNKNOWN: The current status of Probabilistic Attribution cannot be determined. - CAMPAIGN_WILL_PAUSE_IF_ADVANCED_PRIVACY_ENABLED_AFTER_48H: The campaign is scheduled to pause in 48 hours if Advanced Privacy remains enabled. - `launch_notice_confirmations` CommonLaunchNotice[] — The list of launch notice that the user has explicitly reviewed and confirmed. The client must echo back the notices received in 'launch_notices' when enabling the campaign. The server validates these against the current system state to ensure all required acknowledgments are present. Starting from v1.10.0, any campaign enable request that does not include all 'DISCLAIMER' type notices received in 'launch_notices' will be rejected. - `type` 'UNKNOWN' | 'WARNING' | 'DISCLAIMER' — NoticeType defines the severity or category of the notice. - WARNING: Warning: Informational message that does not block the launch but requires attention. - DISCLAIMER: Disclaimer: Explicit agreement or acknowledgement is required from the user. - `message` 'UNKNOWN_MESSAGE' | 'MMP_PROBABILISTIC_ATTRIBUTION_STATUS_DISABLED' | 'MMP_VIEW_THROUGH_PROBABILISTIC_ATTRIBUTION_STATUS_DISABLED' | 'MMP_ADVANCED_PRIVACY_STATUS_ENABLED' | 'MMP_PROBABILISTIC_ATTRIBUTION_STATUS_UNKNOWN' | 'CAMPAIGN_WILL_PAUSE_IF_ADVANCED_PRIVACY_ENABLED_AFTER_48H' — - UNKNOWN_MESSAGE: Default fallback for unrecognized message types. - MMP_PROBABILISTIC_ATTRIBUTION_STATUS_DISABLED: MMP Probabilistic Attribution (PA) is disabled. User should enable PA from MMP side. - MMP_VIEW_THROUGH_PROBABILISTIC_ATTRIBUTION_STATUS_DISABLED: View-Through Probabilistic Attribution (VT PA) is disabled in MMP settings. - MMP_ADVANCED_PRIVACY_STATUS_ENABLED: Appsflyer Advanced Privacy is currently enabled. - MMP_PROBABILISTIC_ATTRIBUTION_STATUS_UNKNOWN: The current status of Probabilistic Attribution cannot be determined. - CAMPAIGN_WILL_PAUSE_IF_ADVANCED_PRIVACY_ENABLED_AFTER_48H: The campaign is scheduled to pause in 48 hours if Advanced Privacy remains enabled. - `ad_groups` DspAdGroup[] — AdGroups of the Campaign. - `id` string — Unique identifier of the AdGroup. Automatically set by server on creation. - `title` string, required — A descriptive name of the AdGroup. - `campaign_id` string — ID of the Campaign the AdGroup belongs to. - `product_id` string — ID of the Product the AdGroup belongs to. - `ad_account_id` string — ID of the AdAccount the AdGroup belongs to. - `experiment_id` string — ID of the Experiment the AdGroup is involved in. - `enabling_state` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED' — Enumeration of the enabling states with a default UNSPECIFIED state. - `audience` AdclouddspAudience — Audience is a final form of AudienceTargeting specification. It is represented by a list of IDs of SharedAudienceTargets and an ad-hoc target condition. All conditions in the audience specification must be met to accept a bid-request. IDs of the SharedAudienceTargets can be either at global or AdAccount level. - `shared_audience_target_ids` string[] — A list of IDs for the named AudienceTargets referenced by this audience specification. - `targeting_condition` DspAudienceTargetingCondition — AudienceTargetingCondition specifies conditions for AudienceTargeting. This condition object contains various filters on multiple dimensions of bid-request, app, and user. Advertisers can selectively configure desired filters to form a meaningful AudienceTarget condition collectively. The configured individual filters must be satisfied unanimously in order for the resulting collective condition to be satisfied. Only filters with values will be effective. When a filter condition accepts a list of values, i.e., list of countries for "allowed_countries", the filter condition will be met when any match is found among the list. String literals are case insensitive unless specified otherwise; i.e. "USA" and "usa" equally represents the United States of America. - `allowed_countries` string[] — Allowed countries in ISO_3166-1_alpha-3 format. - `blocked_countries` string[] — Blocked countries in ISO_3166-1_alpha-3 format. - `placement_reasons` AudienceTargetingConditionPlacementReason[] - `custom_placement_reason` string — The reason of the placement in free-form text. - `allowed_app_bundles` string[] — App bundles. A bid-request having a matching publisher app bundle from the list will be accepted. Example to target com.moloco.game or com.moloco.travel apps: "allowed_app_bundles": [ "com.moloco.game", "com.moloco.travel" ] Example to exclude com.moloco.office app: "blocked_app_bundles": [ "com.moloco.office" ] - `blocked_app_bundles` string[] — See the documentation for `allowed_app_bundles`. - `allowed_content_categories` string[] — Filter for allowed publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "allowed_content_categories": [ "IAB26-1" ] - `blocked_content_categories` string[] — Filter for blocked publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "blocked_content_categories": [ "IAB26-1" ] - `allowed_cities` string[] — Allowed cities. A bid-request will be accepted when there is at least one match from the city list. Note that each element must be in the form of "city, region" such as "Seattle, WA" in order to disambiguate the same city but different regions. The entry is case-insensitive and whitespace will be ignored. Example to target Seattle or Newyork: "allowed_cities": [ "Seattle, WA", "Newyork, ny" ] - `blocked_cities` string[] — Blocked cities. - `allowed_creative_types` AdcloudcommonCreativeType[] — Allowed Creative types. - `blocked_creative_types` AdcloudcommonCreativeType[] — Blocked Creative types. - `allowed_websites` string[] — Allowed websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "allowed_websites": [ "*youtube.com" ]. - `blocked_websites` string[] — Blocked websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "blocked_websites": [ "*example.com" ]. - `allowed_geofences` CommonCircle[] — Allowed geofences. - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - `latitude` number, double - `longitude` number, double - `radius` number, double - `blocked_geofences` CommonCircle[] — Blocked geofences. - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - `latitude` number, double - `longitude` number, double - `radius` number, double - `allowed_exchanges` CommonAdExchange[] — Allowed ad exchanges. Restricts targeting to bid only on the listed exchanges; an empty list places no restriction. MOLOCO_SDK is automatically included whenever the list is non-empty: submitting a non-empty list that omits MOLOCO_SDK will have it appended on the server side. - `blocked_exchanges` CommonAdExchange[] — Blocked ad exchanges. Excludes the listed exchanges from targeting. Adding MOLOCO_SDK to this list is rejected with PERMISSION_DENIED. - `allowed_idfas` string[] — Allowed user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f". - `blocked_idfas` string[] — Blocked user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f". - `allowed_zipcodes` string[] — Allowed zipcodes. - `blocked_zipcodes` string[] — Blocked zipcodes. - `allowed_device_models` string[] — Allowed device models. For example: "allowed_device_models": [ "KFFOWI", "KFGIWI", "KFTT", "KFJWA" ] - `blocked_device_models` string[] — Blocked device models. - `allowed_user_audience_tags` string[] — Allowed user custom audience tags. - `blocked_user_audience_tags` string[] — Blocked user custom audience tags. - `allowed_languages` string[] — Allowed languages. Languages in use mostly follow ISO 639-1 code(https://www.loc.gov/standards/iso639-2/php/code_list.php), e.g. "ko" for Korean and "en" for English. - `blocked_languages` string[] — Blocked languages. - `allowed_device_types` CommonDeviceType[] — Allowed device types. For example: "allowed_device_types": [ "HIGHEND_PHONE", "TABLET" ] - `blocked_device_types` CommonDeviceType[] — Blocked device types. For example: "allowed_device_types": [ "SET_TOP_BOX" ] - `allowed_mostly_visited_countries` string[] — This filter checks user's history of mostly visited countries against the specified countries in the condition, and passes a request if there is at least one common entry in both lists. - `blocked_mostly_visited_countries` string[] - `allowed_regions` string[] — Regions are to filter a bid-request based on its region information. - `blocked_regions` string[] - `allowed_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] — Recent Campaign activities filter a bid-request by user's recent activity such as click or install in the last n days. The filter is satisfied if there is at least one satisfying condition among the list. Example to target a user who has a click event for com.moloco.gameapp: "allowed_recent_campaign_activities": [ { "campaign_id": "com.moloco.gameapp", "event": "CLICK" } ] Example to block a user who has a install event for com.moloco.officeapp within the past five days: "blocked_recent_campaign_activities": [ { "campaign_id": "com.moloco.officeapp", "event": "INSTALL", "last_n_days": 5 } ] - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install. - `campaign_id` string, required — ID of the Campaign to filter on. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `blocked_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install. - `campaign_id` string, required — ID of the Campaign to filter on. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `allowed_locations` AudienceTargetingConditionLocationFilter[] — Location filter targets specific geo-locational audience using combined conditions of different types such as city, region, zipcode and geofence. - `cities` string[] - `regions` string[] - `zipcodes` string[] - `geofences` CommonCircle[] - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - … - `radius` number, double - `blocked_locations` AudienceTargetingConditionLocationFilter[] - `cities` string[] - `regions` string[] - `zipcodes` string[] - `geofences` CommonCircle[] - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - … - `radius` number, double - `genders` CommonGender[] - `connection_types` string[] — Connection_types include ETHERNET, WIFI, CELL_UNKNOWN, CELL_2G, CELL_3G, CELL_4G. For example: "connection_types": [ "WIFI", "CELL_4G" ] - `allowed_direct_deal_ids` string[] — IDs of the allowed direct deals. A bid-request is accepted only if there is at least one matching id. For example: "allowed_direct_deal_ids": [ "ip_9161499632014fe8b9ef60673a51b745", "ip_e13c0cb23dd54a8ea742b2af61e0712d", "ip_0cfeaebb190d47df8b86399232853e23" ] - `blocked_direct_deal_ids` string[] — IDs of the blocked direct deals. - `device_oses` AudienceTargetingConditionDeviceOsFilter[] — Device OS requirements if specified. - `os` 'UNKNOWN_DEVICE_OS' | 'ANDROID' | 'IOS' | 'VERSATILE' | 'MOBILE_WEB' | 'MACOS' | 'WINDOWS' | 'NEXT_VERSATILE', required — Enumeration of device OS types supported by Moloco Ads. This value is not part of the specification. - ANDROID: Android device OS. - IOS: iOS device OS. - VERSATILE: Product with multiple OSes. Specifically for CTV. - MOBILE_WEB: OS for mobile web traffic. - MACOS: OS for MacOS traffic. - WINDOWS: OS for Windows traffic. - NEXT_VERSATILE: OS for Next web product. - `min_version` string - `max_version` string - `media_channel_type` 'UNKNOWN_MEDIA_CHANNEL_TYPE' | 'APP' | 'WEB' — - UNKNOWN_MEDIA_CHANNEL_TYPE: This value is not part of the specification. - `new_users` AudienceTargetingConditionNewUserFilter — Filter to target new users only. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `advertiser_id_types` CommonAdvertiserIdType[] — Filter on advising ID types, including "ANDROID_IDFA" or "IOS_IDFA". - `allowed_video_types` DspAudienceTargetingConditionVideoType[] — Video type filter. Ignored when the bid request is not for video ads. - `blocked_video_types` DspAudienceTargetingConditionVideoType[] - `weekly_schedules` AudienceTargetingConditionWeeklyScheduleFilter[] — Weekly schedule specifies more fine-grained time range filtering for days of a week. For example, this list can be used to specify commute time ranges in the morning and evening on workdays. Example to target 7-9 am and 5-7 pm during week days: "weekly_schedules": [ { "hour_range": { "start": 7, "end": 9 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] }, { "hour_range": { "start": 17, "end": 19 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] } ] Example to target 10pm to 2am on Fridays and Saturdays: "weekly_schedules": [ { "range": { "start": 22, "end": 2 }, "days": [ "FRI", "SAT" ] } ] - `timezone_policy` 'UNKNOWN_TIME' | 'DEVICE_TIME' | 'UTC_TIME' | 'AD_ACCOUNT_TIME' | 'ADVERTISER_TIME' — TimezonePolicy defines the time configuration. - DEVICE_TIME: Time object is given in the device's time (depends on user device timezone). - UTC_TIME: Time object is given in the fixed UTC time (depends on nothing). - AD_ACCOUNT_TIME: Given time is given in fixed ad account time (depends on ad account timezone). - `hour_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `days` AdcloudcommonDayOfWeek[], required — Days of week to filter on. At least one is required. - `allowed_gender_score` AdcloudcommonFloatingPointRange - `start` number, double - `end` number, double - `blocked_gender_score` AdcloudcommonFloatingPointRange - `start` number, double - `end` number, double - `allowed_ages` AdcloudcommonInterval[] — Age is used to filter based on user's approximate age. A valid value must be in the exclusive range of (0, 100). - `start` integer - `end` integer - `blocked_ages` AdcloudcommonInterval[] - `start` integer - `end` integer - `allowed_ip_ranges` string[] — IP net based condition. The CIDR format must be used for an entry such as https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing. Note that both of IP v4 and v6 could be used at the same time. Example to block bid-requests with any IP within 32.76.52.0 - 32.76.52.255 or 127.0.0.0 - 127.255.255.255: "blocked_ip_ranges": [ "32.76.52.0/24", "127.0.0.0/8" ] - `blocked_ip_ranges` string[] - `allowed_device_carriers` string[] — Device carrier filter. Example to target SKT: "allowed_device_carriers": [ "SKTelecom" ] Example to exclude T-MOBILE and XFINITY Mobile "blocked_device_carriers": [ "T-MOBILE", "XFINITY Mobile" ] - `blocked_device_carriers` string[] - `allowed_keywords` string[] — Filter regarding 'keywords' field in a bid request. If specified, an ad request must have at least one of the allowed keywords to satisfy the filter. - `blocked_keywords` string[] — Filter regarding 'keywords' field in a bid request. An ad request must not have any of the blocked keywords to satisfy the filter. - `user_buckets` AdcloudcommonInterval[] — Filter for the user buckets. - `start` integer - `end` integer - `allowed_ad_units` string[] — // Target timetree_i_prod or timetree_a_prod ad_units "condition": { "allowed_ad_units": [ "timetree_i_prod", "timetree_a_prod" ] } // Exclude timetree_i_test ad_unit "condition": { "blocked_ad_units": [ "timetree_i_test" ] } - `blocked_ad_units` string[] - `allowed_placements` string[] — placement (a group of ad_units) names. It is untied to ad_units, and follow the ad_unit's filtering rule. - `blocked_placements` string[] - `allowed_banner_apis` CommonBannerApi[] — // Target MRAID_2 banner only "condition": { "allowed_banner_apis": [ "MRAID_2" ] } - `blocked_banner_apis` CommonBannerApi[] - `schedule` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `audience_data` CommonAudienceData — Audience Data. It is a filter based on AudienceData stored in UPT. - `provider` string - `condition` string - `allowed_apps_by_checksum` string[] — Allow apps by their checksum value. - `blocked_apps_by_checksum` string[] — Block apps by their checksum value. - `allowed_postback_event_counts` CommonPostbackEventCount[] — PostbackEventCount condition checks the number of specified events and accepts if there is one event that falls within given range of [start, end). In the example, User's event named "Transaction confirmation" must have been appeared 16 times or more to accept for zigbang app. Example: "condition": { "allowed_postback_event_counts": [ { "app_bundle": "com.chbreeze.jikbang4a", "range": { "start": 16, "end": 0 }, "events": [ "Transaction confirmation" ] } ] } - `app_bundle` string - `range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `events` string[] - `auction_types` string[] — Auction types including first price or second price auctions. Example: "condition": { "auction_types": [ "first", "second" ] } - `throttle_apt_tags` CommonTagsThrottleCondition — Tags Thrrottle Condition. It specifies a throttle rate for a list of tags. All the tags in a list will have same throttle rate. - `tags` string[] - `throttle_rate` number, float - `allowed_dev_makes` string[] — Allowed device make. Example: "condition":{ "allowed_dev_makes": [ "Apple" ] } - `blocked_dev_makes` string[] — Blocked device make. See the example of `allowed_dev_makes`. - `display_manager_versions` CommonDisplayManagerVersion[] — DisplayManager Version. Example: "condition": { "display_manager_versions": [ { "min": "1.2", "max": "4.5.6" } ] } // With minimum version requirement: "condition": { "display_manager_versions": [ { "min": "3.0" } ] } // With maximum version requirement: "condition": { "display_manager_versions": [ { "max": "5" } ] } - `min` string - `max` string - `allowed_audiences` string[] — Allowed audiences. - `blocked_audiences` string[] — Blocked audiences. - `allowed_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Postback event condition filter a bid-request by user's postback summary. Note that audience name and events are of case-sentitive string types. Each entry of allowed_postback_has_all_events_conditions will be satisfied when all listed events are found from user's postback summary. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `blocked_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_all_events_conditions will be satisfied when all listed events are not found from user's postback summary. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `allowed_postback_has_any_events_conditions` CommonPostbackEventsCondition[] - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `blocked_postback_has_any_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_any_events_conditions will be satisfied when there is at least one event not matched by the condition from user's postback summary. See the documentation for `allowed_postback_has_any_events_conditions`. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `allowed_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target. - `zipcodes` LocationSetZipCodeSet[] - `zipcodes` string[] — Zipcodes to represent areas to target. - `country` string — Uppercase Country code in ISO 3166-1 alpha-2. - `blocked_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target. - `zipcodes` LocationSetZipCodeSet[] - `zipcodes` string[] — Zipcodes to represent areas to target. - `country` string — Uppercase Country code in ISO 3166-1 alpha-2. - `allowed_apt_tags` string[] - `blocked_apt_tags` string[] - `coppa_acceptance` 'UNKNOWN_COPPA' | 'ACCEPT_COPPA_ONLY' | 'DENY_COPPA' — Indicates whether to bid according to the COPPA(Children's Online Privacy Protection Act) value of BidRequest. - UNKNOWN_COPPA: Doesn't filter BidRequest according to the coppa value. - ACCEPT_COPPA_ONLY: Bids to BidRequest with coppa=1. - DENY_COPPA: Bids to BidRequest with coppa=0 or empty coppa field. - `skan_traffic` 'UNKNOWN_SKAN' | 'TARGET_SKAN_ONLY' | 'TARGET_NON_SKAN' — Indicates whether to bid according to bid requests that support SKAN(SKAdNetwork) or not. - UNKNOWN_SKAN: Doesn't filter BidRequest according to support skan or not in this filter. - TARGET_SKAN_ONLY: Bids only for skan support traffic. - TARGET_NON_SKAN: Bids only for non-skan traffic. - `contains_custom_audience` boolean — Whether it contains a `custom_audience` targeting condition. The `custom_audience` targeting condition is legacy, and may contain some internal information. Therefore, we do not reveal them by the API but only signals its non-emptiness with this field. - `custom_audience_set` AudienceTargetingConditionCustomAudienceSet — CustomAudienceSet represents a group of target users to whom we're going to show an ad. CustomAudienceSet is consist of a dynamic (not pre-determined) set of target users based on App-events described in the postback messages and pre-defined CustomerSets. - `include_having_all` CustomAudienceSetCustomAudienceCondition - `app_events` CustomAudienceSetAppEvent[] - … - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included. - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type. - … - `include_having_any` CustomAudienceSetCustomAudienceCondition - `app_events` CustomAudienceSetAppEvent[] - … - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included. - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type. - … - `exclude_having_all` CustomAudienceSetCustomAudienceCondition - `app_events` CustomAudienceSetAppEvent[] - … - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included. - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type. - … - `exclude_having_any` CustomAudienceSetCustomAudienceCondition - `app_events` CustomAudienceSetAppEvent[] - … - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included. - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type. - … - `capper` AdclouddspAdCapper — AdCapper represents capping settings for an AdGroup. - `imp_interval` CommonTimeDuration — Represents a time duration with an amount and a unit. - `amount` string, int64 - `unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `pricing_model_id` string — PricingModel id. - `creative_group_ids` string[] — CreativeGroup IDs. These CreativeGroups' Product IDs must match the Product ID of the current Campaign. A Campaign eligible for serving must have at least one enabled CreativeGroup with enabled Creatives. - `user_buckets` AdcloudcommonInterval[] — User buckets for traffic control. - `start` integer - `end` integer - `audience_extension` DspAdGroupAudienceExtension — AdGroupAudienceExtension holds the ad_group settings for PAS audience extension. - `paired_ad_group_id` string — Audience extension paired ad group id. - `is_secondary` boolean — True for the secondary ad_group, otherwise false. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `aud_size` string, int64 — Original audience size information. - `matchable_aud_size` string, int64 — Matchable audience size information. - `last_aud_size_computed_at` string, date-time — Last updated time of the audience size information. - `customer_sets` DspCustomerSet[] — List of all the CustomerSet for queried Campaigns. - `id` string — Unique identifier of the CustomerSet. Automatically set by server on creation. - `title` string, required — A descriptive name of the CustomerSet. - `description` string — An optional description of the CustomerSet. - `id_type` 'UNKNOWN_ID_TYPE' | 'GOOGLE_ADID' | 'APPLE_IDFA', required — - UNKNOWN_ID_TYPE: Unknown user ID type. - GOOGLE_ADID: Google Android advertising ID type. - APPLE_IDFA: Apple iOS advertising ID type. - `status` 'UNKNOWN_STATUS' | 'PREPARING' | 'READY' | 'FAILED' — Unknown status. - PREPARING: Premature status. - READY: Ready. - FAILED: Failed to be ready. - `data_file_path` string, required — Data source path of users. ex) gcs path for txt file of specific-type user lists (query result for postback, or journal...). APPLE_IDFA user list txt file example: (one idfa per line). ______________________________________ 8a05cce7-da5c-4980-8cef-2603ae1742b6 ffffffff-ffff-4fff-8fff-ffffffffffff - `is_upper` boolean — A flag indicating that identifiers are upper-cased. False if they are lower-cased. - `auto_delete_at` string, date-time — CustomerSet used nowhere for specific time will be removed automatically. It represents when this will be deleted in UTC. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `recent_file_update_info` CustomerSetFileUpdateInfo - `status` 'UNKNOWN_STATUS' | 'IN_PROGRESS' | 'SUCCESS' | 'FAILED' — - IN_PROGRESS: Update is in progress. - SUCCESS: Update succeed. - FAILED: Update failed. Please check the contents format. - `timestamp` string, date-time — Update timestamp. - `file_name` string — Updated file name. - `status_detail` CustomerSetCustomerSetStatusDetail - `connection_method` 'UNKNOWN_METHOD' | 'CLOUD_API' | 'MCP_UPLOAD' | 'AF_AUDIENCE_BUILDER' | 'BESPOKE' — Connection method is an indicator of how the customer set file is updated. - CLOUD_API: Update via cloud API - MCP_UPLOAD: MCP Upload - AF_AUDIENCE_BUILDER: AF Audience Builder - BESPOKE: Bespoke - `error_id` 'UNKNOWN_ERROR_ID' | 'TAGGING_ERROR' | 'REQUEST_ERROR' | 'PREPROCESSING_ERROR' | 'GENERIC_ERROR' — Error id is an indicator of the error type. - `error_description` string — Error description is a detailed description of the error. - `csv_file_size` integer - `aud_size` integer — Audience size is the size of the audience in bytes. - `file_update_histories` CustomerSetFileUpdateHistory[] - `status` 'UNKNOWN_STATUS' | 'PREPARING' | 'READY' | 'FAILED' — Unknown status. - PREPARING: Premature status. - READY: Ready. - FAILED: Failed to be ready. - `status_detail` CustomerSetCustomerSetStatusDetail - `connection_method` 'UNKNOWN_METHOD' | 'CLOUD_API' | 'MCP_UPLOAD' | 'AF_AUDIENCE_BUILDER' | 'BESPOKE' — Connection method is an indicator of how the customer set file is updated. - CLOUD_API: Update via cloud API - MCP_UPLOAD: MCP Upload - AF_AUDIENCE_BUILDER: AF Audience Builder - BESPOKE: Bespoke - `error_id` 'UNKNOWN_ERROR_ID' | 'TAGGING_ERROR' | 'REQUEST_ERROR' | 'PREPROCESSING_ERROR' | 'GENERIC_ERROR' — Error id is an indicator of the error type. - `error_description` string — Error description is a detailed description of the error. - `csv_file_size` integer - `aud_size` integer — Audience size is the size of the audience in bytes. - `updated_at` string, date-time — Updated at is the timestamp when the status is changed. - `customer_activities` DspCustomerActivity[] — List of all the CustomerActivity for queried Campaigns. - `id` string — The server generated random unique identifier of the CustomerActivity. (Required/Immutable). - `title` string — The human readable short name. (Required/Mutable). - `description` string — The description about the CustomerActivity. (Optional/Mutable). - `include_having_all` CustomerActivityActivityCondition[] — This condition will include a customer only if all of the listed activity conditions are satisfied. - `product_id` string — The ID of the Product of which PostbackIntegration info is used. - `event` string — A case-sensitive string name of an event. (e.g. install, purchase). - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - `amount` string, int64 - `unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `include_having_any` CustomerActivityActivityCondition[] — This condition will include a customer if at least one condition from the listed activity conditions is satisfied. - `product_id` string — The ID of the Product of which PostbackIntegration info is used. - `event` string — A case-sensitive string name of an event. (e.g. install, purchase). - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - `amount` string, int64 - `unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `exclude_having_all` CustomerActivityActivityCondition[] — This condition will exclude a customer only if all of the listed activity conditions are satisfied.. - `product_id` string — The ID of the Product of which PostbackIntegration info is used. - `event` string — A case-sensitive string name of an event. (e.g. install, purchase). - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - `amount` string, int64 - `unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `exclude_having_any` CustomerActivityActivityCondition[] — This condition will exclude a customer if at least one condition from the listed activity conditions is satisfied. - `product_id` string — The ID of the Product of which PostbackIntegration info is used. - `event` string — A case-sensitive string name of an event. (e.g. install, purchase). - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - `amount` string, int64 - `unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `created_at` string, date-time - `updated_at` string, date-time - `tracking_links` DspTrackingLink[] — List of all the TrackingLink for queried Campaigns. - `id` string — Unique identifier of the TrackingLink. Automatically set by server on creation. - `ad_account_id` string — The ID of the AdAccount the TrackingLink belongs to. - `product_id` string — The ID of the Product the TrackingLink belongs to. - `title` string, required — A descriptive name of the TrackingLink. - `description` string — An optional description about the TrackingLink. - `device_os` 'UNKNOWN_DEVICE_OS' | 'ANDROID' | 'IOS' | 'VERSATILE' | 'MOBILE_WEB' | 'MACOS' | 'WINDOWS' | 'NEXT_VERSATILE', required — Enumeration of device OS types supported by Moloco Ads. This value is not part of the specification. - ANDROID: Android device OS. - IOS: iOS device OS. - VERSATILE: Product with multiple OSes. Specifically for CTV. - MOBILE_WEB: OS for mobile web traffic. - MACOS: OS for MacOS traffic. - WINDOWS: OS for Windows traffic. - NEXT_VERSATILE: OS for Next web product. - `click_through_link` TrackingLinkUrlData, required - `url` string, required — URL of the TrackingLink. - `status` 'UNKNOWN_VERIFICATION_STATUS' | 'UNVERIFIED' | 'VERIFYING' | 'VERIFIED' — Enumeration of various TrackingLink verification status. This value is not part of the specification. - UNVERIFIED: The TrackingLink is not yet verified. - VERIFYING: The TrackingLink is being verified. - VERIFIED: The TrackingLink has been verified. - `unverified_status_data` UrlDataUnverifiedStatusData — UnverifiedStatusData represents the information that the link is statically checked, but has not been verified with the MMP integration. - `stored_at` string, date-time — Creation time of this link. - `user_id` string — The ID of the user who created this link. - `verifying_status_data` UrlDataVerifyingStatusData — VerifyingStatusData represents the information that a resolved URL has been sent to the MMP, but we have not received any postback yet. We stay at this state indefinitely until receiving a postback. - `attempt_ids` string[] — Each of ID refers to a TrackingLinkVerificationAttempt. - `verified_status_data` UrlDataVerifiedStatusData — VerifiedStatusData represents the information of the completed verification. - `verified_attempt` DspTrackingLinkVerificationAttempt — TrackingLinkVerificationAttempt represents an attempt to verify a TrackingLink. - `id` string — The ID of the TrackingLinkVerificationAttempt. - `ad_account_id` string — The AdAccount ID that this attempt belongs to. - `tracking_link_id` string — The ID of the TrackingLink that this attempt belongs to. - `url_data_type` 'UNKNOWN_URL_DATA_TYPE' | 'CT_LINK' | 'VT_LINK' — The type of the UrlData that this attempt belongs to. - `user_id` string — The ID of the user who is conducting the link verification. - `user_email` string — The user's email. - `user_name` string — The user's name. - `tracking_bundle_id` string — The tracking bundle value appears at the postback event. - `resolved_url` string — The URL sent to the MMP for the verification test. This is the macro expansion result of the original link URL. - `resolved_idfa` string — The IDFA value used to generate the resolved_url. - `started_at` string, date-time — The starting time of the verification. - `verified_at` string, date-time — The time when the verification test is completed. - `view_through_link` TrackingLinkUrlData - `url` string, required — URL of the TrackingLink. - `status` 'UNKNOWN_VERIFICATION_STATUS' | 'UNVERIFIED' | 'VERIFYING' | 'VERIFIED' — Enumeration of various TrackingLink verification status. This value is not part of the specification. - UNVERIFIED: The TrackingLink is not yet verified. - VERIFYING: The TrackingLink is being verified. - VERIFIED: The TrackingLink has been verified. - `unverified_status_data` UrlDataUnverifiedStatusData — UnverifiedStatusData represents the information that the link is statically checked, but has not been verified with the MMP integration. - `stored_at` string, date-time — Creation time of this link. - `user_id` string — The ID of the user who created this link. - `verifying_status_data` UrlDataVerifyingStatusData — VerifyingStatusData represents the information that a resolved URL has been sent to the MMP, but we have not received any postback yet. We stay at this state indefinitely until receiving a postback. - `attempt_ids` string[] — Each of ID refers to a TrackingLinkVerificationAttempt. - `verified_status_data` UrlDataVerifiedStatusData — VerifiedStatusData represents the information of the completed verification. - `verified_attempt` DspTrackingLinkVerificationAttempt — TrackingLinkVerificationAttempt represents an attempt to verify a TrackingLink. - `id` string — The ID of the TrackingLinkVerificationAttempt. - `ad_account_id` string — The AdAccount ID that this attempt belongs to. - `tracking_link_id` string — The ID of the TrackingLink that this attempt belongs to. - `url_data_type` 'UNKNOWN_URL_DATA_TYPE' | 'CT_LINK' | 'VT_LINK' — The type of the UrlData that this attempt belongs to. - `user_id` string — The ID of the user who is conducting the link verification. - `user_email` string — The user's email. - `user_name` string — The user's name. - `tracking_bundle_id` string — The tracking bundle value appears at the postback event. - `resolved_url` string — The URL sent to the MMP for the verification test. This is the macro expansion result of the original link URL. - `resolved_idfa` string — The IDFA value used to generate the resolved_url. - `started_at` string, date-time — The starting time of the verification. - `verified_at` string, date-time — The time when the verification test is completed. - `ctv_adjust_dual_vt_link` TrackingLinkUrlData - `url` string, required — URL of the TrackingLink. - `status` 'UNKNOWN_VERIFICATION_STATUS' | 'UNVERIFIED' | 'VERIFYING' | 'VERIFIED' — Enumeration of various TrackingLink verification status. This value is not part of the specification. - UNVERIFIED: The TrackingLink is not yet verified. - VERIFYING: The TrackingLink is being verified. - VERIFIED: The TrackingLink has been verified. - `unverified_status_data` UrlDataUnverifiedStatusData — UnverifiedStatusData represents the information that the link is statically checked, but has not been verified with the MMP integration. - `stored_at` string, date-time — Creation time of this link. - `user_id` string — The ID of the user who created this link. - `verifying_status_data` UrlDataVerifyingStatusData — VerifyingStatusData represents the information that a resolved URL has been sent to the MMP, but we have not received any postback yet. We stay at this state indefinitely until receiving a postback. - `attempt_ids` string[] — Each of ID refers to a TrackingLinkVerificationAttempt. - `verified_status_data` UrlDataVerifiedStatusData — VerifiedStatusData represents the information of the completed verification. - `verified_attempt` DspTrackingLinkVerificationAttempt — TrackingLinkVerificationAttempt represents an attempt to verify a TrackingLink. - `id` string — The ID of the TrackingLinkVerificationAttempt. - `ad_account_id` string — The AdAccount ID that this attempt belongs to. - `tracking_link_id` string — The ID of the TrackingLink that this attempt belongs to. - `url_data_type` 'UNKNOWN_URL_DATA_TYPE' | 'CT_LINK' | 'VT_LINK' — The type of the UrlData that this attempt belongs to. - `user_id` string — The ID of the user who is conducting the link verification. - `user_email` string — The user's email. - `user_name` string — The user's name. - `tracking_bundle_id` string — The tracking bundle value appears at the postback event. - `resolved_url` string — The URL sent to the MMP for the verification test. This is the macro expansion result of the original link URL. - `resolved_idfa` string — The IDFA value used to generate the resolved_url. - `started_at` string, date-time — The starting time of the verification. - `verified_at` string, date-time — The time when the verification test is completed. - `tracking_company` 'UNKNOWN_TRACKING_COMPANY' | 'KOCHAVA' | 'ADJUST' | 'MAT' | 'MOLOCO_PIXEL' | 'APPSFLYER' | 'ADBRIX' | 'WEB' | 'GENERIC' | 'TRACKFNT' | 'AIRBRIDGE' | 'MOLOCO_E2E' | 'APSALAR' | 'BRANCH' | 'TENJIN' | 'SINGULAR' | 'ADBRIX_V2' | 'TRAFFICGUARD' | 'GAMELOFT' | 'SKADNETWORK' | 'MYTRACKER' | 'MOLOCO_RMP' | 'MOLOCO_PIXEL_V2' | 'JUSTTRACK' | 'SHOPEE' | 'KOCHAVA_FOR_PUBLISHER' | 'GAMESIGHT' | 'CAULY' | 'HASOFFER' | 'ADACTION' | 'CURATE' — Enumeration for tracking companies supported by Moloco Ads. - WEB: Unnamed trackers - AIRBRIDGE: Moloco's e2e tracker (test purpose only) - KOCHAVA_FOR_PUBLISHER: Kochava's CTV to web event dedicated tracking company. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `creative_groups` DspReadCreativeGroupOverview[] — List of all the CreativeGroup for queried Campaigns. - `creative_group` DspCreativeGroup — CreativeGroup is a group of Creatives that may serve with the same purpose, to be referenced by a Campaign. - `id` string — Unique identifier of the CreativeGroup. Automatically set by server on creation. - `ad_account_id` string — ID of the AdAccount the CreativeGroup belongs to. - `product_id` string — ID of the Product the CreativeGroup belongs to. - `title` string, required — A descriptive name of the CreativeGroup. - `description` string — An optional description about this CreativeGroup. - `enabling_state` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED' — Enumeration of the enabling states with a default UNSPECIFIED state. - `creative_ids` string[] — List of Creative ids in this CreativeGroup. - `status` 'UNKNOWN_STATUS' | 'DRAFT' | 'SUBMITTED' | 'REVIEW_NOT_NEEDED' | 'UNDER_REVIEW' | 'APPROVED' | 'DISAPPROVED' — Enumeration of all possible CreativeGroup status. - UNKNOWN_STATUS: This value is not part of the specification. - DRAFT: The CreativeGroup is created but not submitted for review yet. - SUBMITTED: The CreativeGroup is submitted and pending review. - REVIEW_NOT_NEEDED: Review is determined by Moloco not needed for this CreativeGroup. - UNDER_REVIEW: The CreativeGroup is being reviewed. - APPROVED: The CreativeGroup has been approved. - DISAPPROVED: The CreativeGroup has been rejected. - `action_history` DspCreativeGroupAction[] — List of actions taken on the current Creative. - `id` string — Unique identifier of the Action. Automatically set by server on creation. - `user_id` string — ID of the user who initiated this action if it's applicable. - `user_display_name` string — Display name of the user by whom the action was taken. - `action_type` 'UNKNOWN_TYPE' | 'CREATE' | 'UPDATE' | 'START_REVIEW' | 'DISAPPROVE' | 'APPROVE' | 'REQUEST_REVIEW' — Enumeration of all supported CreativeGroup action types. - UNKNOWN_TYPE: This value is not part of the specification. - CREATE: The user created the CreativeGroup. The status of a new Creative will be set to SUBMITTED upon creation. - UPDATE: The user updated the CreativeGroup. The status of the CreativeGroup may be set to SUBMITTED for some significant updates. - START_REVIEW: The reviewer user started the review of the CreativeGroup. The status of the CreativeGroup will be set to UNDER_REVIEW. - DISAPPROVE: The reviewer user reviewed and disapproved the CreativeGroup. The status of the CreativeGroup will be set to DISAPPROVED. - APPROVE: The reviewer user reviewed and approved the CreativeGroup. The status of the CreativeGroup will be set to APPROVED. - REQUEST_REVIEW: Request the CreativeGroup to be reviewed. The CreativeGroup could previously be in UNDER_REVIEW, APPROVED or DISAPPROVED state. - `comment` string — Comment for the action. - `created_at` string, date-time — Created time. - `tracking_link_id` string — MMP specific impression and click TrackingLinks defined specifically for this CreativeGroup. Optional for CreativeGroup which has APP type Product, not allowed for WEB type Product. - `landing_url` string — CreativeGroup specific landing URL. Optional for CreativeGroup which has WEB type Product, not allowed for APP type Product. - `final_landing_url` string — CreativeGroup specific final landing URL. Optional for CreativeGroup which has WEB type Product, not allowed for APP type Product. Deprecated. v1.3 would be the last version supporting this field. Use landing_url field instead. - `mmp_tag` string — Name of the mmp side reporting tag. mmp_tag should be URL-safe string. - `audience` AdclouddspAudience — Audience is a final form of AudienceTargeting specification. It is represented by a list of IDs of SharedAudienceTargets and an ad-hoc target condition. All conditions in the audience specification must be met to accept a bid-request. IDs of the SharedAudienceTargets can be either at global or AdAccount level. - `shared_audience_target_ids` string[] — A list of IDs for the named AudienceTargets referenced by this audience specification. - `targeting_condition` DspAudienceTargetingCondition — AudienceTargetingCondition specifies conditions for AudienceTargeting. This condition object contains various filters on multiple dimensions of bid-request, app, and user. Advertisers can selectively configure desired filters to form a meaningful AudienceTarget condition collectively. The configured individual filters must be satisfied unanimously in order for the resulting collective condition to be satisfied. Only filters with values will be effective. When a filter condition accepts a list of values, i.e., list of countries for "allowed_countries", the filter condition will be met when any match is found among the list. String literals are case insensitive unless specified otherwise; i.e. "USA" and "usa" equally represents the United States of America. - `allowed_countries` string[] — Allowed countries in ISO_3166-1_alpha-3 format. - `blocked_countries` string[] — Blocked countries in ISO_3166-1_alpha-3 format. - `placement_reasons` AudienceTargetingConditionPlacementReason[] - `custom_placement_reason` string — The reason of the placement in free-form text. - `allowed_app_bundles` string[] — App bundles. A bid-request having a matching publisher app bundle from the list will be accepted. Example to target com.moloco.game or com.moloco.travel apps: "allowed_app_bundles": [ "com.moloco.game", "com.moloco.travel" ] Example to exclude com.moloco.office app: "blocked_app_bundles": [ "com.moloco.office" ] - `blocked_app_bundles` string[] — See the documentation for `allowed_app_bundles`. - `allowed_content_categories` string[] — Filter for allowed publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "allowed_content_categories": [ "IAB26-1" ] - `blocked_content_categories` string[] — Filter for blocked publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "blocked_content_categories": [ "IAB26-1" ] - `allowed_cities` string[] — Allowed cities. A bid-request will be accepted when there is at least one match from the city list. Note that each element must be in the form of "city, region" such as "Seattle, WA" in order to disambiguate the same city but different regions. The entry is case-insensitive and whitespace will be ignored. Example to target Seattle or Newyork: "allowed_cities": [ "Seattle, WA", "Newyork, ny" ] - `blocked_cities` string[] — Blocked cities. - `allowed_creative_types` AdcloudcommonCreativeType[] — Allowed Creative types. - `blocked_creative_types` AdcloudcommonCreativeType[] — Blocked Creative types. - `allowed_websites` string[] — Allowed websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "allowed_websites": [ "*youtube.com" ]. - `blocked_websites` string[] — Blocked websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "blocked_websites": [ "*example.com" ]. - `allowed_geofences` CommonCircle[] — Allowed geofences. - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - … - `radius` number, double - `blocked_geofences` CommonCircle[] — Blocked geofences. - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - … - `radius` number, double - `allowed_exchanges` CommonAdExchange[] — Allowed ad exchanges. Restricts targeting to bid only on the listed exchanges; an empty list places no restriction. MOLOCO_SDK is automatically included whenever the list is non-empty: submitting a non-empty list that omits MOLOCO_SDK will have it appended on the server side. - `blocked_exchanges` CommonAdExchange[] — Blocked ad exchanges. Excludes the listed exchanges from targeting. Adding MOLOCO_SDK to this list is rejected with PERMISSION_DENIED. - `allowed_idfas` string[] — Allowed user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f". - `blocked_idfas` string[] — Blocked user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f". - `allowed_zipcodes` string[] — Allowed zipcodes. - `blocked_zipcodes` string[] — Blocked zipcodes. - `allowed_device_models` string[] — Allowed device models. For example: "allowed_device_models": [ "KFFOWI", "KFGIWI", "KFTT", "KFJWA" ] - `blocked_device_models` string[] — Blocked device models. - `allowed_user_audience_tags` string[] — Allowed user custom audience tags. - `blocked_user_audience_tags` string[] — Blocked user custom audience tags. - `allowed_languages` string[] — Allowed languages. Languages in use mostly follow ISO 639-1 code(https://www.loc.gov/standards/iso639-2/php/code_list.php), e.g. "ko" for Korean and "en" for English. - `blocked_languages` string[] — Blocked languages. - `allowed_device_types` CommonDeviceType[] — Allowed device types. For example: "allowed_device_types": [ "HIGHEND_PHONE", "TABLET" ] - `blocked_device_types` CommonDeviceType[] — Blocked device types. For example: "allowed_device_types": [ "SET_TOP_BOX" ] - `allowed_mostly_visited_countries` string[] — This filter checks user's history of mostly visited countries against the specified countries in the condition, and passes a request if there is at least one common entry in both lists. - `blocked_mostly_visited_countries` string[] - `allowed_regions` string[] — Regions are to filter a bid-request based on its region information. - `blocked_regions` string[] - `allowed_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] — Recent Campaign activities filter a bid-request by user's recent activity such as click or install in the last n days. The filter is satisfied if there is at least one satisfying condition among the list. Example to target a user who has a click event for com.moloco.gameapp: "allowed_recent_campaign_activities": [ { "campaign_id": "com.moloco.gameapp", "event": "CLICK" } ] Example to block a user who has a install event for com.moloco.officeapp within the past five days: "blocked_recent_campaign_activities": [ { "campaign_id": "com.moloco.officeapp", "event": "INSTALL", "last_n_days": 5 } ] - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install. - `campaign_id` string, required — ID of the Campaign to filter on. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `blocked_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install. - `campaign_id` string, required — ID of the Campaign to filter on. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `allowed_locations` AudienceTargetingConditionLocationFilter[] — Location filter targets specific geo-locational audience using combined conditions of different types such as city, region, zipcode and geofence. - `cities` string[] - `regions` string[] - `zipcodes` string[] - `geofences` CommonCircle[] - … - `blocked_locations` AudienceTargetingConditionLocationFilter[] - `cities` string[] - `regions` string[] - `zipcodes` string[] - `geofences` CommonCircle[] - … - `genders` CommonGender[] - `connection_types` string[] — Connection_types include ETHERNET, WIFI, CELL_UNKNOWN, CELL_2G, CELL_3G, CELL_4G. For example: "connection_types": [ "WIFI", "CELL_4G" ] - `allowed_direct_deal_ids` string[] — IDs of the allowed direct deals. A bid-request is accepted only if there is at least one matching id. For example: "allowed_direct_deal_ids": [ "ip_9161499632014fe8b9ef60673a51b745", "ip_e13c0cb23dd54a8ea742b2af61e0712d", "ip_0cfeaebb190d47df8b86399232853e23" ] - `blocked_direct_deal_ids` string[] — IDs of the blocked direct deals. - `device_oses` AudienceTargetingConditionDeviceOsFilter[] — Device OS requirements if specified. - `os` 'UNKNOWN_DEVICE_OS' | 'ANDROID' | 'IOS' | 'VERSATILE' | 'MOBILE_WEB' | 'MACOS' | 'WINDOWS' | 'NEXT_VERSATILE', required — Enumeration of device OS types supported by Moloco Ads. This value is not part of the specification. - ANDROID: Android device OS. - IOS: iOS device OS. - VERSATILE: Product with multiple OSes. Specifically for CTV. - MOBILE_WEB: OS for mobile web traffic. - MACOS: OS for MacOS traffic. - WINDOWS: OS for Windows traffic. - NEXT_VERSATILE: OS for Next web product. - `min_version` string - `max_version` string - `media_channel_type` 'UNKNOWN_MEDIA_CHANNEL_TYPE' | 'APP' | 'WEB' — - UNKNOWN_MEDIA_CHANNEL_TYPE: This value is not part of the specification. - `new_users` AudienceTargetingConditionNewUserFilter — Filter to target new users only. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `advertiser_id_types` CommonAdvertiserIdType[] — Filter on advising ID types, including "ANDROID_IDFA" or "IOS_IDFA". - `allowed_video_types` DspAudienceTargetingConditionVideoType[] — Video type filter. Ignored when the bid request is not for video ads. - `blocked_video_types` DspAudienceTargetingConditionVideoType[] - `weekly_schedules` AudienceTargetingConditionWeeklyScheduleFilter[] — Weekly schedule specifies more fine-grained time range filtering for days of a week. For example, this list can be used to specify commute time ranges in the morning and evening on workdays. Example to target 7-9 am and 5-7 pm during week days: "weekly_schedules": [ { "hour_range": { "start": 7, "end": 9 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] }, { "hour_range": { "start": 17, "end": 19 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] } ] Example to target 10pm to 2am on Fridays and Saturdays: "weekly_schedules": [ { "range": { "start": 22, "end": 2 }, "days": [ "FRI", "SAT" ] } ] - `timezone_policy` 'UNKNOWN_TIME' | 'DEVICE_TIME' | 'UTC_TIME' | 'AD_ACCOUNT_TIME' | 'ADVERTISER_TIME' — TimezonePolicy defines the time configuration. - DEVICE_TIME: Time object is given in the device's time (depends on user device timezone). - UTC_TIME: Time object is given in the fixed UTC time (depends on nothing). - AD_ACCOUNT_TIME: Given time is given in fixed ad account time (depends on ad account timezone). - `hour_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `days` AdcloudcommonDayOfWeek[], required — Days of week to filter on. At least one is required. - `allowed_gender_score` AdcloudcommonFloatingPointRange - `start` number, double - `end` number, double - `blocked_gender_score` AdcloudcommonFloatingPointRange - `start` number, double - `end` number, double - `allowed_ages` AdcloudcommonInterval[] — Age is used to filter based on user's approximate age. A valid value must be in the exclusive range of (0, 100). - `start` integer - `end` integer - `blocked_ages` AdcloudcommonInterval[] - `start` integer - `end` integer - `allowed_ip_ranges` string[] — IP net based condition. The CIDR format must be used for an entry such as https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing. Note that both of IP v4 and v6 could be used at the same time. Example to block bid-requests with any IP within 32.76.52.0 - 32.76.52.255 or 127.0.0.0 - 127.255.255.255: "blocked_ip_ranges": [ "32.76.52.0/24", "127.0.0.0/8" ] - `blocked_ip_ranges` string[] - `allowed_device_carriers` string[] — Device carrier filter. Example to target SKT: "allowed_device_carriers": [ "SKTelecom" ] Example to exclude T-MOBILE and XFINITY Mobile "blocked_device_carriers": [ "T-MOBILE", "XFINITY Mobile" ] - `blocked_device_carriers` string[] - `allowed_keywords` string[] — Filter regarding 'keywords' field in a bid request. If specified, an ad request must have at least one of the allowed keywords to satisfy the filter. - `blocked_keywords` string[] — Filter regarding 'keywords' field in a bid request. An ad request must not have any of the blocked keywords to satisfy the filter. - `user_buckets` AdcloudcommonInterval[] — Filter for the user buckets. - `start` integer - `end` integer - `allowed_ad_units` string[] — // Target timetree_i_prod or timetree_a_prod ad_units "condition": { "allowed_ad_units": [ "timetree_i_prod", "timetree_a_prod" ] } // Exclude timetree_i_test ad_unit "condition": { "blocked_ad_units": [ "timetree_i_test" ] } - `blocked_ad_units` string[] - `allowed_placements` string[] — placement (a group of ad_units) names. It is untied to ad_units, and follow the ad_unit's filtering rule. - `blocked_placements` string[] - `allowed_banner_apis` CommonBannerApi[] — // Target MRAID_2 banner only "condition": { "allowed_banner_apis": [ "MRAID_2" ] } - `blocked_banner_apis` CommonBannerApi[] - `schedule` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `audience_data` CommonAudienceData — Audience Data. It is a filter based on AudienceData stored in UPT. - `provider` string - `condition` string - `allowed_apps_by_checksum` string[] — Allow apps by their checksum value. - `blocked_apps_by_checksum` string[] — Block apps by their checksum value. - `allowed_postback_event_counts` CommonPostbackEventCount[] — PostbackEventCount condition checks the number of specified events and accepts if there is one event that falls within given range of [start, end). In the example, User's event named "Transaction confirmation" must have been appeared 16 times or more to accept for zigbang app. Example: "condition": { "allowed_postback_event_counts": [ { "app_bundle": "com.chbreeze.jikbang4a", "range": { "start": 16, "end": 0 }, "events": [ "Transaction confirmation" ] } ] } - `app_bundle` string - `range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `events` string[] - `auction_types` string[] — Auction types including first price or second price auctions. Example: "condition": { "auction_types": [ "first", "second" ] } - `throttle_apt_tags` CommonTagsThrottleCondition — Tags Thrrottle Condition. It specifies a throttle rate for a list of tags. All the tags in a list will have same throttle rate. - `tags` string[] - `throttle_rate` number, float - `allowed_dev_makes` string[] — Allowed device make. Example: "condition":{ "allowed_dev_makes": [ "Apple" ] } - `blocked_dev_makes` string[] — Blocked device make. See the example of `allowed_dev_makes`. - `display_manager_versions` CommonDisplayManagerVersion[] — DisplayManager Version. Example: "condition": { "display_manager_versions": [ { "min": "1.2", "max": "4.5.6" } ] } // With minimum version requirement: "condition": { "display_manager_versions": [ { "min": "3.0" } ] } // With maximum version requirement: "condition": { "display_manager_versions": [ { "max": "5" } ] } - `min` string - `max` string - `allowed_audiences` string[] — Allowed audiences. - `blocked_audiences` string[] — Blocked audiences. - `allowed_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Postback event condition filter a bid-request by user's postback summary. Note that audience name and events are of case-sentitive string types. Each entry of allowed_postback_has_all_events_conditions will be satisfied when all listed events are found from user's postback summary. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - … - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `blocked_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_all_events_conditions will be satisfied when all listed events are not found from user's postback summary. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - … - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `allowed_postback_has_any_events_conditions` CommonPostbackEventsCondition[] - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - … - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `blocked_postback_has_any_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_any_events_conditions will be satisfied when there is at least one event not matched by the condition from user's postback summary. See the documentation for `allowed_postback_has_any_events_conditions`. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - … - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - … - `allowed_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target. - `zipcodes` LocationSetZipCodeSet[] - … - `blocked_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target. - `zipcodes` LocationSetZipCodeSet[] - … - `allowed_apt_tags` string[] - `blocked_apt_tags` string[] - `coppa_acceptance` 'UNKNOWN_COPPA' | 'ACCEPT_COPPA_ONLY' | 'DENY_COPPA' — Indicates whether to bid according to the COPPA(Children's Online Privacy Protection Act) value of BidRequest. - UNKNOWN_COPPA: Doesn't filter BidRequest according to the coppa value. - ACCEPT_COPPA_ONLY: Bids to BidRequest with coppa=1. - DENY_COPPA: Bids to BidRequest with coppa=0 or empty coppa field. - `skan_traffic` 'UNKNOWN_SKAN' | 'TARGET_SKAN_ONLY' | 'TARGET_NON_SKAN' — Indicates whether to bid according to bid requests that support SKAN(SKAdNetwork) or not. - UNKNOWN_SKAN: Doesn't filter BidRequest according to support skan or not in this filter. - TARGET_SKAN_ONLY: Bids only for skan support traffic. - TARGET_NON_SKAN: Bids only for non-skan traffic. - `contains_custom_audience` boolean — Whether it contains a `custom_audience` targeting condition. The `custom_audience` targeting condition is legacy, and may contain some internal information. Therefore, we do not reveal them by the API but only signals its non-emptiness with this field. - `custom_audience_set` AudienceTargetingConditionCustomAudienceSet — CustomAudienceSet represents a group of target users to whom we're going to show an ad. CustomAudienceSet is consist of a dynamic (not pre-determined) set of target users based on App-events described in the postback messages and pre-defined CustomerSets. - `include_having_all` CustomAudienceSetCustomAudienceCondition - … - `include_having_any` CustomAudienceSetCustomAudienceCondition - … - `exclude_having_all` CustomAudienceSetCustomAudienceCondition - … - `exclude_having_any` CustomAudienceSetCustomAudienceCondition - … - `feature` DspCreativeFeature — CreativeFeature indicates the feature of the CreativeGroup and its configuration. - `type` 'UNKNOWN_CREATIVE_FEATURE_TYPE' | 'GENERAL' | 'DYNAMIC_CREATIVE' — CreativeFeatureType. - `dynamic_creative` CreativeFeatureDynamicCreative — Detailed configuration of DYNAMIC_CREATIVE feature. - `app_icon_url` string — An app icon URL used by MRAID template. - `brand_logo_url` string — A brand image URL used by MRAID template. - `business_title` string — A business title used by template. - `cta_text` string — Call-To-Action text. - `cta_color` string — CTA button(background) color, do not confuse with cta_text_color. - `image_border_color` string — Border color around image from catalog. - `title_preamble` string — preamble for title. - `main_text` string — A custom text for some templates. - `main_text_color` string — Main text color. - `cta_text_color` string — CTA text color, do not confuse with cta_color. - `background_color` string — background color of dynamic creative. - `price_locale` string — Locale for creatives. It is used to render prices. - `disclaimer_text` string — Disclaimer text. - `disclaimer_text_color` string — Disclaimer text color. - `sponsored_by` string — Brand name of the sponsor/advertiser. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `publisher_properties` DspCreativeGroupPublisherProperties - `skippable` boolean - `video_target_ad_position` 'DEFAULT' | 'FIRST_AD_ONLY' | 'LAST_AD_ONLY' — Target ad position for the video source. - `state` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED' — Enumeration of the enabling states with a default UNSPECIFIED state. - `inactive_reasons` DspCreativeGroupInactiveReason[] — Inactive reasons of CreativeGroup if the CreativeGroup is not used for bidding. - NO_CREATIVE: It implies that the CreativeGroup has no Creative. - NO_ADGROUP: It implies that the CreativeGroup is not linked to any AdGroup. - SCHEDULED: It implies that the CreativeGroup is scheduled to run at a future day/time. - NO_ENABLED_CREATIVE: It implies that the CreativeGroup has no enabled Creative. If a CreativeGroup has NO_CREATIVE as inactive reasons, NO_ENABLED_CREATIVE won't be included. - NO_ENABLED_ADGROUP: It implies that the CreativeGroup is not linked to any enabled AdGroup. If a CreativeGroup has NO_ADGROUP as inactive reasons, NO_ENABLED_ADGROUP won't be included. - NO_ENABLED_CAMPAIGN: It implies that the CreativeGroup is not linked to any enabled Campaign. If a CreativeGroup has NO_ADGROUP as inactive reasons, which implies it doesn't belongs to any campaign too, so NO_ENABLED_CAMPAIGN won't be included. - DISABLED_CREATIVE_GROUP: It implies that the CreativeGroup's enabling state is set as DISABLED. - ENDED: It implies that the CreativeGroup has passed its schedule end date. - `creative_group_referrer_infos` DspCreativeGroupReferrerInfo[] — CreativeGroupReferrerInfo is data of the CreativeGroup's relational entities which use the CreativeGroup. - `ad_group_id` string — ID of the AdGroup. - `ad_group_title` string — Title of the AdGroup. - `ad_group_state` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED' — Enumeration of the enabling states with a default UNSPECIFIED state. - `ad_group_experiment_id` string — ID of the Experiment the AdGroup is involved in. - `campaign_id` string — ID of the Campaign. - `campaign_title` string — Title of the Campaign. - `campaign_description` string — Description of the Campaign. - `campaign_state` 'UNKNOWN_CAMPAIGN_STATE' | 'SUBMITTED' | 'READY' | 'UPCOMING' | 'ACTIVE' | 'PAUSED' | 'SUSPENDED' | 'COMPLETED' — CampaignState represents various states of a Campaign. This value is not part of the specification. - SUBMITTED: All the required data are entered and passed all the validation. It's eligible to be reviewed by Moloco for activation. - READY: Campaign is before schedule and internally ready but disabled. Will transit to PAUSED when it becomes on schdule. - UPCOMING: Campaign is before schedule and internally ready and disabled. Will transit to ACTIVE when it becomes on schdule. - ACTIVE: Campaign is on schedule and spending the budget. - PAUSED: Campaign is paused and not spending the budget. - SUSPENDED: Campaign activation is suspended by the system for the following reasons: - App has been found to be in violation of Moloco's creative policy. - COMPLETED: Campaign is completed but may still get attributions for some time. - `campaign_type` 'UNKNOWN_CAMPAIGN_TYPE' | 'GENERIC' | 'APP_USER_ACQUISITION' | 'APP_REENGAGEMENT' | 'WEBSITE_VISIT' | 'CTV_GENERIC' | 'CTV_APP_USER_ACQUISITION' | 'WEB_USER_ACQUISITION' | 'CTV_WEBSITE_VISIT' | 'WEB_RETARGETING' — CampaignType represents the type of a Campaign. It captures the goal of the Campaign at a high level. This value is not part of the specification. - GENERIC: Campaign is for generic purpose (only for legacy Campaigns). - APP_USER_ACQUISITION: The goal of the Campaign is to drive app user acquisitions. - APP_REENGAGEMENT: The goal of the Campaign is to drive app reengagement. - WEBSITE_VISIT: The goal of the Campaign is to drive website visits. - CTV_GENERIC: Campaign is for the general CTV ad. - CTV_APP_USER_ACQUISITION: Campaign is for the mobile app install CTV ad. - WEB_USER_ACQUISITION: The goal of the Campaign is to drive web user acquisitions. Originally, this was used for APP to WEB user acquisition. However, it is now also used for WEB to WEB user acquisition. - CTV_WEBSITE_VISIT: Campaign is for the website visit CTV ad. - WEB_RETARGETING: The goal of the Campaign is to drive web retargeting. Currently, this is used for WEB to WEB retargeting. - `campaign_goal` DspCampaignGoal — CampaignGoal describes the details of goal of a Campaign. - `type` 'UNKNOWN_TYPE' | 'OPTIMIZE_NONE' | 'FIXED_CPM_FOR_APP_UA' | 'FIXED_CPM_FOR_APP_RE' | 'OPTIMIZE_CPI_FOR_APP_UA' | 'OPTIMIZE_CPA_FOR_APP_UA' | 'OPTIMIZE_CPC_FOR_APP_UA' | 'OPTIMIZE_ROAS_FOR_APP_UA' | 'OPTIMIZE_ROAS_FOR_APP_RE' | 'OPTIMIZE_CPC_FOR_APP_RE' | 'OPTIMIZE_CPC_FOR_WEB_VISIT' | 'OPTIMIZE_APP_INSTALLS' | 'OPTIMIZE_APP_ROAS' | 'OPTIMIZE_CLICKS_TO_WEB' | 'OPTIMIZE_CLICKS_TO_APP' | 'OPTIMIZE_CPA_FOR_APP_RE' | 'OPTIMIZE_RETENTION_FOR_APP_UA' | 'OPTIMIZE_REATTRIBUTION_FOR_APP' | 'OPTIMIZE_CPA_REPEATED_FOR_APP_UA' | 'FIXED_CPM_GENERIC' | 'FIXED_CPM_FOR_CTV' | 'FIXED_CPM_FOR_WEB_VISIT' | 'OPTIMIZE_LANDING_FOR_WEB_UA' | 'OPTIMIZE_CPA_FOR_WEB_UA', required — Type enumerates available Campaign goal types. Corresponding details to the type must be specified. - OPTIMIZE_NONE: Goal type for the Campaigns which do not use any of pricing engines. - FIXED_CPM_FOR_APP_UA: Goal type for the UA Campaigns which do not use any of pricing engines. - FIXED_CPM_FOR_APP_RE: Goal type for the RE Campaigns which do not use any of pricing engines. - OPTIMIZE_CPI_FOR_APP_UA: Aim to drive app installs while satisfying the long-term cost per install. - OPTIMIZE_CPA_FOR_APP_UA: Aim to drive app installs while satisfying long-term cost per (certain) action. - OPTIMIZE_CPC_FOR_APP_UA: Aim to drive app installs while satisfying long-term cost per click. - OPTIMIZE_ROAS_FOR_APP_UA: Aim to drive app installs while satisfying long-term return on advertising spend (ROAS). - OPTIMIZE_ROAS_FOR_APP_RE: Aim to drive the user re-engagements while satisfying long-term return on advertising spend (ROAS). - OPTIMIZE_CPC_FOR_APP_RE: Aim to drive the user re-engagements while satisfying long-term cost per click. - OPTIMIZE_CPC_FOR_WEB_VISIT: Aim to drive the web-site visit while satisfying long-term cost per click. - OPTIMIZE_APP_INSTALLS: Deprecated. Aim to drive app installs while satisfying long-term cost per install. - OPTIMIZE_APP_ROAS: Deprecated. Aim to drive certain in-app actions while satisfying long-term return on advertising spend (ROAS). - OPTIMIZE_CLICKS_TO_WEB: Deprecated. Aim to drive clicks for web-site Product while satisfying long-term cost per click. - OPTIMIZE_CLICKS_TO_APP: Deprecated. Aim to drive clicks for web-site Product while satisfying long-term cost per click. - OPTIMIZE_CPA_FOR_APP_RE: Aim to drive the user re-engagements while satisfying long-term cost per (certain) action. - OPTIMIZE_RETENTION_FOR_APP_UA: Aim to drive the user retention. - OPTIMIZE_REATTRIBUTION_FOR_APP: Aim to drive user's app reattribution. - OPTIMIZE_CPA_REPEATED_FOR_APP_UA: Aim to drive app installs while satisfying long-term cost per (certain) action - repeated count. - FIXED_CPM_GENERIC: Default goal type for generic fixed-cpm. Fixed cpm with budget-pacing option is given. - FIXED_CPM_FOR_CTV: Default goal type for CTV. Fixed cpm with budget-pacing option is given. - FIXED_CPM_FOR_WEB_VISIT: Goal type for the WEB_VISIT Campaigns which do not use any of pricing engines. - OPTIMIZE_LANDING_FOR_WEB_UA: Goal type for optimizing landing event for web user acquisition campaign. - OPTIMIZE_CPA_FOR_WEB_UA: Goal type for optimizing cost per action for web user acquisition campaign. - `optimize_app_installs` CampaignGoalOptimizeAppInstalls - `mode` 'UNKNOWN_MODE' | 'TARGET_CPI_CENTRIC' | 'BUDGET_CENTRIC' | 'MARGIN_CENTRIC' | 'FIXED' — - FIXED: Read-only for AdCloud. - `target_cpi` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `margin` number, double — The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC. The rate should be in [-1.0, 1.0]. - `optimize_cpa_for_app_ua` CampaignGoalOptimizeCpaForAppUa — Detailed configuration of OPTIMIZE_CPA_FOR_APP_UA goal. - `action` string, required — In-app action events having revenue value the AdAccount wants to achieve. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'MARGIN_CENTRIC' | 'TARGET_PRIMARY_KPI_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `margin` number, double — The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC. The rate should be in [-1.0, 1.0]. - `target_kpi` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `optimize_app_roas` CampaignGoalOptimizeAppRoas - `target_roas` number, double — Target return on advertising spend (ROAS) in percent. For example, a value 312.5 denotes 312.5% ROAS. - `revenue_actions` string[], required — In-app action events having revenue value the AdAccount wants to achieve. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - ROAS computation will rely on the accompanied revenue value to each action. - `target_cpi` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'MARGIN_CENTRIC' | 'TARGET_PRIMARY_KPI_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `margin` number, double — The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC. The rate should be in [-1.0, 1.0]. - `optimize_clicks_to_web` CampaignGoalOptimizeClicksToWeb — Detailed configuration of OPTIMIZE_CPC_FOR_WEB_VISIT goal. - `target_cpc` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'TARGET_CPC_CENTRIC' - `rate` number, double — Budget-centric uses one ratio of daily budget for the autopilot to spend. It's only for DCPM. Required when the mode is BUDGET_CENTRIC. Its rate should be in (0, 2]. - `optimize_clicks_to_app` CampaignGoalOptimizeClicksToApp — Detailed configuration of OPTIMIZE_CPC_FOR_APP_UA goal. - `target_cpc` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'TARGET_CPC_CENTRIC' - `rate` number, double — Budget-centric uses one ratio of daily budget for the autopilot to spend. It's only for DCPM. Required when the mode is BUDGET_CENTRIC. Its rate should be in (0, 2]. - `optimize_roas_for_app_re` CampaignGoalOptimizeRoasForAppRe — Detailed configuration of OPTIMIZE_ROAS_FOR_APP_RE goal. - `target_roas` number, double — Target return on advertising spend (ROAS) in percent. For example, a value 312.5 denotes 312.5% ROAS. - `reengagement_action` string — Re-engagement action to measure re-engaging a user. This action is also used as a cohort base action. - `revenue_actions` string[], required — In-app action events having revenue value the AdAccount wants to achieve. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - ROAS computation will rely on the accompanied revenue value to each action. - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. - `optimize_cpc_for_app_re` CampaignGoalOptimizeCpcForAppRe — Detailed configuration of OPTIMIZE_CPC_FOR_APP_RE goal. - `target_cpc` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `reengagement_action` string — Re-engagement action to measure re-engaging a user. This action is also used as a cohort base action. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'TARGET_CPC_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. Required when the mode is BUDGET_CENTRIC. - `optimize_fixed_cpm` CampaignGoalOptimizeFixedCpm — Detailed configuration of FIXED_CPM_* goal. - `target_cpm` AdcloudcommonMoney, required — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `optimize_cpa_for_app_re` CampaignGoalOptimizeCpaForAppRe — Detailed configuration of OPTIMIZE_CPA_FOR_APP_RE goal. - `action` string, required — In-app action events the AdAccount wants to optimize. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - `reengagement_action` string — Re-engagement action to measure re-engaging a user. This action is also used as a cohort base action. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `optimize_app_retention` CampaignGoalOptimizeAppRetention — Detailed configuration of OPTIMIZE_RETENTION_FOR_APP_UA goal. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' | 'MARGIN_CENTRIC' - `target_cpi` AdcloudcommonMoney — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC and target_cpi is unset. The rate should be in (0, 2]. - `margin` number, double — The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC. The rate should be in [-1.0, 1.0]. - `optimize_app_reattribution` CampaignGoalOptimizeAppReattribution — Detailed configuration of OPTIMIZE_REATTRIBUTION_FOR_APP goal. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. - `optimize_cpa_repeated_for_app_ua` CampaignGoalOptimizeCpaRepeatedForAppUa — Detailed configuration of OPTIMIZE_CPA_REPEATED_FOR_APP_UA goal. - `action` string, required — In-app action events the AdAccount wants to optimize. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC. The rate should be in (0, 2]. - `optimize_fixed_cpm_pacing` CampaignGoalOptimizeFixedCpmPacing — General fixed-cpm goal with pacing option. Currently for FIXED_CPM_FOR_CTV and FIXED_CPM_GENERIC. - `target_cpm` AdcloudcommonMoney, required — Represents a monetary amount in micros for a specified currency. It's the amount in the specified currency's base denomination unit multiplied with 1 million. Both currency and amount are required. - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound. - `amount_micros` string, int64 - `pacing_mode` 'NONE' | 'BY_FREQUENCY' — Force pacing option. - `rate` number, double — Budget consume rate. The rate should be in (0, 2]. - `optimize_landing_for_web_ua` CampaignGoalOptimizeLandingForWebUa - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. - `optimize_cpa_for_web_ua` CampaignGoalOptimizeCpaForWebUa - `action` string, required — Web action events having revenue value the AdAccount wants to achieve. Remarkable notes: - Case-sensitive as specified in the post-back from MMP. Note(jiyeon): Currently, we optimize `install` events regardless of this action. - `mode` 'UNKNOWN_MODE' | 'BUDGET_CENTRIC' - `rate` number, double — The ratio of the daily budget for the autopilot to spend. The rate should be in (0, 2]. - `kpi_actions` string[] — List of KPI actions. - `campaign_countries` string[] — The countries of the Campaign. - `campaign_schedule` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `campaign_auto_delete_at` string, date-time — Auto delete timestamp of the Campaign. - `creatives` DspCreative[] — List of all the Creative for queried Campaigns. - `id` string — Unique identifier of the Creative. Automatically set by server on creation. - `ad_account_id` string — ID of the AdAccount the Creative belongs to. - `product_id` string — ID of the Product the Creative belongs to. - `title` string, required — A descriptive name of the Creative. - `enabling_state` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED' — Enumeration of the enabling states with a default UNSPECIFIED state. - `advertiser_info` DspAdvertiserInfo — AdvertiserInfo contains some basic information about an advertiser. It may be returned to Creative reviewers or other users with other non-advertiser roles to perform their duty without leaking any private advertiser information. - `id` string — Unique ID of the advertiser. - `title` string — A descriptive name of the advertiser. - `description` string — A description of the advertiser. - `type` 'UNKNOWN_TYPE' | 'IMAGE' | 'VIDEO' | 'VAST_VIDEO' | 'NATIVE' | 'NATIVE_IMAGE' | 'NATIVE_VIDEO' | 'CUSTOM_HTML' | 'TEMPLATE_HTML' | 'RICH_CUSTOM_HTML' | 'DYNAMIC_HTML' | 'AD_TAG' — Type of the Creative. Only one of the Creative source fields matching the type is allowed to be specified. - UNKNOWN_TYPE: This value is not part of the specification. - IMAGE: Image Creative. The image Creative source must be specified for this type. - VIDEO: Video Creative. The video Creative source must be specified for this type. - VAST_VIDEO: Vast video Creative. The vast video Creative source must be specified for this type. - NATIVE: Deprecated. v1.5 is the last version supporting this version. Native Creative. The native Creative source must be specified for this type. - NATIVE_IMAGE: Native image Creative. The native image Creative source must be specified for this type. - NATIVE_VIDEO: Native video Creative. The native video Creative source must be specified for this type. - CUSTOM_HTML: (Will be supported soon) Custom HTML Creative. The custom HTML Creative source must be specified for this type. - TEMPLATE_HTML: (Will be supported soon) Template HTML Creative. The template HTML Creative source must be specified for this type. - RICH_CUSTOM_HTML: The rich custom HTML Creative. The rich custom HTML Creative source must be specified for this type. - DYNAMIC_HTML: (Will be supported soon) The dynamic HTML Creative. The dynamic HTML Creative source must be specified for this type. - AD_TAG: (Will be supported soon) Third-party ad tag Creative with script-based or vast tag-based ad tag. - `original_filename` string, required — Original Creative filename given by user. - `size_in_bytes` integer — Estimated size of the Creative in bytes. - `custom_key_values` object — Custom key/values managed by the Moloco Ads client platform. It's up to the client ads platform to define the schema for the values and their optionality. The keys are recommended, but not required, to be prefixed with the reversed internet domain of the AdCloud client platform company. For example, keys defined by the client ads platform company "example.com" should have "com.example." as the prefix. For complex values, JSON payload is recommended. Moloco doesn't interpret these data in any way for ads serving. Upon serving, the custom key/values in the AdAccount, Campaign, and Creative models will be combined into the serving Creative proto in the order of precedence, with Creative's value having the highest precedence on the same key. - `image` DspCreativeImageSrc — Source of image Creative. Supported formats: JPEG, PNG, GIF. Maximum file size: 500KB (5MB for GIF). Banner dimensions: - 100x21, 300x50, 300x100, 320x48, 320x50, 320x100 - 360x56, 375x50, 375x59, 392x61, 411x64, 414x50, 414x65, 468x60 - 481x56, 640x100, 640x200, 667x56, 711x88, 800x50 - 970x250, 994x250, 1029x258 Full screen dimensions: - 300x600, 320x416, 320x480, 320x568, 360x592, 360x604, 360x640 - 360x718, 360x724, 360x728, 375x667, 384x787, 412x790, 414x736 - 428x846, 480x320, 640x360 Medium dimensions: - 160x600, 200x200, 250x250, 300x250, 320x240, 320x267, 336x280, 600x500 Tablet dimensions: - 728x90, 768x1024, 1024x90, 1024x768, 1280x90 - `image_url` string — URL of the image. - `filename` string — Original filename of the image. - `width` integer — Width of the Creative. - `height` integer — Height of the Creative. - `size_in_bytes` integer — Size of the image in bytes. - `video` DspCreativeVideoSrc — Source of video Creative. Supported format: MP4. Maximum file size: 300MB (before transcoding). At least one of width or height must be ≥ 640px. Duration: 6–180 seconds. - `video_url` string, required — URL of the video media. Currently we support only mp4 format. - `filename` string — Original filename of the video. - `width` integer, required — Width of the Creative. - `height` integer, required — Height of the Creative. - `length_seconds` integer, required — Video length in seconds. - `fps` integer — Number of frames per second for the video. - `size_in_bytes` integer — Size of the video in bytes. Note it doesn't include the bytes for the companion images. - `companion_images` DspCreativeImageSrc[] — Endcard image shown after video play ends. The orientation must match the video orientation. Supported formats: JPEG, PNG, GIF. Maximum file size: 500KB (5MB for GIF). - `image_url` string — URL of the image. - `filename` string — Original filename of the image. - `width` integer — Width of the Creative. - `height` integer — Height of the Creative. - `size_in_bytes` integer — Size of the image in bytes. - `auto_endcard` boolean — Whether the endcard is generated automatically by MCP or manually uploaded by the user. - `playable_endcard` DspCreativeRichCustomHtmlSrc — Creative source based on arbitrary HTML. An instance of this is typically used for a playable Creative from AdAccounts. You can create RichCustomHtmlSrc by one of two methods: 1. Upload FB style html file using CreateAssetUploadSession API(PLAYABLE_AD_SOURCE_TYPE_URL) 2. Use Creative template third parties: tresensa or spaceback(PLAYABLE_AD_SOURCE_TYPE_TAG). - `entry_html` string — The entry HTML code of the Creative. This field is read only. For write purposes, use playable_ad_source instead. - `html_requirement_attributes` DspCreativeHtmlRequirementAttributes, required — Requirements for displaying the Creative. During bidding, Moloco ensures only Creatives with HTML requirements satisfied by the inventory are served. - `flags` DspCreativeHtmlRequirementAttributesFlag[] — Flags for describing features that the enclosing Creative requires. - `use_custom_close` 'UNKNOWN_CUSTOM_CLOSE_TYPE' | 'CUSTOM_CLOSE_TYPE_NONE' | 'CUSTOM_CLOSE_TYPE_ENABLED' | 'CUSTOM_CLOSE_TYPE_CONTROLLABLE' — The Creative uses useCustomClose() functionally in MRAID. It may not be specified. It is NOT SPECIFIED. - CUSTOM_CLOSE_TYPE_NONE: It does not use useCustomClose(). - CUSTOM_CLOSE_TYPE_ENABLED: It uses useCustomClose(). - CUSTOM_CLOSE_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `auto_play_audio` 'UNKNOWN_AUTO_PLAY_AUDIO_TYPE' | 'AUTO_PLAY_AUDIO_TYPE_MUTED' | 'AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY' | 'AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE' — The Creative plays audio automatically; i.e., it starts muted. It may not be specified. It is NOT SPECIFIED. - AUTO_PLAY_AUDIO_TYPE_MUTED: It does not play audio automatically. - AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY: It plays audio automatically. - AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `html_size_attributes` DspCreativeHtmlSizeAttributes — Size-related attributes for a resizable Creative, such as an HTML-based one. This message acts as a filter condition; if an inventory is matched with the condition in this message, the enclosing Creative passes; i.e., the Creative is not filtered out. - `interstitial` boolean — Passes as long as the inventory is for an interstitial ad. - `fixed` CreativeHtmlSizeAttributesFixed[] — Passes as long as the inventory size matches with one of the elements in the list. If the Creative can be rotated, then one should specify both configurations. For non-interstitial ads, at least one dimension is required. - `width` integer - `height` integer - `max_video_duration_seconds` integer — Max duration of video sources, in seconds. It will be set to 0 if no video source is found in this Creative. - `playable_ad_source` CreativeRichCustomHtmlSrcPlayableADSourceData - `type` 'UNKNOWN_PLAYABLE_AD_SOURCE_TYPE' | 'PLAYABLE_AD_SOURCE_TYPE_URL' | 'PLAYABLE_AD_SOURCE_TYPE_TAG' — - PLAYABLE_AD_SOURCE_TYPE_URL: Source is a URL of the playable ad html. (facebook style). - PLAYABLE_AD_SOURCE_TYPE_TAG: Source is a playable ad html tag generated by the third party. (tresensa, spaceback, luna, playable factory, craftsmanplus). - `value` string — When type is PLAYABLE_AD_SOURCE_TYPE_URL, then URL of the uploaded HTML file. When type is PLAYABLE_AD_SOURCE_TYPE_TAG, then the full tag string. - `filename` string — The filename of HTML file. - `dynamic_html_endcard` DspCreativeDynamicHtmlSrc — (Will be supported soon) Dynamic Creative. An instance of this would be used for Creatives to be rendered when the Creative is shown to user, i.e. an impression takes place, unlike bid-time rendering for static images. - `template_id` string, required — ID of the template used to render this Creative. - `template_env` object — Environment used to render this Creative. - `rendered_entry_html` string, required — The entry HTML of the rendered Creative. - `html_requirement_attributes` DspCreativeHtmlRequirementAttributes — Requirements for displaying the Creative. During bidding, Moloco ensures only Creatives with HTML requirements satisfied by the inventory are served. - `flags` DspCreativeHtmlRequirementAttributesFlag[] — Flags for describing features that the enclosing Creative requires. - `use_custom_close` 'UNKNOWN_CUSTOM_CLOSE_TYPE' | 'CUSTOM_CLOSE_TYPE_NONE' | 'CUSTOM_CLOSE_TYPE_ENABLED' | 'CUSTOM_CLOSE_TYPE_CONTROLLABLE' — The Creative uses useCustomClose() functionally in MRAID. It may not be specified. It is NOT SPECIFIED. - CUSTOM_CLOSE_TYPE_NONE: It does not use useCustomClose(). - CUSTOM_CLOSE_TYPE_ENABLED: It uses useCustomClose(). - CUSTOM_CLOSE_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `auto_play_audio` 'UNKNOWN_AUTO_PLAY_AUDIO_TYPE' | 'AUTO_PLAY_AUDIO_TYPE_MUTED' | 'AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY' | 'AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE' — The Creative plays audio automatically; i.e., it starts muted. It may not be specified. It is NOT SPECIFIED. - AUTO_PLAY_AUDIO_TYPE_MUTED: It does not play audio automatically. - AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY: It plays audio automatically. - AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `html_size_attributes` DspCreativeHtmlSizeAttributes — Size-related attributes for a resizable Creative, such as an HTML-based one. This message acts as a filter condition; if an inventory is matched with the condition in this message, the enclosing Creative passes; i.e., the Creative is not filtered out. - `interstitial` boolean — Passes as long as the inventory is for an interstitial ad. - `fixed` CreativeHtmlSizeAttributesFixed[] — Passes as long as the inventory size matches with one of the elements in the list. If the Creative can be rotated, then one should specify both configurations. For non-interstitial ads, at least one dimension is required. - `width` integer - `height` integer - `policy` DspCreativeDynamicHtmlSrcPolicy — Policy defines how to select CatalogItems. - `function` 'UNKNOWN_POLICY' | 'RANDOM_SELECTION' | 'MOST_RECENT_VIEW' | 'IN_CART' | 'GLOBAL_TREND' | 'TREND' | 'COMBINED_EVENTS_RECENCY' | 'FREQUENTLY_BOUGHT_TOGETHER' | 'FREQUENTLY_SEEN_TOGETHER' | 'KEYWORD_SEARCH_WITH_CLIENT_RESULT' | 'COMBINED_EVENTS_RECENCY_WITH_KEYWORD_SEARCH' | 'MODEL' | 'GAME' | 'RMP_AUDIENCE_EXTENSION' | 'MCM_ITEM_RECOMMENDATION' | 'NEXT_ITEM_SELECTION' — PolicyFunction defines algorithms for selecting CatalogItems or CreativeElements for a game. - IN_CART: GLOBAL_TREND will be deprecated and replaced by TREND. During A/B testing, we will keep this not to break the test. - MODEL: For model policies, the policy enum is in the form of MODEL_{SOURCER_TYPE}_{EVALUATOR_TYPE}_{EVALUATOR_SUB_TYPE} - GAME: GAME policy is used to select Creative elements of game. - RMP_AUDIENCE_EXTENSION: Policy for RMP Audience Extension. - MCM_ITEM_RECOMMENDATION: Policy for MCM Item Recommendation. - NEXT_ITEM_SELECTION: Policy for NEXT Item Selection. - `function_config` PolicyPolicyFunctionConfig — Configuration for PolicyFunction. Some PolicyFunction requires an instance of this message to get a function: Policy -> CatalogItem/CreativeElement list. - `trend` PolicyFunctionConfigTrendConfig — TREND PolicyFunction's config. - … - `model` PolicyFunctionConfigModelConfig - … - `game` PolicyFunctionConfigGameConfig - … - `mcm_item_recommendation` PolicyFunctionConfigMcmItemRecommendationConfig - … - `next_item_selection` PolicyFunctionConfigNextItemSelectionConfig — NEXT_ITEM_SELECTION PolicyFunction's config. NEXT tunes its item selection logic at the Config level rather than the PolicyFunction level. - `num_items` integer — Number of items to be selected. - `catalog` string — Catalog ID. To know the types of catalogs supported, contact customer support. - `item_capper` PolicyItemCapper — Item-specific capper configurations. The configuration in this message is enforced: - across AdAccounts, - across Campaigns, - across AdGroups, - across CreativeGroups, and - across Creatives. - `frequency` PolicyItemCapperFrequency — Frequency represents frequency capping. One can specify "at most 3 exposures per 1 hour" by setting: { "period": "1h", "max_exposures": 3 } This means, when a user sees a CatalogItem 3 times, he/she won't see the same CatalogItem again for 1 hour. - … - `transcoding_info` CreativeVideoSrcTranscodingInfo - `status` 'UNKNOWN_STATUS' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' — - IN_PROGRESS: The transcoding is in progress. - SUCCEEDED: The transcoding has succeeded. - FAILED: The transcoding has failed. Detailed reason can be found from failed_reason. - `failed_reason` string — Error message for the FAILED status. - `vast_video` DspCreativeVastVideoSrc — Source of VAST (Video Ad Serving Template) video Creative. - `vast_tag` string, required — VAST tag to be used in VAST wrapper. E.g. [Example here](https://github.com/InteractiveAdvertisingBureau/VAST_Samples/blob/master/VAST%201-2.0%20Samples/Tremor-Video-Samples/vast_wrapper_linear_1.xml). - `width` integer — Width of the Creative. - `height` integer — Height of the Creative. - `length_seconds` integer — Vast video length in seconds. - `native` DspCreativeNativeSrc — Source of native Creative. - `icon_image` DspCreativeImageSrc, required — Source of image Creative. Supported formats: JPEG, PNG, GIF. Maximum file size: 500KB (5MB for GIF). Banner dimensions: - 100x21, 300x50, 300x100, 320x48, 320x50, 320x100 - 360x56, 375x50, 375x59, 392x61, 411x64, 414x50, 414x65, 468x60 - 481x56, 640x100, 640x200, 667x56, 711x88, 800x50 - 970x250, 994x250, 1029x258 Full screen dimensions: - 300x600, 320x416, 320x480, 320x568, 360x592, 360x604, 360x640 - 360x718, 360x724, 360x728, 375x667, 384x787, 412x790, 414x736 - 428x846, 480x320, 640x360 Medium dimensions: - 160x600, 200x200, 250x250, 300x250, 320x240, 320x267, 336x280, 600x500 Tablet dimensions: - 728x90, 768x1024, 1024x90, 1024x768, 1280x90 - `image_url` string — URL of the image. - `filename` string — Original filename of the image. - `width` integer — Width of the Creative. - `height` integer — Height of the Creative. - `size_in_bytes` integer — Size of the image in bytes. - `main_image` DspCreativeImageSrc, required — Source of image Creative. Supported formats: JPEG, PNG, GIF. Maximum file size: 500KB (5MB for GIF). Banner dimensions: - 100x21, 300x50, 300x100, 320x48, 320x50, 320x100 - 360x56, 375x50, 375x59, 392x61, 411x64, 414x50, 414x65, 468x60 - 481x56, 640x100, 640x200, 667x56, 711x88, 800x50 - 970x250, 994x250, 1029x258 Full screen dimensions: - 300x600, 320x416, 320x480, 320x568, 360x592, 360x604, 360x640 - 360x718, 360x724, 360x728, 375x667, 384x787, 412x790, 414x736 - 428x846, 480x320, 640x360 Medium dimensions: - 160x600, 200x200, 250x250, 300x250, 320x240, 320x267, 336x280, 600x500 Tablet dimensions: - 728x90, 768x1024, 1024x90, 1024x768, 1280x90 - `image_url` string — URL of the image. - `filename` string — Original filename of the image. - `width` integer — Width of the Creative. - `height` integer — Height of the Creative. - `size_in_bytes` integer — Size of the image in bytes. - `shrunk_main_image` DspCreativeImageSrc — Source of image Creative. Supported formats: JPEG, PNG, GIF. Maximum file size: 500KB (5MB for GIF). Banner dimensions: - 100x21, 300x50, 300x100, 320x48, 320x50, 320x100 - 360x56, 375x50, 375x59, 392x61, 411x64, 414x50, 414x65, 468x60 - 481x56, 640x100, 640x200, 667x56, 711x88, 800x50 - 970x250, 994x250, 1029x258 Full screen dimensions: - 300x600, 320x416, 320x480, 320x568, 360x592, 360x604, 360x640 - 360x718, 360x724, 360x728, 375x667, 384x787, 412x790, 414x736 - 428x846, 480x320, 640x360 Medium dimensions: - 160x600, 200x200, 250x250, 300x250, 320x240, 320x267, 336x280, 600x500 Tablet dimensions: - 728x90, 768x1024, 1024x90, 1024x768, 1280x90 - `image_url` string — URL of the image. - `filename` string — Original filename of the image. - `width` integer — Width of the Creative. - `height` integer — Height of the Creative. - `size_in_bytes` integer — Size of the image in bytes. - `title` string, required — Title of the native ad. - `text` string, required — Text message to show. - `cta_text` string, required — Call to action text (e.g. "Get a quote"). - `sponsored_by` string — Brand name of the sponsor/advertiser. - `star_rating` number, float — Star rating value of the app. Value should be in the range of [0, 5]. - `video` DspCreativeVideoSrc — Source of video Creative. Supported format: MP4. Maximum file size: 300MB (before transcoding). At least one of width or height must be ≥ 640px. Duration: 6–180 seconds. - `video_url` string, required — URL of the video media. Currently we support only mp4 format. - `filename` string — Original filename of the video. - `width` integer, required — Width of the Creative. - `height` integer, required — Height of the Creative. - `length_seconds` integer, required — Video length in seconds. - `fps` integer — Number of frames per second for the video. - `size_in_bytes` integer — Size of the video in bytes. Note it doesn't include the bytes for the companion images. - `companion_images` DspCreativeImageSrc[] — Endcard image shown after video play ends. The orientation must match the video orientation. Supported formats: JPEG, PNG, GIF. Maximum file size: 500KB (5MB for GIF). - `image_url` string — URL of the image. - `filename` string — Original filename of the image. - `width` integer — Width of the Creative. - `height` integer — Height of the Creative. - `size_in_bytes` integer — Size of the image in bytes. - `auto_endcard` boolean — Whether the endcard is generated automatically by MCP or manually uploaded by the user. - `playable_endcard` DspCreativeRichCustomHtmlSrc — Creative source based on arbitrary HTML. An instance of this is typically used for a playable Creative from AdAccounts. You can create RichCustomHtmlSrc by one of two methods: 1. Upload FB style html file using CreateAssetUploadSession API(PLAYABLE_AD_SOURCE_TYPE_URL) 2. Use Creative template third parties: tresensa or spaceback(PLAYABLE_AD_SOURCE_TYPE_TAG). - `entry_html` string — The entry HTML code of the Creative. This field is read only. For write purposes, use playable_ad_source instead. - `html_requirement_attributes` DspCreativeHtmlRequirementAttributes, required — Requirements for displaying the Creative. During bidding, Moloco ensures only Creatives with HTML requirements satisfied by the inventory are served. - `flags` DspCreativeHtmlRequirementAttributesFlag[] — Flags for describing features that the enclosing Creative requires. - `use_custom_close` 'UNKNOWN_CUSTOM_CLOSE_TYPE' | 'CUSTOM_CLOSE_TYPE_NONE' | 'CUSTOM_CLOSE_TYPE_ENABLED' | 'CUSTOM_CLOSE_TYPE_CONTROLLABLE' — The Creative uses useCustomClose() functionally in MRAID. It may not be specified. It is NOT SPECIFIED. - CUSTOM_CLOSE_TYPE_NONE: It does not use useCustomClose(). - CUSTOM_CLOSE_TYPE_ENABLED: It uses useCustomClose(). - CUSTOM_CLOSE_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `auto_play_audio` 'UNKNOWN_AUTO_PLAY_AUDIO_TYPE' | 'AUTO_PLAY_AUDIO_TYPE_MUTED' | 'AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY' | 'AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE' — The Creative plays audio automatically; i.e., it starts muted. It may not be specified. It is NOT SPECIFIED. - AUTO_PLAY_AUDIO_TYPE_MUTED: It does not play audio automatically. - AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY: It plays audio automatically. - AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `html_size_attributes` DspCreativeHtmlSizeAttributes — Size-related attributes for a resizable Creative, such as an HTML-based one. This message acts as a filter condition; if an inventory is matched with the condition in this message, the enclosing Creative passes; i.e., the Creative is not filtered out. - `interstitial` boolean — Passes as long as the inventory is for an interstitial ad. - `fixed` CreativeHtmlSizeAttributesFixed[] — Passes as long as the inventory size matches with one of the elements in the list. If the Creative can be rotated, then one should specify both configurations. For non-interstitial ads, at least one dimension is required. - … - `max_video_duration_seconds` integer — Max duration of video sources, in seconds. It will be set to 0 if no video source is found in this Creative. - `playable_ad_source` CreativeRichCustomHtmlSrcPlayableADSourceData - `type` 'UNKNOWN_PLAYABLE_AD_SOURCE_TYPE' | 'PLAYABLE_AD_SOURCE_TYPE_URL' | 'PLAYABLE_AD_SOURCE_TYPE_TAG' — - PLAYABLE_AD_SOURCE_TYPE_URL: Source is a URL of the playable ad html. (facebook style). - PLAYABLE_AD_SOURCE_TYPE_TAG: Source is a playable ad html tag generated by the third party. (tresensa, spaceback, luna, playable factory, craftsmanplus). - `value` string — When type is PLAYABLE_AD_SOURCE_TYPE_URL, then URL of the uploaded HTML file. When type is PLAYABLE_AD_SOURCE_TYPE_TAG, then the full tag string. - `filename` string — The filename of HTML file. - `dynamic_html_endcard` DspCreativeDynamicHtmlSrc — (Will be supported soon) Dynamic Creative. An instance of this would be used for Creatives to be rendered when the Creative is shown to user, i.e. an impression takes place, unlike bid-time rendering for static images. - `template_id` string, required — ID of the template used to render this Creative. - `template_env` object — Environment used to render this Creative. - `rendered_entry_html` string, required — The entry HTML of the rendered Creative. - `html_requirement_attributes` DspCreativeHtmlRequirementAttributes — Requirements for displaying the Creative. During bidding, Moloco ensures only Creatives with HTML requirements satisfied by the inventory are served. - `flags` DspCreativeHtmlRequirementAttributesFlag[] — Flags for describing features that the enclosing Creative requires. - `use_custom_close` 'UNKNOWN_CUSTOM_CLOSE_TYPE' | 'CUSTOM_CLOSE_TYPE_NONE' | 'CUSTOM_CLOSE_TYPE_ENABLED' | 'CUSTOM_CLOSE_TYPE_CONTROLLABLE' — The Creative uses useCustomClose() functionally in MRAID. It may not be specified. It is NOT SPECIFIED. - CUSTOM_CLOSE_TYPE_NONE: It does not use useCustomClose(). - CUSTOM_CLOSE_TYPE_ENABLED: It uses useCustomClose(). - CUSTOM_CLOSE_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `auto_play_audio` 'UNKNOWN_AUTO_PLAY_AUDIO_TYPE' | 'AUTO_PLAY_AUDIO_TYPE_MUTED' | 'AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY' | 'AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE' — The Creative plays audio automatically; i.e., it starts muted. It may not be specified. It is NOT SPECIFIED. - AUTO_PLAY_AUDIO_TYPE_MUTED: It does not play audio automatically. - AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY: It plays audio automatically. - AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `html_size_attributes` DspCreativeHtmlSizeAttributes — Size-related attributes for a resizable Creative, such as an HTML-based one. This message acts as a filter condition; if an inventory is matched with the condition in this message, the enclosing Creative passes; i.e., the Creative is not filtered out. - `interstitial` boolean — Passes as long as the inventory is for an interstitial ad. - `fixed` CreativeHtmlSizeAttributesFixed[] — Passes as long as the inventory size matches with one of the elements in the list. If the Creative can be rotated, then one should specify both configurations. For non-interstitial ads, at least one dimension is required. - … - `policy` DspCreativeDynamicHtmlSrcPolicy — Policy defines how to select CatalogItems. - `function` 'UNKNOWN_POLICY' | 'RANDOM_SELECTION' | 'MOST_RECENT_VIEW' | 'IN_CART' | 'GLOBAL_TREND' | 'TREND' | 'COMBINED_EVENTS_RECENCY' | 'FREQUENTLY_BOUGHT_TOGETHER' | 'FREQUENTLY_SEEN_TOGETHER' | 'KEYWORD_SEARCH_WITH_CLIENT_RESULT' | 'COMBINED_EVENTS_RECENCY_WITH_KEYWORD_SEARCH' | 'MODEL' | 'GAME' | 'RMP_AUDIENCE_EXTENSION' | 'MCM_ITEM_RECOMMENDATION' | 'NEXT_ITEM_SELECTION' — PolicyFunction defines algorithms for selecting CatalogItems or CreativeElements for a game. - IN_CART: GLOBAL_TREND will be deprecated and replaced by TREND. During A/B testing, we will keep this not to break the test. - MODEL: For model policies, the policy enum is in the form of MODEL_{SOURCER_TYPE}_{EVALUATOR_TYPE}_{EVALUATOR_SUB_TYPE} - GAME: GAME policy is used to select Creative elements of game. - RMP_AUDIENCE_EXTENSION: Policy for RMP Audience Extension. - MCM_ITEM_RECOMMENDATION: Policy for MCM Item Recommendation. - NEXT_ITEM_SELECTION: Policy for NEXT Item Selection. - `function_config` PolicyPolicyFunctionConfig — Configuration for PolicyFunction. Some PolicyFunction requires an instance of this message to get a function: Policy -> CatalogItem/CreativeElement list. - … - `num_items` integer — Number of items to be selected. - `catalog` string — Catalog ID. To know the types of catalogs supported, contact customer support. - `item_capper` PolicyItemCapper — Item-specific capper configurations. The configuration in this message is enforced: - across AdAccounts, - across Campaigns, - across AdGroups, - across CreativeGroups, and - across Creatives. - … - `transcoding_info` CreativeVideoSrcTranscodingInfo - `status` 'UNKNOWN_STATUS' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' — - IN_PROGRESS: The transcoding is in progress. - SUCCEEDED: The transcoding has succeeded. - FAILED: The transcoding has failed. Detailed reason can be found from failed_reason. - `failed_reason` string — Error message for the FAILED status. - `vast_video` DspCreativeVastVideoSrc — Source of VAST (Video Ad Serving Template) video Creative. - `vast_tag` string, required — VAST tag to be used in VAST wrapper. E.g. [Example here](https://github.com/InteractiveAdvertisingBureau/VAST_Samples/blob/master/VAST%201-2.0%20Samples/Tremor-Video-Samples/vast_wrapper_linear_1.xml). - `width` integer — Width of the Creative. - `height` integer — Height of the Creative. - `length_seconds` integer — Vast video length in seconds. - `custom_html` DspCreativeCustomHtmlSrc — (Will be supported soon) Creative source based on custom html. - `html` string, required — HTML for the custom HTML ad. - `width` integer, required — Width of the Creative. - `height` integer, required — Height of the Creative. - `image_url` string, required — URL of the image. - `template_html` DspCreativeTemplateHtmlSrc — (Will be supported soon) Creative source based on MRAID template. - `template_id` string, required — ID of the template used to render this Creative. - `template_env` object — Environment used to render this Creative. - `rendered_entry_html` string, required — The entry HTML of the rendered Creative. - `html_requirement_attributes` DspCreativeHtmlRequirementAttributes — Requirements for displaying the Creative. During bidding, Moloco ensures only Creatives with HTML requirements satisfied by the inventory are served. - `flags` DspCreativeHtmlRequirementAttributesFlag[] — Flags for describing features that the enclosing Creative requires. - `use_custom_close` 'UNKNOWN_CUSTOM_CLOSE_TYPE' | 'CUSTOM_CLOSE_TYPE_NONE' | 'CUSTOM_CLOSE_TYPE_ENABLED' | 'CUSTOM_CLOSE_TYPE_CONTROLLABLE' — The Creative uses useCustomClose() functionally in MRAID. It may not be specified. It is NOT SPECIFIED. - CUSTOM_CLOSE_TYPE_NONE: It does not use useCustomClose(). - CUSTOM_CLOSE_TYPE_ENABLED: It uses useCustomClose(). - CUSTOM_CLOSE_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `auto_play_audio` 'UNKNOWN_AUTO_PLAY_AUDIO_TYPE' | 'AUTO_PLAY_AUDIO_TYPE_MUTED' | 'AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY' | 'AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE' — The Creative plays audio automatically; i.e., it starts muted. It may not be specified. It is NOT SPECIFIED. - AUTO_PLAY_AUDIO_TYPE_MUTED: It does not play audio automatically. - AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY: It plays audio automatically. - AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `html_size_attributes` DspCreativeHtmlSizeAttributes — Size-related attributes for a resizable Creative, such as an HTML-based one. This message acts as a filter condition; if an inventory is matched with the condition in this message, the enclosing Creative passes; i.e., the Creative is not filtered out. - `interstitial` boolean — Passes as long as the inventory is for an interstitial ad. - `fixed` CreativeHtmlSizeAttributesFixed[] — Passes as long as the inventory size matches with one of the elements in the list. If the Creative can be rotated, then one should specify both configurations. For non-interstitial ads, at least one dimension is required. - `width` integer - `height` integer - `max_video_duration_seconds` integer — Max duration of video sources. Will be 0 if no video source is found in this Creative. - `rich_custom_html` DspCreativeRichCustomHtmlSrc — Creative source based on arbitrary HTML. An instance of this is typically used for a playable Creative from AdAccounts. You can create RichCustomHtmlSrc by one of two methods: 1. Upload FB style html file using CreateAssetUploadSession API(PLAYABLE_AD_SOURCE_TYPE_URL) 2. Use Creative template third parties: tresensa or spaceback(PLAYABLE_AD_SOURCE_TYPE_TAG). - `entry_html` string — The entry HTML code of the Creative. This field is read only. For write purposes, use playable_ad_source instead. - `html_requirement_attributes` DspCreativeHtmlRequirementAttributes, required — Requirements for displaying the Creative. During bidding, Moloco ensures only Creatives with HTML requirements satisfied by the inventory are served. - `flags` DspCreativeHtmlRequirementAttributesFlag[] — Flags for describing features that the enclosing Creative requires. - `use_custom_close` 'UNKNOWN_CUSTOM_CLOSE_TYPE' | 'CUSTOM_CLOSE_TYPE_NONE' | 'CUSTOM_CLOSE_TYPE_ENABLED' | 'CUSTOM_CLOSE_TYPE_CONTROLLABLE' — The Creative uses useCustomClose() functionally in MRAID. It may not be specified. It is NOT SPECIFIED. - CUSTOM_CLOSE_TYPE_NONE: It does not use useCustomClose(). - CUSTOM_CLOSE_TYPE_ENABLED: It uses useCustomClose(). - CUSTOM_CLOSE_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `auto_play_audio` 'UNKNOWN_AUTO_PLAY_AUDIO_TYPE' | 'AUTO_PLAY_AUDIO_TYPE_MUTED' | 'AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY' | 'AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE' — The Creative plays audio automatically; i.e., it starts muted. It may not be specified. It is NOT SPECIFIED. - AUTO_PLAY_AUDIO_TYPE_MUTED: It does not play audio automatically. - AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY: It plays audio automatically. - AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `html_size_attributes` DspCreativeHtmlSizeAttributes — Size-related attributes for a resizable Creative, such as an HTML-based one. This message acts as a filter condition; if an inventory is matched with the condition in this message, the enclosing Creative passes; i.e., the Creative is not filtered out. - `interstitial` boolean — Passes as long as the inventory is for an interstitial ad. - `fixed` CreativeHtmlSizeAttributesFixed[] — Passes as long as the inventory size matches with one of the elements in the list. If the Creative can be rotated, then one should specify both configurations. For non-interstitial ads, at least one dimension is required. - `width` integer - `height` integer - `max_video_duration_seconds` integer — Max duration of video sources, in seconds. It will be set to 0 if no video source is found in this Creative. - `playable_ad_source` CreativeRichCustomHtmlSrcPlayableADSourceData - `type` 'UNKNOWN_PLAYABLE_AD_SOURCE_TYPE' | 'PLAYABLE_AD_SOURCE_TYPE_URL' | 'PLAYABLE_AD_SOURCE_TYPE_TAG' — - PLAYABLE_AD_SOURCE_TYPE_URL: Source is a URL of the playable ad html. (facebook style). - PLAYABLE_AD_SOURCE_TYPE_TAG: Source is a playable ad html tag generated by the third party. (tresensa, spaceback, luna, playable factory, craftsmanplus). - `value` string — When type is PLAYABLE_AD_SOURCE_TYPE_URL, then URL of the uploaded HTML file. When type is PLAYABLE_AD_SOURCE_TYPE_TAG, then the full tag string. - `filename` string — The filename of HTML file. - `dynamic_html` DspCreativeDynamicHtmlSrc — (Will be supported soon) Dynamic Creative. An instance of this would be used for Creatives to be rendered when the Creative is shown to user, i.e. an impression takes place, unlike bid-time rendering for static images. - `template_id` string, required — ID of the template used to render this Creative. - `template_env` object — Environment used to render this Creative. - `rendered_entry_html` string, required — The entry HTML of the rendered Creative. - `html_requirement_attributes` DspCreativeHtmlRequirementAttributes — Requirements for displaying the Creative. During bidding, Moloco ensures only Creatives with HTML requirements satisfied by the inventory are served. - `flags` DspCreativeHtmlRequirementAttributesFlag[] — Flags for describing features that the enclosing Creative requires. - `use_custom_close` 'UNKNOWN_CUSTOM_CLOSE_TYPE' | 'CUSTOM_CLOSE_TYPE_NONE' | 'CUSTOM_CLOSE_TYPE_ENABLED' | 'CUSTOM_CLOSE_TYPE_CONTROLLABLE' — The Creative uses useCustomClose() functionally in MRAID. It may not be specified. It is NOT SPECIFIED. - CUSTOM_CLOSE_TYPE_NONE: It does not use useCustomClose(). - CUSTOM_CLOSE_TYPE_ENABLED: It uses useCustomClose(). - CUSTOM_CLOSE_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `auto_play_audio` 'UNKNOWN_AUTO_PLAY_AUDIO_TYPE' | 'AUTO_PLAY_AUDIO_TYPE_MUTED' | 'AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY' | 'AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE' — The Creative plays audio automatically; i.e., it starts muted. It may not be specified. It is NOT SPECIFIED. - AUTO_PLAY_AUDIO_TYPE_MUTED: It does not play audio automatically. - AUTO_PLAY_AUDIO_TYPE_AUTO_PLAY: It plays audio automatically. - AUTO_PLAY_AUDIO_TYPE_CONTROLLABLE: It is allowed to be changed with respect to target ad exchange. - `html_size_attributes` DspCreativeHtmlSizeAttributes — Size-related attributes for a resizable Creative, such as an HTML-based one. This message acts as a filter condition; if an inventory is matched with the condition in this message, the enclosing Creative passes; i.e., the Creative is not filtered out. - `interstitial` boolean — Passes as long as the inventory is for an interstitial ad. - `fixed` CreativeHtmlSizeAttributesFixed[] — Passes as long as the inventory size matches with one of the elements in the list. If the Creative can be rotated, then one should specify both configurations. For non-interstitial ads, at least one dimension is required. - `width` integer - `height` integer - `policy` DspCreativeDynamicHtmlSrcPolicy — Policy defines how to select CatalogItems. - `function` 'UNKNOWN_POLICY' | 'RANDOM_SELECTION' | 'MOST_RECENT_VIEW' | 'IN_CART' | 'GLOBAL_TREND' | 'TREND' | 'COMBINED_EVENTS_RECENCY' | 'FREQUENTLY_BOUGHT_TOGETHER' | 'FREQUENTLY_SEEN_TOGETHER' | 'KEYWORD_SEARCH_WITH_CLIENT_RESULT' | 'COMBINED_EVENTS_RECENCY_WITH_KEYWORD_SEARCH' | 'MODEL' | 'GAME' | 'RMP_AUDIENCE_EXTENSION' | 'MCM_ITEM_RECOMMENDATION' | 'NEXT_ITEM_SELECTION' — PolicyFunction defines algorithms for selecting CatalogItems or CreativeElements for a game. - IN_CART: GLOBAL_TREND will be deprecated and replaced by TREND. During A/B testing, we will keep this not to break the test. - MODEL: For model policies, the policy enum is in the form of MODEL_{SOURCER_TYPE}_{EVALUATOR_TYPE}_{EVALUATOR_SUB_TYPE} - GAME: GAME policy is used to select Creative elements of game. - RMP_AUDIENCE_EXTENSION: Policy for RMP Audience Extension. - MCM_ITEM_RECOMMENDATION: Policy for MCM Item Recommendation. - NEXT_ITEM_SELECTION: Policy for NEXT Item Selection. - `function_config` PolicyPolicyFunctionConfig — Configuration for PolicyFunction. Some PolicyFunction requires an instance of this message to get a function: Policy -> CatalogItem/CreativeElement list. - `trend` PolicyFunctionConfigTrendConfig — TREND PolicyFunction's config. - `name` string - `model` PolicyFunctionConfigModelConfig - `sourcer_type` 'UNKNOWN_SOURCER' | 'SOURCER_TEST_CATALOG_DEPENDENT' | 'SOURCER_TEST_CATALOG_INDEPENDENT' | 'SOURCER_DEFAULT' | 'SOURCER_USER_SIGNAL' | 'SOURCER_TRENDS' | 'SOURCER_RELATED_ITEMS' | 'SOURCER_AUCTION_ITEMS' — SourcerType defines the type of sourcer for the model. - `evaluator_type` 'UNKNOWN_EVALUATOR' | 'EVALUATOR_TEST_CATALOG_DEPENDENT' | 'EVALUATOR_TEST_CATALOG_INDEPENDENT' | 'EVALUATOR_RANDOM' | 'EVALUATOR_LR' — EvaluatorType defines the type of evaluator for the model. - `evaluator_suffix` string - `user_signal_window_hours` integer - `game` PolicyFunctionConfigGameConfig - `game_id` string — Game id. it should correspond to GameID of dcr/api.proto. - `mcm_item_recommendation` PolicyFunctionConfigMcmItemRecommendationConfig - `mcm_platform_id` string - `inventory_id` string - `next_item_selection` PolicyFunctionConfigNextItemSelectionConfig — NEXT_ITEM_SELECTION PolicyFunction's config. NEXT tunes its item selection logic at the Config level rather than the PolicyFunction level. - `num_items` integer — Number of items to be selected. - `catalog` string — Catalog ID. To know the types of catalogs supported, contact customer support. - `item_capper` PolicyItemCapper — Item-specific capper configurations. The configuration in this message is enforced: - across AdAccounts, - across Campaigns, - across AdGroups, - across CreativeGroups, and - across Creatives. - `frequency` PolicyItemCapperFrequency — Frequency represents frequency capping. One can specify "at most 3 exposures per 1 hour" by setting: { "period": "1h", "max_exposures": 3 } This means, when a user sees a CatalogItem 3 times, he/she won't see the same CatalogItem again for 1 hour. - `period` string — The period is represented in a format {INTEGER}[smhdw]. For example, "1m" indicates 1 minute. When this field is empty, the system default cooling time is used. - `max_exposures` integer — The max number of exposures of a CatalogItem within a period of time. - `feature_type` 'UNKNOWN_CREATIVE_FEATURE_TYPE' | 'GENERAL' | 'DYNAMIC_CREATIVE' — CreativeFeatureType. - `creator_tag` string — Creator tag to identify who is the resource creator. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. - `audience_targets` DspSharedAudienceTarget[] — List of all the SharedAudienceTarget for queried Campaigns. - `id` string — ID of the SharedAudienceTarget. Automatically set by server on creation. - `title` string, required — A descriptive name of the SharedAudienceTarget. - `targeting_condition` DspAudienceTargetingCondition — AudienceTargetingCondition specifies conditions for AudienceTargeting. This condition object contains various filters on multiple dimensions of bid-request, app, and user. Advertisers can selectively configure desired filters to form a meaningful AudienceTarget condition collectively. The configured individual filters must be satisfied unanimously in order for the resulting collective condition to be satisfied. Only filters with values will be effective. When a filter condition accepts a list of values, i.e., list of countries for "allowed_countries", the filter condition will be met when any match is found among the list. String literals are case insensitive unless specified otherwise; i.e. "USA" and "usa" equally represents the United States of America. - `allowed_countries` string[] — Allowed countries in ISO_3166-1_alpha-3 format. - `blocked_countries` string[] — Blocked countries in ISO_3166-1_alpha-3 format. - `placement_reasons` AudienceTargetingConditionPlacementReason[] - `custom_placement_reason` string — The reason of the placement in free-form text. - `allowed_app_bundles` string[] — App bundles. A bid-request having a matching publisher app bundle from the list will be accepted. Example to target com.moloco.game or com.moloco.travel apps: "allowed_app_bundles": [ "com.moloco.game", "com.moloco.travel" ] Example to exclude com.moloco.office app: "blocked_app_bundles": [ "com.moloco.office" ] - `blocked_app_bundles` string[] — See the documentation for `allowed_app_bundles`. - `allowed_content_categories` string[] — Filter for allowed publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "allowed_content_categories": [ "IAB26-1" ] - `blocked_content_categories` string[] — Filter for blocked publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "blocked_content_categories": [ "IAB26-1" ] - `allowed_cities` string[] — Allowed cities. A bid-request will be accepted when there is at least one match from the city list. Note that each element must be in the form of "city, region" such as "Seattle, WA" in order to disambiguate the same city but different regions. The entry is case-insensitive and whitespace will be ignored. Example to target Seattle or Newyork: "allowed_cities": [ "Seattle, WA", "Newyork, ny" ] - `blocked_cities` string[] — Blocked cities. - `allowed_creative_types` AdcloudcommonCreativeType[] — Allowed Creative types. - `blocked_creative_types` AdcloudcommonCreativeType[] — Blocked Creative types. - `allowed_websites` string[] — Allowed websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "allowed_websites": [ "*youtube.com" ]. - `blocked_websites` string[] — Blocked websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "blocked_websites": [ "*example.com" ]. - `allowed_geofences` CommonCircle[] — Allowed geofences. - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - `latitude` number, double - `longitude` number, double - `radius` number, double - `blocked_geofences` CommonCircle[] — Blocked geofences. - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - `latitude` number, double - `longitude` number, double - `radius` number, double - `allowed_exchanges` CommonAdExchange[] — Allowed ad exchanges. Restricts targeting to bid only on the listed exchanges; an empty list places no restriction. MOLOCO_SDK is automatically included whenever the list is non-empty: submitting a non-empty list that omits MOLOCO_SDK will have it appended on the server side. - `blocked_exchanges` CommonAdExchange[] — Blocked ad exchanges. Excludes the listed exchanges from targeting. Adding MOLOCO_SDK to this list is rejected with PERMISSION_DENIED. - `allowed_idfas` string[] — Allowed user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f". - `blocked_idfas` string[] — Blocked user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f". - `allowed_zipcodes` string[] — Allowed zipcodes. - `blocked_zipcodes` string[] — Blocked zipcodes. - `allowed_device_models` string[] — Allowed device models. For example: "allowed_device_models": [ "KFFOWI", "KFGIWI", "KFTT", "KFJWA" ] - `blocked_device_models` string[] — Blocked device models. - `allowed_user_audience_tags` string[] — Allowed user custom audience tags. - `blocked_user_audience_tags` string[] — Blocked user custom audience tags. - `allowed_languages` string[] — Allowed languages. Languages in use mostly follow ISO 639-1 code(https://www.loc.gov/standards/iso639-2/php/code_list.php), e.g. "ko" for Korean and "en" for English. - `blocked_languages` string[] — Blocked languages. - `allowed_device_types` CommonDeviceType[] — Allowed device types. For example: "allowed_device_types": [ "HIGHEND_PHONE", "TABLET" ] - `blocked_device_types` CommonDeviceType[] — Blocked device types. For example: "allowed_device_types": [ "SET_TOP_BOX" ] - `allowed_mostly_visited_countries` string[] — This filter checks user's history of mostly visited countries against the specified countries in the condition, and passes a request if there is at least one common entry in both lists. - `blocked_mostly_visited_countries` string[] - `allowed_regions` string[] — Regions are to filter a bid-request based on its region information. - `blocked_regions` string[] - `allowed_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] — Recent Campaign activities filter a bid-request by user's recent activity such as click or install in the last n days. The filter is satisfied if there is at least one satisfying condition among the list. Example to target a user who has a click event for com.moloco.gameapp: "allowed_recent_campaign_activities": [ { "campaign_id": "com.moloco.gameapp", "event": "CLICK" } ] Example to block a user who has a install event for com.moloco.officeapp within the past five days: "blocked_recent_campaign_activities": [ { "campaign_id": "com.moloco.officeapp", "event": "INSTALL", "last_n_days": 5 } ] - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install. - `campaign_id` string, required — ID of the Campaign to filter on. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `blocked_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install. - `campaign_id` string, required — ID of the Campaign to filter on. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `allowed_locations` AudienceTargetingConditionLocationFilter[] — Location filter targets specific geo-locational audience using combined conditions of different types such as city, region, zipcode and geofence. - `cities` string[] - `regions` string[] - `zipcodes` string[] - `geofences` CommonCircle[] - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - `latitude` number, double - `longitude` number, double - `radius` number, double - `blocked_locations` AudienceTargetingConditionLocationFilter[] - `cities` string[] - `regions` string[] - `zipcodes` string[] - `geofences` CommonCircle[] - `center` CommonLatLng — Point defines a geo location by latitude, longitude. - `latitude` number, double - `longitude` number, double - `radius` number, double - `genders` CommonGender[] - `connection_types` string[] — Connection_types include ETHERNET, WIFI, CELL_UNKNOWN, CELL_2G, CELL_3G, CELL_4G. For example: "connection_types": [ "WIFI", "CELL_4G" ] - `allowed_direct_deal_ids` string[] — IDs of the allowed direct deals. A bid-request is accepted only if there is at least one matching id. For example: "allowed_direct_deal_ids": [ "ip_9161499632014fe8b9ef60673a51b745", "ip_e13c0cb23dd54a8ea742b2af61e0712d", "ip_0cfeaebb190d47df8b86399232853e23" ] - `blocked_direct_deal_ids` string[] — IDs of the blocked direct deals. - `device_oses` AudienceTargetingConditionDeviceOsFilter[] — Device OS requirements if specified. - `os` 'UNKNOWN_DEVICE_OS' | 'ANDROID' | 'IOS' | 'VERSATILE' | 'MOBILE_WEB' | 'MACOS' | 'WINDOWS' | 'NEXT_VERSATILE', required — Enumeration of device OS types supported by Moloco Ads. This value is not part of the specification. - ANDROID: Android device OS. - IOS: iOS device OS. - VERSATILE: Product with multiple OSes. Specifically for CTV. - MOBILE_WEB: OS for mobile web traffic. - MACOS: OS for MacOS traffic. - WINDOWS: OS for Windows traffic. - NEXT_VERSATILE: OS for Next web product. - `min_version` string - `max_version` string - `media_channel_type` 'UNKNOWN_MEDIA_CHANNEL_TYPE' | 'APP' | 'WEB' — - UNKNOWN_MEDIA_CHANNEL_TYPE: This value is not part of the specification. - `new_users` AudienceTargetingConditionNewUserFilter — Filter to target new users only. - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days. - `advertiser_id_types` CommonAdvertiserIdType[] — Filter on advising ID types, including "ANDROID_IDFA" or "IOS_IDFA". - `allowed_video_types` DspAudienceTargetingConditionVideoType[] — Video type filter. Ignored when the bid request is not for video ads. - `blocked_video_types` DspAudienceTargetingConditionVideoType[] - `weekly_schedules` AudienceTargetingConditionWeeklyScheduleFilter[] — Weekly schedule specifies more fine-grained time range filtering for days of a week. For example, this list can be used to specify commute time ranges in the morning and evening on workdays. Example to target 7-9 am and 5-7 pm during week days: "weekly_schedules": [ { "hour_range": { "start": 7, "end": 9 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] }, { "hour_range": { "start": 17, "end": 19 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] } ] Example to target 10pm to 2am on Fridays and Saturdays: "weekly_schedules": [ { "range": { "start": 22, "end": 2 }, "days": [ "FRI", "SAT" ] } ] - `timezone_policy` 'UNKNOWN_TIME' | 'DEVICE_TIME' | 'UTC_TIME' | 'AD_ACCOUNT_TIME' | 'ADVERTISER_TIME' — TimezonePolicy defines the time configuration. - DEVICE_TIME: Time object is given in the device's time (depends on user device timezone). - UTC_TIME: Time object is given in the fixed UTC time (depends on nothing). - AD_ACCOUNT_TIME: Given time is given in fixed ad account time (depends on ad account timezone). - `hour_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `days` AdcloudcommonDayOfWeek[], required — Days of week to filter on. At least one is required. - `allowed_gender_score` AdcloudcommonFloatingPointRange - `start` number, double - `end` number, double - `blocked_gender_score` AdcloudcommonFloatingPointRange - `start` number, double - `end` number, double - `allowed_ages` AdcloudcommonInterval[] — Age is used to filter based on user's approximate age. A valid value must be in the exclusive range of (0, 100). - `start` integer - `end` integer - `blocked_ages` AdcloudcommonInterval[] - `start` integer - `end` integer - `allowed_ip_ranges` string[] — IP net based condition. The CIDR format must be used for an entry such as https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing. Note that both of IP v4 and v6 could be used at the same time. Example to block bid-requests with any IP within 32.76.52.0 - 32.76.52.255 or 127.0.0.0 - 127.255.255.255: "blocked_ip_ranges": [ "32.76.52.0/24", "127.0.0.0/8" ] - `blocked_ip_ranges` string[] - `allowed_device_carriers` string[] — Device carrier filter. Example to target SKT: "allowed_device_carriers": [ "SKTelecom" ] Example to exclude T-MOBILE and XFINITY Mobile "blocked_device_carriers": [ "T-MOBILE", "XFINITY Mobile" ] - `blocked_device_carriers` string[] - `allowed_keywords` string[] — Filter regarding 'keywords' field in a bid request. If specified, an ad request must have at least one of the allowed keywords to satisfy the filter. - `blocked_keywords` string[] — Filter regarding 'keywords' field in a bid request. An ad request must not have any of the blocked keywords to satisfy the filter. - `user_buckets` AdcloudcommonInterval[] — Filter for the user buckets. - `start` integer - `end` integer - `allowed_ad_units` string[] — // Target timetree_i_prod or timetree_a_prod ad_units "condition": { "allowed_ad_units": [ "timetree_i_prod", "timetree_a_prod" ] } // Exclude timetree_i_test ad_unit "condition": { "blocked_ad_units": [ "timetree_i_test" ] } - `blocked_ad_units` string[] - `allowed_placements` string[] — placement (a group of ad_units) names. It is untied to ad_units, and follow the ad_unit's filtering rule. - `blocked_placements` string[] - `allowed_banner_apis` CommonBannerApi[] — // Target MRAID_2 banner only "condition": { "allowed_banner_apis": [ "MRAID_2" ] } - `blocked_banner_apis` CommonBannerApi[] - `schedule` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `audience_data` CommonAudienceData — Audience Data. It is a filter based on AudienceData stored in UPT. - `provider` string - `condition` string - `allowed_apps_by_checksum` string[] — Allow apps by their checksum value. - `blocked_apps_by_checksum` string[] — Block apps by their checksum value. - `allowed_postback_event_counts` CommonPostbackEventCount[] — PostbackEventCount condition checks the number of specified events and accepts if there is one event that falls within given range of [start, end). In the example, User's event named "Transaction confirmation" must have been appeared 16 times or more to accept for zigbang app. Example: "condition": { "allowed_postback_event_counts": [ { "app_bundle": "com.chbreeze.jikbang4a", "range": { "start": 16, "end": 0 }, "events": [ "Transaction confirmation" ] } ] } - `app_bundle` string - `range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `events` string[] - `auction_types` string[] — Auction types including first price or second price auctions. Example: "condition": { "auction_types": [ "first", "second" ] } - `throttle_apt_tags` CommonTagsThrottleCondition — Tags Thrrottle Condition. It specifies a throttle rate for a list of tags. All the tags in a list will have same throttle rate. - `tags` string[] - `throttle_rate` number, float - `allowed_dev_makes` string[] — Allowed device make. Example: "condition":{ "allowed_dev_makes": [ "Apple" ] } - `blocked_dev_makes` string[] — Blocked device make. See the example of `allowed_dev_makes`. - `display_manager_versions` CommonDisplayManagerVersion[] — DisplayManager Version. Example: "condition": { "display_manager_versions": [ { "min": "1.2", "max": "4.5.6" } ] } // With minimum version requirement: "condition": { "display_manager_versions": [ { "min": "3.0" } ] } // With maximum version requirement: "condition": { "display_manager_versions": [ { "max": "5" } ] } - `min` string - `max` string - `allowed_audiences` string[] — Allowed audiences. - `blocked_audiences` string[] — Blocked audiences. - `allowed_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Postback event condition filter a bid-request by user's postback summary. Note that audience name and events are of case-sentitive string types. Each entry of allowed_postback_has_all_events_conditions will be satisfied when all listed events are found from user's postback summary. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `blocked_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_all_events_conditions will be satisfied when all listed events are not found from user's postback summary. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `allowed_postback_has_any_events_conditions` CommonPostbackEventsCondition[] - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `blocked_postback_has_any_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_any_events_conditions will be satisfied when there is at least one event not matched by the condition from user's postback summary. See the documentation for `allowed_postback_has_any_events_conditions`. - `audiences` string[] — Audience name. i.e. app bundle. - `events` string[] — List of events such as install and purchase. - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification. - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format. - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00". - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00". - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition. - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end). - `start` integer - `end` integer - `allowed_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target. - `zipcodes` LocationSetZipCodeSet[] - `zipcodes` string[] — Zipcodes to represent areas to target. - `country` string — Uppercase Country code in ISO 3166-1 alpha-2. - `blocked_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target. - `zipcodes` LocationSetZipCodeSet[] - `zipcodes` string[] — Zipcodes to represent areas to target. - `country` string — Uppercase Country code in ISO 3166-1 alpha-2. - `allowed_apt_tags` string[] - `blocked_apt_tags` string[] - `coppa_acceptance` 'UNKNOWN_COPPA' | 'ACCEPT_COPPA_ONLY' | 'DENY_COPPA' — Indicates whether to bid according to the COPPA(Children's Online Privacy Protection Act) value of BidRequest. - UNKNOWN_COPPA: Doesn't filter BidRequest according to the coppa value. - ACCEPT_COPPA_ONLY: Bids to BidRequest with coppa=1. - DENY_COPPA: Bids to BidRequest with coppa=0 or empty coppa field. - `skan_traffic` 'UNKNOWN_SKAN' | 'TARGET_SKAN_ONLY' | 'TARGET_NON_SKAN' — Indicates whether to bid according to bid requests that support SKAN(SKAdNetwork) or not. - UNKNOWN_SKAN: Doesn't filter BidRequest according to support skan or not in this filter. - TARGET_SKAN_ONLY: Bids only for skan support traffic. - TARGET_NON_SKAN: Bids only for non-skan traffic. - `contains_custom_audience` boolean — Whether it contains a `custom_audience` targeting condition. The `custom_audience` targeting condition is legacy, and may contain some internal information. Therefore, we do not reveal them by the API but only signals its non-emptiness with this field. - `custom_audience_set` AudienceTargetingConditionCustomAudienceSet — CustomAudienceSet represents a group of target users to whom we're going to show an ad. CustomAudienceSet is consist of a dynamic (not pre-determined) set of target users based on App-events described in the postback messages and pre-defined CustomerSets. - `include_having_all` CustomAudienceSetCustomAudienceCondition - `app_events` CustomAudienceSetAppEvent[] - `product_id` string — The ID of the Product of which PostbackIntegration info is used. - `event` string — A case-sensitive string name of an event. (e.g. install, purchase). - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - … - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included. - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type. - `product_id` string — The ID of the Product. - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - … - `include_having_any` CustomAudienceSetCustomAudienceCondition - `app_events` CustomAudienceSetAppEvent[] - `product_id` string — The ID of the Product of which PostbackIntegration info is used. - `event` string — A case-sensitive string name of an event. (e.g. install, purchase). - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - … - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included. - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type. - `product_id` string — The ID of the Product. - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - … - `exclude_having_all` CustomAudienceSetCustomAudienceCondition - `app_events` CustomAudienceSetAppEvent[] - `product_id` string — The ID of the Product of which PostbackIntegration info is used. - `event` string — A case-sensitive string name of an event. (e.g. install, purchase). - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - … - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included. - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type. - `product_id` string — The ID of the Product. - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - … - `exclude_having_any` CustomAudienceSetCustomAudienceCondition - `app_events` CustomAudienceSetAppEvent[] - `product_id` string — The ID of the Product of which PostbackIntegration info is used. - `event` string — A case-sensitive string name of an event. (e.g. install, purchase). - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - … - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included. - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type. - `product_id` string — The ID of the Product. - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit. - … - `aud_size` string, int64 — Original audience size information. - `reachable_aud_size` string, int64 — Reachable audience size information. - `top_n_countries_aud_size_map` object — Top N countries audience size information. - `last_aud_size_computed_at` string, date-time — Last updated time of the audience size information. - `auto_delete_at` string, date-time — AudienceTarget used nowhere for specific time will be removed automatically. It represents when this will be deleted in UTC. - `created_at` string, date-time — Created time. - `updated_at` string, date-time — Last updated time. Should not modify on the client side. ## Other responses - `default` — An unexpected error response. --- [API](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api.md) · [All operations](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moloco/moloco-ads-campaign-management-api/versions/5c85d0910ac0/schema)