LIN-2577 document automatic cohort sync alongside manual upload - #202
Open
tashviks wants to merge 2 commits into
Open
LIN-2577 document automatic cohort sync alongside manual upload#202tashviks wants to merge 2 commits into
tashviks wants to merge 2 commits into
Conversation
Splits the page into two paths and leads with the automatic one. A cohort is a live rule, so a CSV export describes who matched on the day it was downloaded — and re-uploading a file only ever adds people, it never removes the ones who stopped matching. That distinction is the whole reason the sync exists, so the page now opens with it rather than treating both routes as equivalent. The automatic section covers setup, the status chips, and the parts that generate support tickets: - Google applies uploads asynchronously (up to 48h), and hides audiences below roughly 100 matched members for Display / 1,000 for Search. A working sync therefore shows a size of 0 for small cohorts, which reads as failure. - Removal on Google happens by membership EXPIRY, not deletion. Left at the 540-day maximum, nobody is ever removed — the duration has to be set near the sync cadence for the feature to do what it claims. - Audiences Google builds from rules (e.g. "All Converters") cannot receive uploads at all. - Phone numbers without a country code are dropped rather than guessed at, which is what the Default country field is for. The existing manual walkthrough is unchanged apart from heading levels. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Adds the three screenshots the page was missing and rewrites the new sections against CLAUDE.md, which the first pass did not follow: - No em-dashes anywhere (the previous version was full of them). - description frontmatter, Troubleshooting section and support line. - Shorter sentences, second person, one idea at a time. Screenshots: the Cohorts tab, the Ad network sync panel with a synced destination, and where List ID appears in Google Ads Audience manager. Customer data is kept out: the connected ad account and project name are replaced with a neutral placeholder, and each image is cropped to the relevant area so no user emails or the account switcher are included. Also drops the claim that syncs happen on a schedule. Only the in-drawer Sync now action ships today, and CLAUDE.md says not to document flows that are not live. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Splits
features/remarketing-audience-uploadinto Automatic sync and Manual upload, leading with the automatic path.A cohort is a live rule, so a CSV export describes who matched on the day it was downloaded — and re-uploading a file only ever adds people, never removes the ones who stopped matching. The page now opens with that distinction instead of treating both routes as equivalent.
What the automatic section covers
Setup, the status chips, and the things that will otherwise generate support tickets — all of which surfaced while testing this against a live Google Ads account:
The existing manual walkthrough is unchanged apart from heading levels.
Not in this PR
Sync nowtoday but the nightly sweep is not yet wired up in ops. Worth confirming that ships before this page publishes, or the "stays current" claim overpromises.🤖 Generated with Claude Code