[Feature] Add conversion metrics

[fivetran-avinash]

PR Overview

This PR will address the following Issue/Feature: Add conversion metrics

This PR will result in the following new package version: v0.6.0

We are changing the data type of one field, and customers bringing in the new conversion fields previously via passthrough columns will experience errors if they don't update.

Please provide the finalized CHANGELOG entry which details the relevant changes included in this PR:

Feature Updates: Conversion Support!

• We have added the following source fields to each stg_tiktok_ads__<entity>_report_history model (ad, ad_group, campaign):
  • real_time_conversion: Number of times your ad resulted in the optimization event you selected.
  • total_purchase_value: The total value of purchase events that occurred in your app that were recorded by your measurement partner.
  • total_sales_lead_value: The monetary worth or potential value assigned to a lead generated through ads.
• In the event that you were already passing the above fields in via our passthrough columns, the package will dynamically avoid "duplicate column" errors.

The above new field additions are breaking changes for users who were not already bringing in conversion fields via passthrough columns.

Breaking Changes

• Update conversion to be an integer rather than a numeric data type, as is the expected behavior of the field.

Under the Hood

• Created tiktok_ads_fill_pass_through_columns and tiktok_ads_add_pass_through_columns macros to ensure that the new conversion fields are backwards compatible with users who have already included them via passthrough fields.

Contributors

• Seer Interactive

PR Checklist

Basic Validation

Please acknowledge that you have successfully performed the following commands locally:

• dbt run –full-refresh && dbt test
• [NA] dbt run (if incremental models are present) && dbt test

Before marking this PR as "ready for review" the following have been applied:

• [NA] The appropriate issue has been linked, tagged, and properly assigned
• All necessary documentation and version upgrades have been applied
• docs were regenerated (unless this PR does not include any code or yml updates)
• BuildKite integration tests are passing
• Detailed validation steps have been provided below

Detailed Validation

Please share any and all of your validation steps:

Ran successfully both with and without passthrough columns

If you had to summarize this PR in an emoji, which would it be?

🕐

[fivetran-joemarkiewicz]

LGTM