Halo calculator
Bring your data. Explore the Amazon impact of your TikTok activity.
Your weekly update
Daily data · weekly routineStart with 210 daily Amazon outcomes plus 28 earlier days of TikTok views when available. The minimum remains 140 + 28 days; it is a software floor, not a guarantee of accuracy. Never turn a weekly total into seven invented daily values.
- First run: upload the full history for one brand/product scope. Whole-account Amazon data is the simplest manual option when the account contains only that brand.
- Every Wednesday: restore your workspace. Re-export the last 28 days through the preceding Saturday from both sources, retaining daily rows. Review replacements so late corrections are included.
- Check and run: verify the same scope/day boundaries, record promotions or stock issues, advance the cutoff and run. Review the latest complete week and trailing 28 days.
- Save: download the updated workspace and full analysis. Monthly, replace both histories with fresh complete exports to catch older revisions.
The suggested cutoff allows three full days after the reporting day closes. This is a ShopOS operating buffer, not a provider finalization guarantee. If either source is incomplete, choose an earlier date. A selected-product Amazon backfill can require one export per day; use a verified daily warehouse extract when that is impractical.
Workspaces contain source CSVs and settings, not approved results. They stay on your device unless you share the file.
Leave unchecked to replace the entire file. Pasting always replaces the full history. Both weekly files must keep the same columns, controls, product scope and metric definitions.Bring both sides together
CSV or pasteThe Amazon file, capped by “Verified complete through,” determines the model window: 140–1,096 consecutive days. TikTok must cover that entire window plus the preceding 28 days. For example, Amazon Jan 29–Jun 17, 2026 (140 days) needs TikTok Jan 1–Jun 17 (168 days). Every date and measurement is required, including weekends. Use 0 only for a verified zero; missing values are rejected.
Export from Amazon Seller Central
- Go to Reports → Business Reports.
- If the scope is your entire marketplace account, open Sales and Traffic by Date, choose daily rows, set the exact date range and download the CSV.
- If the scope is selected products, open Detail Page Sales and Traffic by Child Item. A multi-day download gives totals by child ASIN for the selected range—not a daily date × ASIN table. To preserve product-level daily data, export each day and aggregate the approved child ASINs, or use a verified warehouse/API process that produces one value per child ASIN per day.
- Copy each date’s Ordered Product Sales into the ShopOS template as
amazon_sales. Keep one marketplace and one currency. Do not use settlement, payment or Amazon Ads sales.
Check before upload: every calendar day is present, parent totals are excluded, and each daily value covers the same products.
Amazon’s Business Reports guide ↗Upload a prepared Amazon ordered product sales CSV, not the unchanged Seller Central download. Required headers: date,amazon_sales. Sum the included child ASINs once per day; exclude parent totals. Sales provide the outcome the model explains.
date,amazon_sales\n2026-01-29,2840.55\n2026-01-30,3100.00The template uses your ending date and history length above. Fill every blank sales cell with a verified daily value.or paste belowAlso accepts
ordered_product_sales and a child_asin column. Each included ASIN must have a known outcome for each modeled day. Optional reviewed controls: up to 8 numeric control_name columns. For child ASIN rows, repeat the same aggregate daily control values for each ASIN.Export from TikTok Shop Seller Center
- Go to Analytics → AI Report → Create New.
- Select the Video views metric. Use the Amazon outcome dates plus the preceding 28 warmup days.
- Use Shop granularity for a whole-shop program, or apply a compatible product/account/program scope. Add the Time period → By day breakdown.
- When the report finishes loading, choose Export. Map the daily date column to
dateand daily Video views toviewsin the ShopOS template.
Long or filtered programs: TikTok currently limits Shop × Video, LIVE or Creator drill-downs to 31 days per query. Export consecutive nonoverlapping windows and combine them without duplicating dates. Shop-level traffic queries can cover longer windows. If AI Report is unavailable, Video Performance can be used only when its download contains daily—not lifetime—view totals.
Do not use: GMV, product impressions, order counts, videos posted, or the lifetime Views value from a video-detail row.
Upload a prepared TikTok daily video views CSV, not the unchanged Shop report. Required headers: date,views. Use one verified, nonduplicated total of views received each day for the measured program, including 28 earlier days. Views represent exposure that may affect later Amazon sales.
date,views\n2026-01-01,125000\n2026-01-02,138000The template uses your selected history plus 28 earlier days. Fill each blank with verified views received that day; preserve the extra history.or paste belowAlso accepts
exposure_total. Use whole-number daily views, not lifetime totals, impressions, sales or videos posted. Do not add overlapping organic and paid counts; reconcile duplicates first.Both files: UTF-8, comma-separated CSV, one header row, dates as YYYY-MM-DD, and no currency symbols. Files: at most 5 MB and 50,000 rows each. Use a decimal point for sales; quote values containing commas (e.g. "1,250.55"). Choose one accepted sales/views header, not both aliases. Format checks appear here; paired coverage and model checks run when you click Run.
Optional CSV columns
Both sources accept currency, timezone or reporting_timezone, coverage_status, marketplace_id and shop_id. If included, fill every row. Currency and timezone must match the settings; coverage_status must be complete. Use one marketplace and shop throughout.
TikTok also accepts exposure_metric: use views, video_views or verified_total_video_views. Other columns are ignored and listed in the format feedback.
Context for the analysis
Notes are exported for review; they do not automatically adjust the model. Numeric control columns must represent reviewed confounders, not consequences of TikTok activity. Use planned price/promotion changes or independent media only after reviewing timing. Amazon search, sessions, page views, attributed ad sales and TikTok GMV must not be added as automatic controls for a total TikTok effect. Demand-responsive Amazon Ads spend and TikTok-induced stockouts need separate causal review.Checking your data…
Calculated locally. Save your workspace and analysis before closing; there is no cloud account or automatic backup.