To run ads with Moloco Dynamic Product Ad (DPA), you must integrate a feed. A feed is a file that contains a list of products or services you would like to advertise. DPA is based off of product information such as price, product image, and product title pulled from a regularly updated feed provided by advertisers. To learn more about DPA, see What is Dynamic Product Ad (DPA).
Requirements for feed upload
File format
You can upload files in .csv, .tsv, and .xml (RSS/ATOM) formats. For larger feeds, you can upload compressed files in .gz, .zip, and other formats or upload multiple different feeds.
Template
Moloco is able to integrate most industry-standard product feed templates from major corporations such as Criteo, Facebook, Google, and Naver. When using these templates, be sure that your field values are compliant with Moloco's requirements. Alternatively, you can create and upload a custom feed with the required fields.
Full list of products
To get the most out of our machine learning technology, you should provide us with a feed including all products available for purchase rather than a subset of products (e.g., top thousand most popular products). There is no limit on the number of items you can add to the feed. In compliance with our creative policy, adult products must be removed from the feed or tagged as adult. See product feed fields for more information.
Important: If you are looking to run campaigns across multiple countries, you must create and upload separate feeds for each country, and/or language.
Feed URL
Format and protocol
Acceptable URL formats are http and https. FTP, FTPs, SFTP URL, and API calls aren't supported at this time. Feed URLs must be constant and shouldn't include variables subject to update such as date last updated.
Sample URL | Supported | Reason |
https://abccloud.com/xyz_company/feed.csv | O | We support URLs in https format. |
https://product_feed.xml | △ | .xml files are acceptable only when they are consistent with Criteo's product catalog specifications. Reach out to your Moloco representative to find out if you can use your product feed with us. |
ftps://example.com | X | We don't support URLs in ftps format at this time. |
https://ep.xyz.com/full/20230330 | X | Feed URL contains timestamp for date last updated, which is a non-constant value. |
URL access
If your feed URL can be accessed only from allow-listed IP addresses, please ask your Moloco representative for Moloco's IP address. You should let us know if an ID and password are needed to access the feed.
Full feed and update feed
Your full product feed must include all products available for purchase to be updated on a regular basis. In addition to the full feed, you can create and upload an update feed that only reflects the changes such as new or out of stock products to be updated more frequently. You must use a separate URL for the update feed.
Feed update frequency
You must specify a time and timezone for regular updates to the full feed (e.g., every 4am PST) and update feed (e.g., every 4 hours between 1am and 1pm UTC). You should allow at least 4 hours between each full feed update, and at least an hour between each update to the update feed.
Important: Feed update may be unsuccessful when changes have been made to the file structure (e.g., adding a column), data format is incorrect, or there is no data at the time of update.
Product feed fields
To create and upload a custom feed, you must fill out the fields we ask for. For standard templates from major corporations such as Google, Meta, Criteo, and Naver, there is no need to use the field names or values we provide but product or content images must still meet our image requirements to be included in your campaign.
Important: We recommend using UTF-8 for your product feed file. For .csv and .tsv files, values including a comma or tab(\t) must be wrapped in double quotes following the conventions for .csv and .tsv formats.
E-commerce
For e-commerce apps, you should include the following fields. The following fields are applicable to other verticals such as travel and food delivery services.
Required fields
Field | Description |
Product ID [product_id] |
Enter a unique identifier for the product. Product IDs must match IDs included in MMP postback. You can enter up to 240 characters. e.g.,) |
Product Title [product_title] |
Enter a name for the product. You can enter up to 200 characters. e.g.,) |
Price [price] |
Enter the product's market price without discounts. Decimal value should be marked with a period. If using a .csv file, you should use double quotes to be able to use thousands separator commas. You can include currency. e.g.,) |
Image Link [image_link] |
Enter a URL for the product image. URL must start with http or https.
|
Category [category] |
Enter a category for the product. You can enter up to 100 characters. e.g.,) |
Recommended fields
Field | Description |
Discounted Price [discounted_price] |
Enter product price with discount applied. This is the price we display as the final asking price. Decimal value should be marked with a period. If using a .csv file, you should use double quotes to be able to use thousands separator commas. You can include currency. e.g.,) |
Product In-App Link for Android [android_url] |
Enter a deep link URL for the product page to appear in Android apps. |
Product In-App Link for iOS [ios_url] |
Enter a deep link URL for the product page to appear in iOS apps. |
Adult [adult] |
Indicates whether the product feed includes adult products. Acceptable values are In compliance with our creative policy, your feed can't include adult products unless it is tagged adult. Without proper tagging, your campaign may be terminated at any time at our discretion. |
Optional fields
Field | Description |
Availability [availability] |
Indicates whether the product is available for purchase. Products not available for purchase aren't displayed. Acceptable values are in stock and out of stock . |
Condition [condition] |
Enter a description of the product condition. Acceptable values are new , refurbished , and used . |
Brand [brand] |
Enter a brand for the product. You can enter up to 100 characters. |
Content
For content-oriented apps such as webtoon, OTT, real estate, and job search apps, you should include the following fields.
Required fields
Field | Description |
Product ID [product_id] |
Enter a unique identifier for the product. Product IDs must match IDs included in MMP postback. You can enter up to 240 characters. e.g.,) |
Product Title [product_title] |
Enter a name for the product. You can enter up to 200 characters. e.g.,) |
Image Link [image_link] |
Enter a URL for the product image. URL must start with http or https. Product image must meet the following requirements.
|
Content Label 0 [content_label_0] |
Enter at least one label for the product to include in content feed. You can use up to three labels. You can enter up to 20 characters for all three labels combined. Depending on language and inventory type, an ellipsis (...) may be inserted for brevity. e.g.,) |
Recommended fields
Field | Description |
Content Label 1 [content_label_1] |
Enter an additional label for the product to include in content feed. You can use up to three labels. You can enter up to 20 characters for all three labels combined. Depending on language and inventory type, an ellipsis (...) may be inserted for brevity.
e.g.,) |
Product In-App Link for Android [android_url] |
Enter a deep link URL for the content to appear in Android apps. |
Product In-App Link for iOS [ios_url] |
Enter a deep link URL for the content to appear in iOS apps. |
Content Preview Image Link [preview_image_link] |
Enter a URL for the content preview image. URL must start with http or https. Preview image must meet the following requirements.
|
Adult [adult] |
Indicates whether the product feed includes adult products. Acceptable values are In compliance with our creative policy, your feed can't include adult products unless it is tagged adult. Without proper tagging, your campaign may be terminated at any time at our discretion. |
Optional fields
Field | Description |
Content Label 2 [content_label_2] |
Enter an additional label for the product to include in content feed. You can use up to three labels. You can enter up to 20 characters for all three labels combined. Depending on language and inventory type, an ellipsis (...) may be inserted for brevity.
e.g.,) |