官网登陆地址：https://marketing.criteo.com/
官网api介绍：https://marketing.criteo.com/e/s/article?article=360001226005-Marketing-API-details&language=en_US
官网swagger：https://api.criteo.com/marketing/swagger/ui/index
python包github地址：https://github.com/criteo/criteo-python-marketing-sdk
Testing Criteo Marketing API：https://marketing.criteo.com/e/s/article?article=360001226125-Testing-Criteo-Marketing-API&language=en_US
currency：The currency code used must match the ISO 4217 Currency Code Standard.
Criteo Resellers Program API:https://marketing.criteo.com/e/s/article?article=360001265360-Criteo-Resellers-Program-API-Guide-V2-0&language=en_US
the Business Manager role
Time Zone
All dates in the Criteo REST API are shown in Coordinated Universal Time (UTC).
Data Freshness
Remaining budget and statistics are not real time and can have up to a few hours of delay. Hence a seller can be inactive while their remaining amount is still decreasing. The sellers’ ads are not displayed anymore, but the remaining budget is decreasing as data is catching up.
API usage recommendations
When updating large batches of budgets or bids, you should implement these changes in separated, batched API calls as opposed to many individual calls as this may lead to throttling.
One call should be marked for bids, and another call for budgets. Both calls will contain the correct bids per campaigns and budgets for the given or multiple campaigns.
EXAMPLE: You need to set bids and budgets for 10 different sellers. We recommend you send 1 API call for seller-campaign endpoint and 1 call for budgets endpoint, with both containing respective sellers desired bids and budgets.
How do I authenticate the API?
Criteo uses JWT to provide token based authentication system to our REST API. In order to issue calls to our API, you will need to pass a token on to any of these calls.
To get your token, you will need to issue a POST call to the /oauth2/token endpoint, with client_id and client_secret as parameters (see Getting Started section).
NOTE: Each token is valid for 5 minutes. Should your token expire, you will receive a 401 HTTP response status code.
认识JWT
product & campaign
Advertising objectives:
- Web traffic: Increase visits to your website, where people can find more information about your products and services and consider buying. For example, to generate interest in a new line of products, you could reach people who have shown interest in your products in the past and bring them to your website to learn about the new line.
- App Installs (coming soon): Drive people to download your app. This can include brand new customers, or existing customers who have purchased from you online or in your store, but who haven’t downloaded your app yet.
- The Conversion objective is used by marketers looking to drive the highest number of conversions at the lowest cost. This objective will inform the bidding strategy, placing a higher value on people who are most likely to convert. For example, a hotel website may use this objective to increase bookings from people searching for last-minute hotels. These users are more likely to convert – and therefore valued higher – than those looking for dates further out. As a result they see increased conversions from this campaign.
- The Revenueobjective will help maximize revenue at the lowest cost. For example, a furniture company may use this objective to sell higher ticket items such as bedroom sets in order to increase revenue, because people who show interest in these more expensive products will be valued higher than those looking at lower-ticket items. As a result, their campaign will deliver conversions with a higher average order value.
- The New customer objective will target people who are interested in your products or services, but who have never purchased before. For example, a bike company will value people who have never purchased from their site higher than loyal customers.
seller & budget & bid & campaign
What if one of my sellers changed the name on my platform?
As our API essentially relies on sellerName to manage bids and budgets, any change in seller name will automatically create a new entry in our system, not linked to the previous seller name.
In a nutshell, if a seller changes its name on your platform, you will need to:
- Update your product feed with the new sellerName
- Initialize your seller's bid and budget by sending us a PUT /v2/crp/seller-campaigns & POST /v2/crp/budgets
the Criteo Reseller Program REST API which allow you to manage campaigns bids and budgets at the sellers level
Criteo REST API for Resellers
ONBOARDING A SELLER IN THE CRITEO RESELLER PROGRAM
To onboard a new seller, you will need to make sure he is properly flagged in the Product Feed catalog you've previously shared with Criteo.
To make sure your seller is properly flagged, you will need to set the seller name column to the seller unique identifier, which is the seller name for each of your seller’s products provided in the feed.
Tip: A seller becomes active once you send us available products through the feed & both their bid and budget.
After the steps above, you will be able to send us your sellers’ budget and bids thanks to the sellers' endpoints described previously, especially:
- PUT /v1/sellers/bids to send us the sellers’ CPC
- POST /v1/sellers/budgets to send us the seller’s budget
Tip: You can retrieve the full list of sellers with their status (active/inactive) by issuing a GET call to the seller’s endpoint, providing your Criteo Reseller Program campaign identifier (CampaignID) as a parameter.
Tip:
A seller is:
- Active if: it has a budget and a bid and at least one product in the catalog
- Inactive if:
- in its initial status, you’ve declared the sellerName in the Product Feed and not declared yet any budget and/or bid,
- it has no active budget (see later budgetStatus).
ads page & ads Placement
After a page is registered, your Criteo Technical Solutions Engineer will setup Ad placements where the sponsored Ads will be shown on your site
tag 平台
