Jump to a popular page, or start typing.

    CONNECTIONS / Clickhouse / ClickHouse to Meta Offline CAPI

    From ClickHouse tables to Meta's offline optimization.

    Signals reads your ClickHouse tables through a read-only database user scoped to the ClickHouse tables you name, then credits dealer, branch, and phone sales to the Meta campaigns behind them so Meta sees offline conversions without an export.

    clickhouse -> meta-offline-capi :: live

    1. ● clickhouse → meta.capi :: live
    2. > read closed_deals rows=13,271
    3. hash sha256(email,phone) consent=filtered
    4. route meta deliver
    5. ✓ delivered · 11,811 matched

    WHAT THIS ENABLES

    ClickHouse to Meta Offline CAPI

    Meta Offline CAPI for ClickHouse: Signals credits dealer, branch, and phone sales to the Meta campaigns behind them straight from your ClickHouse tables, hashed and consent-screened each time the read runs.

    • Signals credits dealer, branch, and phone sales to the Meta campaigns behind them, reading your ClickHouse tables each time the read runs.
    • Campaign learning fed by real-world purchases, with no export step out of your ClickHouse tables.
    WHAT FLOWS WHERE

    The click, the conversion, and the credit.

    The conversion happens off Meta, away from any pixel. Here is how Clickhouse closes the loop.

    Meta credits the campaign that sourced the conversion conversion happens off-platform Ad click on Meta Scheduled read sync recorded in Clickhouse S Signals hash · dedupe Offline Conversions API delivered · credited
    WHO THIS IS FOR

    Built for the teams that own the number.

    Considered-purchase brands closing revenue far from the browser, working out of ClickHouse tables and materialized views.

    Analytics engineers on ClickHouse who need in-store and phone revenue joining Meta's optimization loop out of ClickHouse tables.

    HOW DATAHASH SETS IT UP

    From kickoff to verified events.

    1. Connect

      A read-only database user scoped to the ClickHouse tables you name, mapped to Meta's Offline Conversions API and tuned for Meta's 62-day event window.

    2. Map

      Columns from your ClickHouse tables align to Meta's Offline Conversions API in the visual mapper, hashed as the read runs and checked for Meta's 62-day event window.

    3. Deliver

      Each time the read runs, Signals reads your ClickHouse tables and credits dealer, branch, and phone sales to the Meta campaigns behind them, reads only the records changed since the last run, with Meta's 62-day event window watched in the debugger.

    WHAT YOU GET

    What changes when the CSV goes away.

    Capability Manual CSV upload Datahash
    Reporting Offline sales sit in a separate export, reconciled by hand. Revenue counted in the same Offline CAPI reporting as web conversions.
    Deduplication A re-uploaded file risks counting the same conversion twice. Deduped delivery, so a resent record never counts as a second conversion.
    Match visibility Match quality is a guess until the numbers look off. Match rate reported per upload, tied to the source event set that produced it.
    Effort and latency An analyst exports and uploads on a manual cadence. Server-side and automatic the moment Clickhouse records the event.
    ON THE WIRE

    What Offline CAPI actually receives.

    signals :: clickhouse.meta-offline-capi :: wire

    1. ● signals :: event payload
    2. > POST /offline_conversions source=clickhouse.closed_deals
    3. event_name "Purchase" · event_time 2026-07-23T00:53:51
    4. value 43091.00 · currency SAR
    5. em sha256 "1fa603…" · ph sha256 "eb2201…" · external_id "txn-53031"
    6. ✓ accepted match=89%
    FAQ

    Asked on almost every call.

    How often does the ClickHouse Meta Offline CAPI sync run?

    The pace follows your ClickHouse tables: Signals sends changes from ClickHouse to Meta each time the read runs. Because it reads only the records changed since the last run, in-store and phone revenue joining Meta's optimization loop stays current while analytics engineers on ClickHouse keep Meta's 62-day event window in view. Delivery needs no export and no manual upload.

    What match rate should a ClickHouse-sourced Meta Offline CAPI batch expect?

    In ClickHouse, match rate tracks the email and phone quality your ClickHouse tables carry. Clean identifiers land for Meta; blank ones never will. The first Offline Conversions API report shows analytics engineers on ClickHouse where Meta's 62-day event window needs work, a data-quality task handled in ClickHouse.

    NEXT STEP

    ClickHouse to Meta Offline CAPI, in production this week.