Fold in conversion metrics from upstream releases (#122)

* things are working locally with _c aliases

* stuff is working locally across models and packages

* bk

* bk seeds

* readme

* docs and tests

* postgres

* qupte cols

* will all these passthrough columns work in bk?

* bk

* Try this

* Update packages.yml

Co-authored-by: Joe Markiewicz <[email protected]>

* docs

---------

Co-authored-by: Joe Markiewicz <[email protected]>

CHANGELOG.md

@@ -1,3 +1,27 @@
+# dbt_ad_reporting v1.10.0
+
+[PR #122](https://github.com/fivetran/dbt_ad_reporting/pull/122) introduces the following **BREAKING CHANGES:**
+
+## Feature Updates: Native Conversion Support
+- Added `conversions` and `conversions_value` fields to each Ad Reporting end model.
+  - **BREAKING**: In the event that you were already including conversions through [passthrough variables](https://github.com/fivetran/dbt_ad_reporting?tab=readme-ov-file#adding-custom-metrics-to-final-reports) and called your field(s) `conversions` and/or `conversions_value`, your old fields will still be included, but they will be suffixed with a `_c`, while the new default conversion fields will take precedence as `conversions` and `conversions_value`
+  - For some platforms, conversions data is sent along with the type of event the metrics are attributed to (ie purchases, leads, sign ups). We have largely chosen to consider **purchases, leads, and custom-defined** events to be conversions. However, you may configure this at each individual platform level for the following packages:
+
+| Platform    | Variable | Default Values | How to Use |
+| ------------ | ----------- | -------- | ---------- |
+| Facebook Ads    | `facebook_ads__conversion_action_types`    |  `offsite_conversion.fb_pixel_custom` + `offsite_conversion.fb_pixel_lead` + `onsite_conversion.lead_grouped` + `offsite_conversion.fb_pixel_purchase` + `onsite_conversion.purchase` | [Configuring Conversion Action Types](https://github.com/fivetran/dbt_facebook_ads?tab=readme-ov-file#configuring-conversion-action-types) |
+| LinkedIn Ad Analytics   | `linkedin_ads__conversion_fields`   | `external_website_conversions` + `one_click_leads` | [Adding in Conversion Fields](https://github.com/fivetran/dbt_linkedin?tab=readme-ov-file#adding-in-conversion-fields-variable) |
+| Reddit Ads      | `reddit_ads__conversion_event_types` | `lead` + `purchase` + `custom` | [Configure Conversion Event Types](https://github.com/fivetran/dbt_reddit_ads?tab=readme-ov-file#configure-conversion-event-types) |
+| Snapchat Ads    | `snapchat_ads__conversion_fields`    | `conversion_purchases` | [Configuring Conversion Fields](https://github.com/fivetran/dbt_snapchat_ads?tab=readme-ov-file#configuring-conversion-fields) |
+| Twitter Ads     | `twitter_ads__conversion_fields` AND `twitter_ads__conversion_sale_amount_fields` | `conversion_purchases_metric` + `conversion_custom_metric` AND `conversion_purchases_sale_amount` + `conversion_custom_sale_amount` | [Customizing Types of Conversions](https://github.com/fivetran/dbt_twitter?tab=readme-ov-file#customizing-types-of-conversions) |
+
+## Under the Hood
+- Created data validation tests to be used by package maintainers to verify this and future releases.
+
+## Contributors
+- [Seer Interactive](https://www.seerinteractive.com/?utm_campaign=Fivetran%20%7C%20Models&utm_source=Fivetran&utm_medium=Fivetran%20Documentation)
+- [@fivetran-poonamagate](https://github.com/fivetran-poonamagate) ([PR #59](https://github.com/fivetran/dbt_google_ads_source/pull/59))
+
 # dbt_ad_reporting v1.9.0
 
 ## Under the Hood

dbt_project.yml

@@ -1,5 +1,5 @@
 name: 'ad_reporting'
-version: '1.9.0'
+version: '1.10.0'
 
 config-version: 2