Syncing Order Data

Why Sync Order Data

Project Agora Commerce requires order data generate relevant ads and to disburse money properly to all entities involved in transactions (disbursement occurs only in the case of discounts. Project Agora Commerce charges only for impressions and clicks.).

Syncing orders is also valuable for advertiser and retailer dashboards in the Project Agora Commerce portal. Orders are used in sales, conversion, sale value and ROAS calculations. These are invaluable for advertiser teams to gauge their investment worth, and contribute additional spend.

Order Attribution

It's necessary that an explicit association between a single order item and a single ad id can be provided. The attribution responsibility on the integrator.

The below step is followed each time a new order is created. The integrator is required to store the adId relevant to each product ordered until the order is submitted. In an API push, the field is within the individual product's . orderItems object:

  "orderItems": [
            {
                  "gtin": "catpref--123456", 
                  "quantity": 3,
                  "regularUnitPrice": "9.99",
                  "totalOrderItemPriceAfterDiscounts": "9.99",
                  "adId": "display_zeowj3jV8VRxB1w_iEPy_upxFPc5ODkxNTY2UA=="                
                }
              ]

The quantity field should contain the quantity of the product that was ordered, and the reqularUnitPrice and totalOrderItemPriceAfterDiscounts should contain both the final price of the product as exists in the product feed.

The gtin field in orderItems element above is the <pa_id> of this product

The adId field contains the id which is returned as a response when requesting a Sponsored Product Listing, Discovery Product Listing, or a Banner ad