Readme and admin wording only; no functional changes. Feed URLs don't change.<\/p>","2.1.0":"
New Health tab and optional all-countries file, plus fixes for token resets, backfills, phone numbers and lost schedules. Feed URLs don't change.<\/p>","2.0.0":"
New audience window with a nightly rebuild, any order status, and value segments. Your files keep working exactly as before until you save the Settings tab once; then the nightly rebuild starts. Feed URLs don't change.<\/p>","1.1.1":"
Naming and documentation release; no functional changes.<\/p>","1.1.0":"
Feed URLs changed to end in Build Google Ads customer lists<\/strong> (Customer Match) from your WooCommerce<\/strong> orders: one CSV file per billing country, updated automatically on a schedule. Each country file has its own private, tokenized URL that Google Ads fetches straight from your WordPress site, with no third-party connector or API key \u2014 ideal for marketing teams that run per-country campaigns and want clean, single-market audience lists.<\/p>\n\n The values are hashed with the same SHA-256 normalization used by both Google Ads Customer Match and Meta Ads Custom Audiences, so the same file can also be uploaded manually to Meta Ads Manager (see FAQ).<\/p>\n\n Why this export?<\/strong>\nNot all purchases are captured by Google Ads tracking; periodic uploads of Customer Match lists<\/strong> help targeting and campaign performance. Even Google's automatic conversion-based customer lists<\/strong> (auto-enabled for eligible accounts from August 2026) only contain tag-tracked conversions \u2014 this plugin exports from the order database itself, so ad-blocked, phone, offline and historical orders are included too (see FAQ). The export reflects your order database as-is \u2014 applying your store's consent choices and legal requirements to it is your responsibility as the merchant (see the GDPR \/ privacy FAQ).<\/p>\n\n Why per-country files?<\/strong>\nMarketing teams optimize Google Ads campaigns per country. Mixing a German audience into a Romanian campaign's match list pollutes the targeting. This plugin keeps each market in its own file.<\/p>\n\n WooCommerce \u2192 Marketing \u2192 Customer Match List<\/strong>.<\/p>\n\n From there you can:<\/p>\n\n Marketing teams optimize Google Ads campaigns per country. Mixing audiences degrades match-rate signals and wastes budget on irrelevant impressions. Each country file is independent and can be wired into its own Customer Match list. Google's Data Manager pulls each URL on its own schedule, so you can refresh some markets without affecting others.<\/p><\/dd>\n Yes. On the Settings<\/strong> tab, tick Also offer one file with every country<\/strong>. The Feeds<\/strong> tab then lists an extra URL ending in In Google Ads \u2192 Tools<\/strong> \u2192 Shared library<\/strong> \u2192 Audience manager<\/strong>, click + Create remarketing list<\/strong> \u2192 + Customer list<\/strong> and connect the HTTPS<\/strong> data source (step by step under \"How do I add value segment URLs in Google Ads?\" below; country URLs work the same way). Paste the country-specific URL from the plugin's admin page. Google Ads fetches the file on its own cadence; our plugin keeps the file fresh per the schedule you picked.<\/p><\/dd>\n Yes \u2014 they complement each other. In 2026 Google began automatically enrolling accounts that use both Enhanced Conversions and Customer Match into conversion-based customer lists<\/strong> (enrollment emails went out from June 2026; data processing starts August 18, 2026). Those lists are built solely from what the Google Ads tag captures on your site from that point on: customers using ad blockers or declining your consent banner never enter them, and neither do phone, imported, or historical orders.<\/p>\n\n This plugin builds Customer Match lists from the WooCommerce order database<\/strong> instead \u2014 every completed order, including full order history via backfill, split into one file per country, with a mailing-address fallback when an order has no email or phone. Keep both: attach the automatic conversion-based lists and the per-country lists this plugin feeds, and Google deduplicates matched customers on its side.<\/p><\/dd>\n Yes. Meta Ads Custom Audiences use the same SHA-256 hashing of normalized (trimmed, lowercased) values, so a country CSV can be uploaded to Meta Ads Manager as a customer list \u2014 map the columns in Meta's upload screen. Note that Meta does not pull files from URLs; the pull-from-URL workflow is Google-specific, so on Meta use manual upload.<\/p><\/dd>\n Roughly 10 seconds per 150,000\u2013200,000 orders on typical hardware. The query path is direct SQL against It shouldn't happen, since WooCommerce billing and shipping addresses are country-based, but if it does, the order is skipped. There is no correct file to route them to, and Google's per-country Customer Match campaigns can't use them anyway. The same applies to orders with an invalid country code.<\/p><\/dd>\n They get written. Google Customer Match accepts a row with any one<\/strong> of: email, phone, or full mailing address (first name + last name + zip). The plugin includes a row as long as one of those identifiers is present alongside a valid country. Deduplication is still single-column: it uses email when available, otherwise phone, otherwise the mailing address.<\/p>\n\n Google handles cross-identifier deduplication on its side after matching to a Google account \u2014 so a customer who orders once with email + phone and again with only their phone will appear as two rows in the CSV but as one user in your Customer Match audience.<\/p><\/dd>\n Yes \u2014 but only if they actually ordered from multiple countries!<\/p><\/dd>\n This is by design, as every To regenerate everything from scratch (for example after toggling debug mode), click Tools \u2192 Rebuild now<\/strong> or run Your site uses plain permalinks (Settings \u2192 Permalinks \u2192 Plain<\/strong>), so WordPress builds REST URLs with a query string. Google Ads rejects feed URLs with a query string, and the plugin shows a warning at the top of its page and on the Health<\/strong> tab. Pick any other permalink structure; the URLs then end in Some security plugins (\"Admin and Site Enhancements\" \/ ASE has this option, Disable REST API, etc.) block all unauthenticated REST traffic. This plugin does not<\/strong> attempt to override those policies \u2014 that would be hostile to the security setting you deliberately chose.<\/p>\n\n If you hit this error, whitelist the plugin's feed prefix in your security plugin's exclusion list: For most countries (RO, DE, UK, FR, ES, US, NL, BE, PT, IT mobile, \u2026) it's correct. The routine accepts A number typed without There is a known limitation for Italian landlines<\/strong>: in Italy the leading If you need strict accuracy across all locales, swap WordPress's built-in cron is request-triggered: it only fires if someone hits the site. On low-traffic stores it may drift. For predictable runs, configure a real system cron that calls Yes. Add the Yes. The plugin declares The plugin makes no requests to third-party services<\/strong> \u2014 no analytics, no tracking pixels, no telemetry. All processing happens on your WordPress install. (The directory-listing safety check is a one-second request from your server to its own uploads URL \u2014 see the directory-listing FAQ.)<\/p>\n\n However, the whole point of the workflow is that Google Ads (or any other consumer you configure) will pull the CSV from your site<\/strong> at the tokenized URL. Anyone in possession of that URL can retrieve a file containing:<\/p>\n\n A value segment URL also shows that each customer in it belongs to that spend group (for example your top 10% by spend).<\/p>\n\n Treat the tokenized URLs as secrets. If one leaks, use Reset token<\/strong> in the admin (or .csv<\/code> and hashing normalization was corrected \u2014 run "Delete all files & reset dedup", then re-run the backfill.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3609357,"resolution":"256x256","location":"assets","locale":"","width":500,"height":500},"icon.svg":{"filename":"icon.svg","revision":3609357,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3609357,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3609357,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3757388,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"meta\":{\"title\":\"CMLS - Customer Match List for Google Ads & Meta Ads\",\"description\":\"A WooCommerce store with sample orders in four countries, the plugin active and its customer lists already built.\",\"author\":\"rwky\",\"categories\":[\"WooCommerce\",\"Marketing\"]},\"landingPage\":\"\\\/wp-admin\\\/admin.php?page=cmls-settings\",\"preferredVersions\":{\"php\":\"8.3\",\"wp\":\"latest\"},\"features\":{\"networking\":true},\"login\":true,\"steps\":[{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"woocommerce\"},\"options\":{\"activate\":true}},{\"step\":\"setSiteOptions\",\"options\":{\"blogname\":\"Demo Store\",\"woocommerce_default_country\":\"US:CA\",\"woocommerce_currency\":\"USD\",\"woocommerce_coming_soon\":\"no\",\"woocommerce_task_list_hidden\":\"yes\",\"woocommerce_onboarding_profile\":{\"skipped\":true}}},{\"step\":\"runPHP\",\"code\":\"set_permalink_structure( '\\\/%postname%\\\/' );\\n$wp_rewrite->flush_rules( false );\\ndelete_transient( '_wc_activation_redirect' );\\nadd_filter( 'pre_wp_mail', '__return_false' );\\n\\n$orders = array(\\n\\tarray( 'emma.johnson@example.com', 'Emma', 'Johnson', '(415) 555-0132', 'US', '94103', 'completed', 12, 184.50 ),\\n\\tarray( 'emma.johnson@example.com', 'Emma', 'Johnson', '(415) 555-0132', 'US', '94103', 'completed', 200, 96.00 ),\\n\\tarray( 'liam.smith@example.com', 'Liam', 'Smith', '(212) 555-0198', 'US', '10001', 'completed', 45, 92.00 ),\\n\\tarray( 'olivia.brown@example.com', 'Olivia', 'Brown', '', 'US', '60601-1234', 'completed', 130, 310.00 ),\\n\\tarray( 'noah.davis@example.com', 'Noah', 'Davis', '(305) 555-0147', 'US', '33101', 'processing', 1, 58.90 ),\\n\\tarray( 'ava.miller@example.com', 'Ava', 'Miller', '(206) 555-0110', 'US', '98101', 'completed', 700, 140.00 ),\\n\\tarray( 'oliver.taylor@example.co.uk', 'Oliver', 'Taylor', '020 7946 0958', 'GB', 'SW1A 1AA', 'completed', 30, 75.00 ),\\n\\tarray( 'amelia.wilson@example.co.uk', 'Amelia', 'Wilson', '07700 900123', 'GB', 'M1 1AE', 'completed', 400, 220.00 ),\\n\\tarray( 'lukas.mueller@example.de', 'Lukas', 'M\\u00fcller', '030 901820', 'DE', '10115', 'completed', 20, 129.00 ),\\n\\tarray( 'sophie.schmidt@example.de', 'Sophie', 'Schmidt', '', 'DE', '80331', 'completed', 90, 64.50 ),\\n\\tarray( 'andrei.popescu@example.ro', 'Andrei', 'Popescu', '0721 234 567', 'RO', '010011', 'completed', 8, 260.00 ),\\n\\tarray( 'maria.ionescu@example.ro', 'Maria', 'Ionescu', '0745 678 901', 'RO', '400001', 'completed', 60, 88.00 ),\\n);\\n\\nforeach ( $orders as $o ) {\\n\\t$order = new WC_Order();\\n\\t$order->set_billing_email( $o[0] );\\n\\t$order->set_billing_first_name( $o[1] );\\n\\t$order->set_billing_last_name( $o[2] );\\n\\t$order->set_billing_phone( $o[3] );\\n\\t$order->set_billing_country( $o[4] );\\n\\t$order->set_billing_postcode( $o[5] );\\n\\t$order->set_date_created( time() - $o[7] * DAY_IN_SECONDS );\\n\\t$order->set_total( $o[8] );\\n\\t$order->set_status( $o[6] );\\n\\t$order->save();\\n}\\n\"},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"customer-match-list-google-ads\"},\"options\":{\"activate\":true}},{\"step\":\"wp-cli\",\"command\":\"wp cmls rebuild\"}]}"}},"all_blocks":[],"tagged_versions":["1.1.1","1.1.2","2.0.0","2.1.0","2.1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3757067,"resolution":"1","location":"assets","locale":"","width":1241,"height":1063},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3757067,"resolution":"2","location":"assets","locale":"","width":1354,"height":970},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3757067,"resolution":"3","location":"assets","locale":"","width":1331,"height":1270},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3757067,"resolution":"4","location":"assets","locale":"","width":1441,"height":1206},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3757067,"resolution":"5","location":"assets","locale":"","width":1297,"height":822}},"screenshots":{"1":"Feeds: the status (audience window, last and next run, storage folder) and one feed URL per country for your Google Ads customer lists, plus the optional all-countries URL.","2":"Settings: how often new orders are added, the audience window, the order statuses to export and the all-countries file.","3":"Value segments: lists of your best customers by spend, number of orders and last order date, each with its own URL.","4":"Health: checks for the feed URLs, schedule, file writes, storage, directory listing, nightly rebuild, hashing and list sizes, with the rows counted in every file.","5":"Tools: Update now, Rebuild now, the one-time backfill, and the danger zone (reset the token, delete the files)."}},"plugin_section":[],"plugin_tags":[271878,271475,985,239143,286],"plugin_category":[45,55],"plugin_contributors":[97974],"plugin_business_model":[],"class_list":["post-318548","plugin","type-plugin","status-publish","hentry","plugin_tags-cmls","plugin_tags-customer-match","plugin_tags-google-ads","plugin_tags-meta-ads","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_category-seo-and-marketing","plugin_contributors-rwky","plugin_committers-rwky"],"banners":{"banner":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/banner-772x250.png?rev=3609357","banner_2x":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/banner-1544x500.png?rev=3609357","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/icon.svg?rev=3609357","icon":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/icon.svg?rev=3609357","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/screenshot-1.png?rev=3757067","caption":"Feeds: the status (audience window, last and next run, storage folder) and one feed URL per country for your Google Ads customer lists, plus the optional all-countries URL."},{"src":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/screenshot-2.png?rev=3757067","caption":"Settings: how often new orders are added, the audience window, the order statuses to export and the all-countries file."},{"src":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/screenshot-3.png?rev=3757067","caption":"Value segments: lists of your best customers by spend, number of orders and last order date, each with its own URL."},{"src":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/screenshot-4.png?rev=3757067","caption":"Health: checks for the feed URLs, schedule, file writes, storage, directory listing, nightly rebuild, hashing and list sizes, with the rows counted in every file."},{"src":"https:\/\/ps.w.org\/customer-match-list-google-ads\/assets\/screenshot-5.png?rev=3757067","caption":"Tools: Update now, Rebuild now, the one-time backfill, and the danger zone (reset the token, delete the files)."}],"raw_content":"\nHow it works<\/h4>\n\n
\n
Features<\/h4>\n\n
\n
--days=N<\/code>, --since<\/code>, --until<\/code>), dry-run, and batch-size control.<\/li>\nEmail, Phone, First Name, Last Name, Country, Zip<\/code>.<\/li>\n+<\/code> \u2014 the same hashing Meta Ads Custom Audiences accept.<\/li>\nwp-content\/uploads\/customer-match-list-google-ads\/<\/code> with filenames containing a 64-bit hash derived from the token, behind a deny-all .htaccess<\/code> on Apache.<\/li>\nnocache_headers()<\/code>.<\/li>\nJOIN<\/code> on wc_orders<\/code> + wc_order_addresses<\/code> (or posts<\/code>+postmeta<\/code> on classic). Designed for stores with tens of millions of orders.<\/strong><\/li>\n<\/ul>\n\nAdmin Dashboard Settings<\/h4>\n\n
\n
WP-CLI<\/h4>\n\n
\n
wp cmls rebuild<\/code> (or wp cmls rebuild-now<\/code>) \u2014 rebuilds every file from the orders inside the audience window and swaps them in, in the same process (no PHP time limit). Same result as the nightly rebuild and Tools \u2192 Rebuild now<\/strong>.<\/li>\nwp cmls backfill<\/code> \u2014 one-time backfill of historical orders, split by country. Flags: --statuses=processing,completed<\/code> (defaults to the statuses saved in the settings), --all-statuses<\/code>, --days=N<\/code>, --since=YYYY-MM-DD<\/code>, --until=YYYY-MM-DD<\/code>, --dry-run<\/code>, --batch-size=5000<\/code>, --force<\/code>. The next rebuild goes back to the saved window and statuses.<\/li>\nwp cmls update-now<\/code> (or wp cmls run-now<\/code>) \u2014 appends orders placed since the last run, right away. Same code path as the scheduled cron and Tools \u2192 Update now<\/strong>.<\/li>\nwp cmls status<\/code> \u2014 prints a table with one row per country (row count, file size, URL) and the all-countries URL when it's on, then the audience window, statuses and rebuild times.<\/li>\nwp cmls reset-token<\/code> \u2014 regenerates the token and renames every file to match. If a file can't be renamed, nothing changes and the command fails.<\/li>\nwp cmls delete-file<\/code> \u2014 deletes every country CSV and truncates the dedup table.<\/li>\n<\/ul>\n\n\n\n
wp-content\/plugins\/customer-match-list-google-ads<\/code> (or install from the WordPress.org repository).<\/li>\n\n
wp cmls rebuild<\/code>.<\/li>\n<\/ul><\/li>\n\n
Why one file per country?<\/h3><\/dt>\n
Can I get one file with every country?<\/h3><\/dt>\n
\/all.csv<\/code>, after the country URLs. It holds the rows of every country file together, under one header, so it's always in step with them. A customer who ordered from two countries appears once per country, as in the country files.<\/p><\/dd>\nHow do I create a Google Ads customer list from a feed URL?<\/h3><\/dt>\n
Google says it's turning on \"conversion-based customer lists\" \u2014 do I still need this plugin?<\/h3><\/dt>\n
Does the file work with Meta (Facebook) Ads?<\/h3><\/dt>\n
How long does the backfill take?<\/h3><\/dt>\n
wc_orders<\/code> + wc_order_addresses<\/code> (HPOS).\nFor 1M+ orders the CLI is still the most reliable option because no PHP\/web timeout applies; the admin Action-Scheduler-backed runner also handles 1M+ but each batch must complete within the host's PHP limit and if it does not then it won't finish.<\/p><\/dd>\nWhat happens to orders with no billing country?<\/h3><\/dt>\n
What about orders with no email?<\/h3><\/dt>\n
Will the same customer appear in multiple country files?<\/h3><\/dt>\n
I ran the backfill twice \u2014 why didn't it write more rows the second time?<\/h3><\/dt>\n
(email, country)<\/code> pair is recorded the first time it's seen and never re-written.<\/p>\n\nwp cmls rebuild<\/code>. The rebuild starts from empty files and swaps them in when it's done; the URLs stay the same.<\/p><\/dd>\nThe feed URL contains \"?rest_route=\"<\/h3><\/dt>\n
.csv<\/code>. Update the URLs in Google Ads afterwards.<\/p><\/dd>\nI get a 401 \"REST API has been restricted to authenticated users\" when I open the URL<\/h3><\/dt>\n
\/wp-json\/cmls\/v1\/feed\/<\/code>. Google Ads (and any other configured consumer) needs unauthenticated GET access to that prefix \u2014 the tokenized URL is the sole authentication mechanism.<\/p><\/dd>\nPhone numbers \u2014 how reliable is the normalization without libphonenumber?<\/h3><\/dt>\n
+<\/code>, 00<\/code>, the country's national trunk 0<\/code>, and bare national numbers (using the order's billing country to fill in the dialing code).<\/p>\n\n+<\/code> or 00<\/code> but starting with the dialing code's digits is read as already international. For countries whose numbers have a fixed length (India, Brazil, Norway, Poland, Singapore, Kazakhstan and 29 more) the plugin checks the length first, so an Indian mobile like 9123456789<\/code> becomes +919123456789<\/code>, not +9123456789<\/code>. Countries with variable-length numbers (Germany, Austria, Italy, Finland, \u2026) keep the simpler rule.<\/p>\n\n0<\/code> is part of the national number, not a trunk prefix, so the routine may strip a digit it shouldn't. Italian mobile numbers (3xx) are fine.<\/p>\n\nCMLS_Writer::normalize_phone()<\/code> for a libphonenumber-based implementation.<\/strong><\/p><\/dd>\nIs WP-Cron reliable enough for the incremental updates?<\/h3><\/dt>\n
wp-cron.php<\/code> every minute \u2014 standard WordPress practice and recommendation.<\/p><\/dd>\nCan I disable hashing for debugging?<\/h3><\/dt>\n
CMLS_DISABLE_HASHING<\/code> define to wp-config.php<\/code>:<\/p>\n\ndefine( 'CMLS_DISABLE_HASHING', true );\n<\/code><\/pre><\/dd>\nDoes this support High-Performance Order Storage (HPOS) \/ Legacy Postmeta?<\/h3><\/dt>\n
custom_order_tables<\/code> compatibility and queries wc_orders<\/code> + wc_order_addresses<\/code> directly when HPOS is enabled. On classic (postmeta) storage it falls back to wp_posts<\/code> + wp_postmeta<\/code> with a single conditional-aggregation query per batch.<\/p><\/dd>\nDoes the plugin send any data outside my server?<\/h3><\/dt>\n
\n
wp cmls reset-token<\/code>) to invalidate all existing URLs and rename the files on disk. See the site's Privacy Policy page \u2014 this plugin registers suggested policy text via WordPress's Privacy tool.<\/p><\/dd>\n