From purchasing to business results
Start with your products, then follow purchasing, receipts, shops and business results.
Which SKU should I use?
Use one internal SKU for the same physical goods across shops. Link each shop variant to that SKU. Set up components before selling a kit; matching names alone does not link stock.
How do I purchase and receive goods?
In Shared warehouse → Purchasing, review replenishment or create a purchase plan. Confirm supplier, quantity and warehouse, then approve and create the purchase order. Record dispatches before receipts. Each receipt starts at zero; enter actual good and damaged quantities. Saving a draft does not add stock; confirm receipt after checking it.
How do I publish to several shops?
In Product center, prepare a draft and select target shops. Complete each shop's required fields and check its preview before submitting. Check each shop's result separately. After success, link shop variants to internal SKUs. If the result is uncertain, check the existing publication record before trying again.
How do orders and returns affect stock?
When order tracking is enabled, pending orders reserve stock and dispatch reduces it. Confirm the shipping warehouse before using this workflow. A refund alone does not add stock: record goods actually received back in Warehouse operations → Return receipt, separating good and damaged goods.
Why are business results pending review?
Open a product's Operations view and select its project and sales dates. Review orders, settlement, goods costs, operating expenses and advertising costs. Missing information stays pending instead of becoming zero. Save the reviewed result with a note; saved reports keep their original results.
How does advertising join the workflow?
Link the advertising account, shop, product and internal SKU. Review advertising costs against settlement deductions to avoid counting the same fee twice. GMV Max attributed sales are advertising results, not settlement receipts. Shop or advertising changes require the relevant authorization and enabled capability.
Asset updates
Explains asset status, update behavior, and Project-linking boundaries.
What does Update assets do?
Update assets checks authorized profiles, accounts, pages, delivery structure, creatives, apps, and landing pages from the ad platform. It helps decide which platform assets can be linked to a Project.
Why can assets be marked already fresh?
The system checks whether stable asset layers were confirmed recently. If there is no obvious need to update, it skips extra platform requests to reduce waiting time and API cost.
What are authorization, account, delivery, and clues?
Authorization is the connection source. Accounts include BMs, ad accounts, and Pages. Delivery includes campaigns, ad sets, and ads. Clues include creatives, apps, and landing pages that help determine Project ownership.
Why are accounts refreshed less often than delivery data?
BMs and accounts usually change slowly. Ads, creatives, apps, and landing pages can change with campaign operations, so the system prioritizes layers that are more likely to change.
Do unlinked assets sync spend and revenue?
No. Unlinked assets are used only for discovery and ownership review. Performance fact sync starts only after assets are linked to a Project.
What is a new discovery?
A new discovery is an asset that appears during the latest update, such as a new ad account, Page, campaign, creative, app, or landing page. It appears in Platform Assets before you decide whether to link it to a Project.
Data sync
Date ranges today data automatic retries and results.
What does one sync update?
The system updates connected platform data for the selected dates and assigns results to relevant Projects. Users do not need to choose APIs or internal job types.
Why can today's data change?
Ad and attribution platforms can report or backfill data later. Use today for directional monitoring. For a full review use dates that have ended and are marked complete.
Which failures recover automatically?
Timeouts rate limits and temporary platform errors retry automatically. Expired access missing permissions and ownership conflicts require user action.
External data access
Read access data completeness and ongoing updates.
What can a connected system read and when does access expire?
Administrators choose Projects and platforms in Settings → External connections to grant read-only ad spend access. Credentials default to 30 days; see connection details for the expiry. Before expiry initialize and reconcile a full import with the replacement credential then switch over. Old cursors cannot be reused.
Why is data incomplete when an amount is available?
Known amounts reflect only data received so far and may not be full totals. Complete rows can contribute to a full total; partial rows retain known amounts; missing rows have no valid data and must not be treated as zero. A successful read and reconciliation do not mean all platform data has arrived.
Can yesterday and older dates still change?
Yesterday may be temporarily missing after midnight until the first hourly sync succeeds. API reads do not start a sync. Once syncs or platform backfills update data pull changes and replace each changed row then reconcile again; do not add new spend to the old value.
Can data keep updating without a Webhook address?
Yes. Start with a full import and reconciliation then pull changes hourly. Enable update notifications once the receiver is ready. Notifications prompt another read; they contain no spend details and do not replace scheduled pulls.
Project ownership
How Projects business scopes and unmatched data work.
Why link assets to a Project?
Links decide which accounts apps pages and landing pages appear in Project reporting. Shared ad accounts sync once and are shown in each Project by ownership.
What happens to unmatched data?
Unmatched data remains in platform totals but is excluded from App landing-page and product-line views. Historical data can be recalculated after links or rules are added.
Creative preview and library
Platform previews source files and Add to library.
Why is only a thumbnail available sometimes?
An ad platform may expose creative metadata without the underlying image or video source. The system tries available preview endpoints and shows a clear permission message when needed.
What does Add to library do?
After confirmation the system fetches the best available source calculates its fingerprint and stores it in R2. Previewing alone does not copy files or request all platform creatives.