Extraction guide
Keep analytics events and product observations distinct
A manual handoff recipe to adapt in your own environment.
01 / INPUTMerchant events + source product records
02 / YOUR WORKFLOWMap fields → inspect → hand off
03 / OUTPUTA documented measurement join
Keep the right fields.
Manual data handoff| Field / step | Input | Rule |
|---|---|---|
| Source record | Product and variant identifiers | Keep identity as strings. |
| Event time | Your authorized event stream | Keep separate from retrieval time. |
| Evidence | source_url + retrieved_at | Keep the original observation attached. |
Before you use the output
External prices are observations; they do not measure your visitors or conversions.
Check one record first.
Start with the smallest useful scope. Compare the returned record with its source, confirm variant identity and inspect missing fields before applying the mapping to a larger dataset.
Keep extraction warnings and the retrieval timestamp with downstream output. When a required field is missing, leave it unresolved or return to the source; do not fill it from an assumption.