--- title: "List entity logs (Beta)." method: GET path: "/cm/v1/beta/entity-logs" tags: ["EntityLog"] --- # List entity logs (Beta). `GET /cm/v1/beta/entity-logs` ## Request - Base URL: `https://api.moloco.cloud` - URL: `https://api.moloco.cloud/cm/v1/beta/entity-logs` - Auth: API key in header `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) **Beta:** Schema and behavior may change without backward compatibility guarantees. List AdAccount change history, optionally filtered by entity_id. Coverage varies by entity and field; logs are best effort, not a complete immutable audit trail. One edit may produce multiple entries without a shared action ID. Results are newest first. Responses may contain undocumented fields. ## Query parameters - `ad_account_id` string, required - `entity_id` string ## Response `200` A successful response. - MessagesListEntityLogsResponse - `infos` DspAdCloudEntityLogInfo[]: The list of entity logs. - `user_key` string: The user key (id) of the log info. - `user_name` string: The user's name. - `user_last_name` string: The user's last name. - `user_email` string: The user's email. - `log_timestamp` string, date-time: The timestamp of the log. - `entity_log` DspAdCloudEntityLog: AdCloudEntityLog is the entity to save the entity history info in Datastore. - `id` string: Unique identifier of the AdCloudEntityLog. Automatically set by server on creation. - `activity_type` 'UNKNOWN_ACTIVITY' | 'CAMPAIGN_CREATION' | 'DESCRIPTION_CHANGE' | 'ENABLING_STATE_CHANGE' | 'SCHEDULE_CHANGE' | 'CREATIVE_GROUPS_CHANGE' | 'TRACKING_LINK_CHANGE' | 'CAMPAIGN_GOAL_CHANGE' | 'TITLE_CHANGE' | 'BUDGET_CHANGE' | 'AUDIENCE_CHANGE' | 'AD_GROUP_CREATION' | 'AD_TRACKING_ALLOWANCE_CHANGE' | 'LANDING_URL_CHANGE' | 'ENTITY_DELETION' | 'COUNTRIES_CHANGE' - `user_key` string: The user key(id) who made the activity. - `resource_type` 'UNKNOWN_RESOURCE' | 'UNIVERSE' | 'PLATFORMS' | 'UNIVERSE_USERS' | 'UNIVERSE_USER_CONFIGURATIONS' | 'AGENCIES' | 'PLATFORM_USERS' | 'CAMPAIGN_SUMMARIES' | 'DSP_CONFIGURATION' | 'ADVERTISERS' | 'PRODUCTS' | 'TRACKING_LINKS' | 'ASSETS' | 'CREATIVES' | 'CREATIVE_GROUPS' | 'AUDIENCE_TARGETS' | 'CAMPAIGNS' | 'CAMPAIGN_GROUPS' | 'AD_GROUPS' | 'PRICING_MODELS' | 'PAYOUT_ITEMS' | 'CUSTOMER_SETS' | 'CUSTOMER_ACTIVITIES' | 'ENTITY_LOGS' | 'TRACKING_LINK_VERIFICATION_ATTEMPTS' | 'ADVERTISER_USERS' | 'OPERATION_ITEMS' | 'CREATIVE_TEST_DEVICES' | 'CREATIVE_TEST_CASES' | 'EXPERIMENTS' | 'ENTITY_HISTORY' | 'PUBLISHER_TARGETS' | 'LINE_ITEMS' | 'LINE_ITEM_BUNDLES' | 'ORDERS' | 'ALLOWED_LINE_ITEMS' | 'ALLOWED_LINE_ITEM_BUNDLES' | 'LINE_ITEM_USER_VIEWS' | 'SCHEDULED_REPORT_SETTINGS' | 'PUBLISHER_CUSTOMER_SETS' | 'AUCTION_ORDERS' | 'PIXEL_INTEGRATIONS' | 'GEO_SPLIT_EXPERIMENTS' | 'PRIVATE_EXCHANGES' | 'CREATIVE_REVIEWS' | 'PUBLISHERS' | 'PUBLISHER_APPS' | 'AD_UNITS' | 'REPORTS' | 'BID_TRACES' | 'LOGS' | 'EXPORT_SINKS' | 'REPORT_EXPORTS' | 'MMP_INTEGRATIONS' | 'NOTIFICATION_EVENT_TEMPLATES' | 'NOTIFICATION_EVENTS' | 'NOTIFICATION_DELIVERIES' | 'NOTIFICATION_PREFERENCES' | 'ABRIDGED_CAMPAIGNS' | 'COHORT_SUMMARIES' | 'PLATFORM_SUMMARIES' | 'BILLING_ACCOUNTS' | 'BILLING_INTEGRATIONS' | 'PAYMENT_METHODS' | 'INVOICES' | 'CREATIVE_POLICIES' | 'UNIFIED_SEARCH_INDEXES' | 'CREATIVE_STUDIO_ASSET_METADATA' | 'RMP_PLATFORM_OWNER_CONFIGURATIONS' | 'RMP_PLATFORM_USER_CONFIGURATIONS' | 'RMP_PLATFORM_SUMMARIES' | 'RMP_INVENTORIES' | 'RMP_ADVERTISER_STATUSES' | 'RMP_SELLERS' | 'RMP_ADVERTISERS' | 'RMP_ADVERTISER_USERS' | 'RMP_ADVERTISER_SUMMARIES' | 'RMP_CAMPAIGNS' | 'RMP_WALLETS' | 'RMP_CREATIVES' | 'RMP_CREATIVE_REVIEW_STATUSES' | 'RMP_AD_MANAGERS' | 'RMP_AD_MANAGER_USERS' | 'RMP_AD_MANAGER_SUMMARIES': All resources exposed to services. - UNKNOWN_RESOURCE: This value is not part of the specification. - UNIVERSE: Universe is the implicit pinnacle resource to aggregate all platforms. - PLATFORMS: Platform is the organization separates customers. - UNIVERSE_USERS: Universe User is the resource for universe level users. - UNIVERSE_USER_CONFIGURATIONS: Universe User Configuration is the resource for universe level user's configurations. - AGENCIES: Agency is a person or an organization who runs and manage ads instead of the advertiser. - PLATFORM_USERS: Platform User is the resource for platform level users. - CAMPAIGN_SUMMARIES: Campaign Summaries is the resource of the campaign summary information. - DSP_CONFIGURATION: Platform-wide configuration info There should be only one Configuration per each platform. - ADVERTISERS: Advertiser is the basic unit of organization to run campaigns - PRODUCTS: Product is what advertisers want to promote with the campaign and it is the parent resource of campaigns. - TRACKING_LINKS: Tracking link is the link object to verify the campaign performance. - ASSETS: Asset composes the creative: e.g., images, videos and so on. - CREATIVES: Creative is an advertising unit to communicate a marketing message to the audience. - CREATIVE_GROUPS: Creative group is a group of creatives to be managed in campaigns or ad groups. - AUDIENCE_TARGETS: Audience is the targeting condition of campaigns. - CAMPAIGNS: Campaign describes the detailed information about a campaign. - CAMPAIGN_GROUPS: Campaign group describes the detailed information about a campaign group. - AD_GROUPS: Ad group describes the detailed information about an ad group. - PRICING_MODELS: PricingModel describes the detailed information about a pricing model. - PAYOUT_ITEMS: PayoutItem describes the payout information of a campaign. - CUSTOMER_SETS: CustomerSet describes the user identifiers of an advertiser. - CUSTOMER_ACTIVITIES: CustomerActivity describes the targeted users based on the app events. - ENTITY_LOGS: EntityLog describes the history of the entity of an advertiser. - TRACKING_LINK_VERIFICATION_ATTEMPTS: TrackingLinkVerificationAttempt describes the history of the tracking link verification. - ADVERTISER_USERS: AdvertiserUser represents a user belongs to an advertiser. - OPERATION_ITEMS: OperationItem describes the operation information of an advertiser. - CREATIVE_TEST_DEVICES: CreativeTestDevice describes the test device of an advertiser. - CREATIVE_TEST_CASES: CreativeTestCase describes the test case of an advertiser. - EXPERIMENTS: Experiments represents experiments such as creative tests on MCP - ENTITY_HISTORY: the history of the entities. - PUBLISHER_TARGETS: The publisher target represent a target entity whose parent is PLATFORM. - LINE_ITEMS: The line items represent Pre-configured campaign that contains details like Rate, Frequency Cap and Targeting conditions. - LINE_ITEM_BUNDLES: The line item bundles represent A group of Line Items as a bundled product that can actually be sold to selected buyers. - ORDERS: The orders represent Agreement between Publisher and Buyers of Publisher’s ad inventory, mainly used for upfront deals. - ALLOWED_LINE_ITEMS: The line items which are allowed to be shown to each advertiser. - ALLOWED_LINE_ITEM_BUNDLES: The line item bundles which are allowed to be shown to each advertiser. - LINE_ITEM_USER_VIEWS: Line Item User Views represents the user views of line items. - SCHEDULED_REPORT_SETTINGS: ScheduledReportSetting describes the report setting which is scheduled to be received to advertisers. - PUBLISHER_CUSTOMER_SETS: PublisherCustomerSet describes the customer sets in the publisher level. - AUCTION_ORDERS: AuctionOrder describes a group of the configuration of a campaign, ad groups and creative groups. - PIXEL_INTEGRATIONS: PixelIntegration describes the pixel_integration information which allows Moloco to track website activities. - GEO_SPLIT_EXPERIMENTS: GeoSplitExperiment describes a Product-scoped geo-split experiment. - PRIVATE_EXCHANGES: PrivateExchange describe the private_exchange information. - CREATIVE_REVIEWS: CreativeReview describe the creative_review information. - PUBLISHERS: Publisher describes the publisher information. - PUBLISHER_APPS: PublisherApp describes the publisher_app information. - AD_UNITS: AD_UNITS describes the ad_unit information. - REPORTS: Report represents the report containing campaign statistics. - BID_TRACES: BidTrace represents the traces of the platform - LOGS: Log represents the log containing raw data for imp, click, and conversion. - EXPORT_SINKS: ExportSink represents the export sink containing customer storage configuration to deliver generated files. - REPORT_EXPORTS: ReportExport is for exporting product(application) report to report partner. - MMP_INTEGRATIONS: MMP_INTEGRATION describes a mmp_integration. - NOTIFICATION_EVENT_TEMPLATES: Notification event template represents the common part of events from external sources. - NOTIFICATION_EVENTS: Notification event represents all kinds of information which users should be acknowledged for. - NOTIFICATION_DELIVERIES: Notification delivery represents the notification which is derived from the event. - NOTIFICATION_PREFERENCES: Notification preference represents user's choices for the notification, such as email opt-out. - ABRIDGED_CAMPAIGNS: Abridged Campaign describes the simplified information about a campaign. - COHORT_SUMMARIES: Cohort Summaries represents a cohort summary containing cohort data. - PLATFORM_SUMMARIES: Platform Summaries represents a platform (workplace) summary. - BILLING_ACCOUNTS: Billing accounts for given platform - BILLING_INTEGRATIONS: Billing integration for given billing account. - PAYMENT_METHODS: Payment methods for given billing account. - INVOICES: Invoices for given billing account. - CREATIVE_POLICIES: Creative policies represents a creative related policies - CREATIVE_STUDIO_ASSET_METADATA: This resource represents Creative Studio-specific metadata associated with Asset entities. - RMP_PLATFORM_OWNER_CONFIGURATIONS: RMP Platform Owner Configurations represents a owner configuration of RMP platform (workplace). - RMP_PLATFORM_USER_CONFIGURATIONS: RMP Platform User Configurations represents a user configuration of RMP platform (workplace). - RMP_PLATFORM_SUMMARIES: RMP Platform Summaries represents a platform (workplace) level summary. - RMP_INVENTORIES: RMP Inventories represents the basic information of the target inventory. - RMP_ADVERTISER_STATUSES: RMP Advertiser Statuses represents a status belongs to an advertiser. - RMP_SELLERS: RMP Sellers represents the basic information of client's seller. - RMP_ADVERTISERS: RMP Advertisers represents the basic unit of organization to run campaigns. - RMP_ADVERTISER_USERS: RMP Advertiser Users represents a user belongs to an advertiser. - RMP_ADVERTISER_SUMMARIES: RMP Advertiser Summaries represents a advertiser level summary. - RMP_CAMPAIGNS: RMP Campaigns describes the detailed information about a campaign. - RMP_WALLETS: RMP Wallets describes the detailed information about a wallet. - RMP_CREATIVES: RMP Creatives describes the detailed information about a creative. - RMP_CREATIVE_REVIEW_STATUSES: RMP Creative Review Statuses describes the review status of a creative. - RMP_AD_MANAGERS: RMP Ad Managers represents the managing account that can manage multiple advertisers. - RMP_AD_MANAGER_USERS: RMP Ad Manager Users represents a user belongs to an ad manager. - RMP_AD_MANAGER_SUMMARIES: RMP Ad Manager Summaries represents a ad manager level summary. - `resource_path` string: The resource path of the entity. - `entity_id` string: The entity ID affected by the activity. - `entity_title` string: The entity title affected by the activity. - `creation_campaign` AdCloudEntityLogActivityCampaignCreation: ActivityCampaignCreation describes the creation of the Campaign. - `id` string - `title` string - `change_enabling_state` AdCloudEntityLogActivityEnablingStateChange: ActivityEnablingStateChange describes the enabling state update of the entity. - `before` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED': Enumeration of the enabling states with a default UNSPECIFIED state. - `after` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED': Enumeration of the enabling states with a default UNSPECIFIED state. - `change_description` AdCloudEntityLogActivityDescriptionChange: ActivityDescriptionChange describes the description update of the entity. - `before` string - `after` string - `change_creative_groups` AdCloudEntityLogActivityCreativeGroupsChange: ActivityCreativeGroupsChange describes the CreativeGroups update of the entity. - `before` string[] - `after` string[] - `change_tracking_link` AdCloudEntityLogActivityTrackingLinkChange: ActivityTrackingLinkChange describes the TrackingLink update of the entity. - `before` string - `after` string - `change_campaign_goal` AdCloudEntityLogActivityCampaignGoalChange: ActivityCampaignGoalChange describes the Campaign goal update of the entity. - `before` 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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - `after` 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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - `change_schedule` AdCloudEntityLogActivityScheduleChange: ActivityScheduleChange describes the schedule update of the entity. - `before` 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". - `after` 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". - `change_title` AdCloudEntityLogActivityTitleChange: ActivityTitleChange describes the title update of the entity. - `before` string - `after` string - `change_budget` AdCloudEntityLogActivityBudgetChange: ActivityBudgetChange describes the budget update of the entity. - `before` 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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `after` 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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `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. - … - `change_audience` AdCloudEntityLogActivityAudienceChange: ActivityAudienceChange describes the audience update of the entity. - `before` 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. - … - `blocked_geofences` CommonCircle[]: Blocked geofences. - … - `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 } ] - … - `blocked_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] - … - `allowed_locations` AudienceTargetingConditionLocationFilter[]: Location filter targets specific geo-locational audience using combined conditions of different types such as city, region, zipcode and geofence. - … - `blocked_locations` AudienceTargetingConditionLocationFilter[] - … - `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. - … - `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. - … - `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" ] } ] - … - `allowed_gender_score` AdcloudcommonFloatingPointRange - … - `blocked_gender_score` AdcloudcommonFloatingPointRange - … - `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). - … - `blocked_ages` AdcloudcommonInterval[] - … - `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. - … - `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. - … - `audience_data` CommonAudienceData: Audience Data. It is a filter based on AudienceData stored in UPT. - … - `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" ] } ] } - … - `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. - … - `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" } ] } - … - `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. - … - `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. - … - `allowed_postback_has_any_events_conditions` CommonPostbackEventsCondition[] - … - `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`. - … - `allowed_location_set` AudienceTargetingConditionLocationSet: LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - … - `blocked_location_set` AudienceTargetingConditionLocationSet: LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - … - `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. - … - `after` 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. - … - `blocked_geofences` CommonCircle[]: Blocked geofences. - … - `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 } ] - … - `blocked_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] - … - `allowed_locations` AudienceTargetingConditionLocationFilter[]: Location filter targets specific geo-locational audience using combined conditions of different types such as city, region, zipcode and geofence. - … - `blocked_locations` AudienceTargetingConditionLocationFilter[] - … - `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. - … - `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. - … - `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" ] } ] - … - `allowed_gender_score` AdcloudcommonFloatingPointRange - … - `blocked_gender_score` AdcloudcommonFloatingPointRange - … - `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). - … - `blocked_ages` AdcloudcommonInterval[] - … - `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. - … - `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. - … - `audience_data` CommonAudienceData: Audience Data. It is a filter based on AudienceData stored in UPT. - … - `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" ] } ] } - … - `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. - … - `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" } ] } - … - `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. - … - `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. - … - `allowed_postback_has_any_events_conditions` CommonPostbackEventsCondition[] - … - `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`. - … - `allowed_location_set` AudienceTargetingConditionLocationSet: LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - … - `blocked_location_set` AudienceTargetingConditionLocationSet: LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used. - … - `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. - … - `creation_ad_group` AdCloudEntityLogActivityAdGroupCreation: ActivityAdGroupCreation describes the creation of the AdGroup. - `id` string - `title` string - `change_ad_tracking_allowance` AdCloudEntityLogActivityAdTrackingAllowanceChange: ActivityAdTrackingAllowanceChange describes the ad tracking allowance update of the entity. - `before` '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. - `after` '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. - `change_landing_url` AdCloudEntityLogActivityLandingUrlChange: ActivityLandingUrlChange describes the change of the landing URL. - `before` string - `after` string - `delete_entity` AdCloudEntityLogActivityEntityDeletion: ActivityEntityDeletion describes the deletion of an entity. - `id` string - `title` string - `change_countries` AdCloudEntityLogActivityCountriesChange: ActivityCountriesChange describes the change of the targeting countries. - `before` string[] - `after` string[] - `created_timestamp_nano` string, int64: Creation timestamp in nano seconds. - `updated_timestamp_nano` string, int64: Last update timestamp in nano seconds. ## Other responses - `default`: An unexpected error response. ## Changes - **2026-11-03** `fa372006b0f6`: 1 info - endpoint added [Operation history](https://skmtc.dev/moloco/apis/moloco-ads-campaign-management-api/changes/cm/v1/beta/entity-logs/get.md) --- [API](https://skmtc.dev/moloco/apis/moloco-ads-campaign-management-api.md) - [All operations](https://skmtc.dev/moloco/apis/moloco-ads-campaign-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/moloco/apis/moloco-ads-campaign-management-api/revisions/fa372006b0f6?raw)