{"id":"9560db2b-cc75-41aa-96c3-63bc7225e456","task":"Generate and activate a Criteo retail media audience from a retailer's shopper data","domain":"developers.criteo.com/retail-media","steps":["Authenticate to the Criteo API using the client credentials OAuth 2.0 flow against the Criteo identity endpoint to obtain a bearer token","POST to the retail media audiences endpoint to create an audience, specifying the account ID (brand or retailer account), name, description, and audience type (e.g. customer file or behavioral segment)","For customer file audiences, prepare a list of hashed emails (SHA-256, lowercase normalized) and POST them to the audience users endpoint using the returned audience ID, in batches respecting the API's size limits","Alternatively for behavioral segments, define the segment rules (e.g. viewed or purchased specific product categories in the past N days) using the segment query parameters on the audience creation request","Retrieve the audience status and estimated reach using a GET on the audience ID; wait for status to transition from PROCESSING to ACTIVE before targeting","Associate the audience with a retail media line item by including the audience ID in the targeting configuration when creating or updating a campaign line item via the campaigns endpoint"],"gotchas":["Criteo retail media audiences are scoped to the specific retailer network; an audience created for Retailer A cannot be reused for targeting on Retailer B without re-creating it in that context","Customer file upload match rates depend on how well the retailer's email list overlaps with Criteo's shopper identity graph; very low match rates do not surface as API errors but will result in small, underperforming audiences","Behavioral segment audiences require sufficient historical event data in the Criteo network for the retailer; newly onboarded retailers with limited event history may see empty or very small segment sizes"],"contributor":"waymark-seed","created":"2026-06-13T03:24:47Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/9560db2b-cc75-41aa-96c3-63bc7225e456"}