v1

latestOpenAPI 3.0.02026-07-2496664456.3 KB
Product

Create a new Product.

Create a new Product of the AdAccount.

post/cm/v1/products

Query parameters

ad_account_idstring required

The AdAccount ID to which the Product belongs.

Request body

idstring

Unique identifier of the Product. Automatically set by server on creation.

ad_account_idstring

The ID of the AdAccount the Product belongs to.

titlestring required

A descriptive name of the Product.

descriptionstring

A short description of the Product.

advertiser_domainstring 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_domainboolean

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_namestring

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.
created_atstring date-time

Created time.

updated_atstring date-time

Last updated time. Should not modify on the client side.

Response

A successful response.