criteo marketing api 相关

官网登陆地址：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 平台

Facebook Marketing API - 如何处理通过广告系列 ID 检索*所有*广告集的速率限制？

output

{''ACTIVE'': [''******************'',''******************'',''******************''],''PAUSED'': [''******************'',''******************''}

import pandas as pd
import json
import re
import time
from random import *

from facebook_business.api import FacebookAdsApi
from facebook_business.adobjects.adaccount import AdAccount # account-level info
from facebook_business.adobjects.campaign import Campaign # campaign-level info
from facebook_business.adobjects.adset import AdSet # ad-set level info
from facebook_business.adobjects.ad import Ad # ad-level info

# auth init
app_id = open(APP_ID_PATH,''r'').read().splitlines()[0]
app_secret = open(APP_SECRET_PATH,''r'').read().splitlines()[0]
token = open(APP_ACCESS_TOKEN,''r'').read().splitlines()[0]

# init the connection
FacebookAdsApi.init(app_id,app_secret,token)

campaign_types = list(output.keys())

ad_sets = {}

for status in campaign_types:
    ad_sets_for_status = []
    for campaign_id in output[status]:
        # sleep and wait for a random time
        sleepy_time = uniform(1,3)
        time.sleep(sleepy_time)
        # pull the ad_sets for this particular campaign
        campaign_ad_sets = Campaign(campaign_id).get_ad_sets()
        for entry in campaign_ad_sets:
            ad_sets_for_status.append(entry[''id''])
    ad_sets[status] = ad_sets_for_status

from facebook_business.exceptions import FacebookRequestError

...

for status in campaign_types:
    ad_sets_for_status = []
    for campaign_id in output[status]:

        # keep trying until the request is ok
        while True:
            try:
                campaign_ad_sets = Campaign(campaign_id).get_ad_sets()
                break
            except FacebookRequestError as error:
                if error.api_error_code() in [17,80000]:
                    time.sleep(sleepy_time) # sleep for a period of time
           
        for entry in campaign_ad_sets:
            ad_sets_for_status.append(entry[''id''])
    ad_sets[status] = ad_sets_for_status