Weekly Shopify to TikTok audience refresh

Every Monday at 6am (advertiser timezone), refresh my TikTok custom audiences from Shopify customer data so retargeting, exclusion, and lookalike campaigns stay current.

Build the segments from Shopify. Use shopify List Customers and shopify List Orders (orders from the last 90 days) to compute three segments per customer:

1) High-value buyers — customers with 2 or more orders in the last 90 days OR lifetime spend above a configurable threshold (default $250). Use these as the seed for a lookalike.

2) Recent purchasers — customers who ordered in the last 30 days. Use these as an exclusion audience so prospecting doesn't waste spend on people who just bought.

3) Lapsed one-time buyers — customers with exactly one order whose last order was 60+ days ago. Use these as a winback audience.

For each segment, collect email addresses and phone numbers, normalize them (lowercase emails, E.164 phones), and SHA-256 hash each value before sending to TikTok.

Push to TikTok. For each of the three segments, look for an existing custom audience named after the segment (e.g. "Shopify: High-Value Buyers"). If it exists, call tiktok-ads Update Custom Audience in replace mode so the audience reflects the current segment. If it does not exist yet, call tiktok-ads Create Custom Audience from File to create it from the hashed identifiers. Save the audience IDs for reuse.

After the high-value audience is refreshed, use tiktok-ads Create Lookalike Audience with the high-value audience as the seed (default expansion size: 1% same country as the advertiser). If a lookalike from this seed already exists, skip creation.

Attach the audiences to ad groups with tiktok-ads Apply Custom Audience to Ad Groups: include the lapsed one-time buyer audience on the designated winback ad group, and exclude the recent purchaser audience from the designated prospecting ad groups. Ask the user for the winback ad group ID and the list of prospecting ad group IDs during setup.

Finally, post a summary to a Slack channel using slackbot Send a Message. Include: each segment's size, the delta versus last week (added / removed), whether each audience was created or updated, the lookalike audience ID (or "skipped"), and the list of ad groups updated. Keep it under 15 lines and use Slack mrkdwn bullets.

Configuration to prompt the user for: Shopify shop, TikTok advertiser ID, high-value spend threshold, recent purchaser window (days), lapsed window (days), winback ad group ID, prospecting ad group IDs, and the Slack channel for the summary. Store last run's segment sizes so the next run can compute deltas.