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
Keep analytics events and product observations distinct field map
Field / stepInputRule
Source recordProduct and variant identifiersKeep identity as strings.
Event timeYour authorized event streamKeep separate from retrieval time.
Evidencesource_url + retrieved_atKeep 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.

Continue this workflow