docs, model updates, add tests, add documentation

[fivetran-reneeli]

PR Overview

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

This PR will result in the following new package version:

v0.4.0

breaking change to users who weren't bringing in conversion metrics already through the passthrough variable.

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

Feature update: Conversions Support

• We have added conversion metrics to the end models.

• The conversion metrics are the following:

  • purchases_30_d: Number of attributed conversion events occurring within 30 days of an ad click.
  • sales_30_d: Total value of sales occurring within 30 days of an ad click.

• 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.

Under the Hood

• Created amazon_ads_persist_pass_through_columns macro to ensure that the new conversion fields are backwards compatible with users who have already included them via passthrough fields.
• Added integrity and consistency validation tests within integration_tests folder for the transformation models (to be used by maintainers only).

PR Checklist

Basic Validation

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

• dbt run –full-refresh && dbt test
• 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:

Validation tests passing

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

💃

[fivetran-joemarkiewicz]

LGTM

[fivetran-joemarkiewicz]

Reminder to swap before release