Retrospective Update
This article explains how Replication handles retrospective data updates for delayed conversion tracking (attribution window) in advertising connectors.
Context
Advertising connectors (Facebook Ads, Google Ads, LinkedIn Ads, TikTok Ads, X Ads, Microsoft Ads, etc.) operate a concept called the conversion or attribution window. Attribution window is the period between the user's first contact with an advertisement and the target action, such as purchase of a product, filling out a form on the site, etc. Usually, an advertiser sets this period at the ad level.
For example, the advertiser sets the attribution window to 30 days. If a user sees the ad on May 1st and makes a purchase on May 10th, then the advertising platform attributes this purchase to the advertisement display on May 1st.
Problem
Data sources APIs do not provide any markers that indicate about the delayed conversions. If Skyvia pulls ad statistics for May 1st on May 2nd, and a conversion occurs on May 10th, a standard Incremental Replication will miss this update because it only looks for newly modified records from the current date.
Solution
To solve this problem, we added the Attribution Window parameter to the Advanced Settings of the supported advertising connectors. Users can manually specify the attribution window or use the default value. Replication uses this value to refresh data for reporting objects that support retrospective updates.
Specifics
-
Retrospective update works for New Replication Runtime only. It doesn't work for obsolete integrations.
-
Only Incremental Replication with the set LastSyncTime parameter supports Retrospective Update.
-
Only the report objects are affected by this feature.
-
A field that contains the report date must be selected for replication. Otherwise, the Retrospective Update will not work.
-
Connector-specific details of the Retrospective update are available in the connectors' topics.
Connectors
Skyvia supports the Retrospective Update for the following connectors.
| Connectorm | Default Attribution Window | Required Report Date Field | Supported Objects |
|---|---|---|---|
| Facebook Ads | Max value between Click Attribution Window and View Attribution Window | DateStart | Daily, Monthly reports |
| Google Ads | 30 Days | Segments_Date | Objects with *Report or *View suffix in their names |
| LinkedIn Ads | 30 Days | Date | Daily reports and statistics |
| X Ads | 30 Days | Date | Daily reports |
| TikTok Ads | 28 Days | Date | Daily reports |
| Microsoft Ads | 30 Days | Date | Daily and Monthly reports |
| Google Analytics v4 | 0 Days | Date | CompleteAnalytics |