data-dwh-dbt-project/models/reporting/kpis/schema.yml

version: 2

models:
  - name: kpis__product_guest_daily_metrics
    description: |
      This model computes the Daily Guest Metrics at the deepest granularity.
      Here all metrics are attributed to the Check-in Date of the associated
      booking, except for payments which are attributed to payment date.

      The unique key corresponds to the deepest granularity of the model,
      in this case: 
      - date_day,
      - py_date_day,
      - id_deal,
      - has_id_check,
      - main_billing_country_iso_3_per_deal.

    tests:
      - dbt_utils.unique_combination_of_columns:
          combination_of_columns:
            - date_day
            - py_date_day
            - has_payment
            - has_id_check
            - main_billing_country_iso_3_per_deal
    columns:
      - name: date_day
        data_type: date
        description: "Date of when Guest Journeys have been completed."
        tests:
          - not_null

      - name: date_week
        data_type: string
        description: "Week number of when Guest Journeys have been completed."
        tests:
          - not_null

      - name: py_date_day
        data_type: date
        description: |
          Date on the previous year of when Guest Journeys have been completed.
          Note that this date can be NULL for leap days (29th February)

      - name: has_payment
        data_type: string
        description: Has there been any guest payments on the guest journey.
        tests:
          - not_null
          - accepted_values:
              values:
                - W/O Payment
                - With Payment

      - name: has_id_check
        data_type: string
        description: Does the verification in the guest journey
          includes Government Id Check for the bookings.
        tests:
          - not_null
          - accepted_values:
              values:
                - W/O Id Check
                - With Id Check

      - name: main_billing_country_iso_3_per_deal
        data_type: string
        description: |
          Main billing country of the host.
        tests:
          - not_null

      - name: created_guest_journeys_not_cancelled
        data_type: bigint
        description: |
          Count of daily guest journeys created, excluding cancelled bookings,
          in a given date and per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: created_guest_journeys_not_cancelled
              date_column: date_day

      - name: started_guest_journeys_not_cancelled
        data_type: bigint
        description: |
          Count of daily guest journeys started, excluding cancelled bookings, 
          in a given date and per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: started_guest_journeys_not_cancelled
              date_column: date_day

      - name: completed_guest_journeys_not_cancelled
        data_type: bigint
        description: |
          Count of daily guest journeys completed, excluding cancelled bookings,
          in a given date and per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: completed_guest_journeys_not_cancelled
              date_column: date_day

      - name: created_guest_journeys
        data_type: bigint
        description: |
          Count of daily guest journeys created in a given date and
           per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: created_guest_journeys
              date_column: date_day

      - name: started_guest_journeys
        data_type: bigint
        description: |
          Count of daily guest journeys started in a given date and
           per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: started_guest_journeys
              date_column: date_day

      - name: completed_guest_journeys
        data_type: bigint
        description: |
          Count of daily guest journeys completed in a given date and
           per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: completed_guest_journeys
              date_column: date_day

      - name: total_csat_score_count
        data_type: bigint
        description: |
          Count of daily guest journeys with CSAT (customer satisfaction score)
          in a given date and per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: total_csat_score_count
              date_column: date_day

      - name: average_csat_score
        data_type: bigint
        description: |
          Average daily CSAT score in a given date and per specified dimension.

      - name: deposit_fees_in_gbp
        data_type: decimal
        description: |
          Sum of deposit fees paid by guests, without taxes, in GBP 
          in a given date and per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: deposit_fees_in_gbp
              date_column: date_day

      - name: waiver_payments_in_gbp
        data_type: decimal
        description: |
          Sum of waiver payments paid by guests, without taxes, in GBP
          in a given date and per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: waiver_payments_in_gbp
              date_column: date_day

      - name: checkin_cover_fees_in_gbp
        data_type: decimal
        description: |
          Sum of checkin cover fees paid by guests, without taxes, in GBP
          in a given date and per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: checkin_cover_fees_in_gbp
              date_column: date_day

      - name: total_guest_payments_in_gbp
        data_type: decimal
        description: |
          Sum of total payments paid by guests, without taxes, in GBP
          in a given date and per specified dimension.
        tests:
          - kpis_daily_outlier_detector:
              column_name: total_guest_payments_in_gbp
              date_column: date_day

      - name: py_created_guest_journeys_not_cancelled
        data_type: bigint
        description: |
          Count of daily guest journeys created (excluding canceled bookings) 
          on the same date in the previous year, segmented by the specified dimension.

      - name: py_started_guest_journeys_not_cancelled
        data_type: bigint
        description: |
          Count of daily guest journeys started (excluding canceled bookings) 
          on the same date in the previous year, segmented by the specified dimension.

      - name: py_completed_guest_journeys_not_cancelled
        data_type: bigint
        description: |
          Count of daily guest journeys completed (excluding canceled bookings) 
          on the same date in the previous year, segmented by the specified dimension.

      - name: py_created_guest_journeys
        data_type: bigint
        description: |
          Count of daily guest journeys created on the same date in the previous year, 
          segmented by the specified dimension.

      - name: py_started_guest_journeys
        data_type: bigint
        description: |
          Count of daily guest journeys started on the same date in the previous year, 
          segmented by the specified dimension.

      - name: py_completed_guest_journeys
        data_type: bigint
        description: |
          Count of daily guest journeys completed on the same date in the previous year, 
          segmented by the specified dimension.

      - name: py_total_csat_score_count
        data_type: bigint
        description: |
          Count of daily guest journeys with CSAT (customer satisfaction score) 
          on the same date in the previous year, segmented by the specified dimension.

      - name: py_average_csat_score
        data_type: bigint
        description: |
          Average daily CSAT score on the same date in the previous year, 
          segmented by the specified dimension.

      - name: py_deposit_fees_in_gbp
        data_type: decimal
        description: |
          Sum of deposit fees paid by guests, excluding taxes, in GBP 
          on the same date in the previous year, segmented by the specified dimension.

      - name: py_waiver_payments_in_gbp
        data_type: decimal
        description: |
          Sum of waiver payments paid by guests, excluding taxes, in GBP 
          on the same date in the previous year, segmented by the specified dimension.

      - name: py_checkin_cover_fees_in_gbp
        data_type: decimal
        description: |
          Sum of check-in cover fees paid by guests, excluding taxes, in GBP 
          on the same date in the previous year, segmented by the specified dimension.

      - name: py_total_guest_payments_in_gbp
        data_type: decimal
        description: |
          Sum of total payments paid by guests, excluding taxes, in GBP 
          on the same date in the previous year, segmented by the specified dimension.

  - name: kpis__product_new_dash_agg_metrics
    description: |
      Reporting model for New Dash specific KPIs. It's an aggregated version 
      of time granularity, dimension, dimension value and list of metrics 
      with their value.

    tests:
      - dbt_utils.unique_combination_of_columns:
          combination_of_columns:
            - date
            - time_granularity
            - dimension
            - dimension_value

    columns:
      - name: date
        data_type: date
        description: |
          The end date of the time range specified in the time_granularity 
          for the dimension, dimension_value and metrics in this record.
        tests:
          - not_null

      - name: time_granularity
        data_type: string
        description: The time dimension.
        tests:
          - accepted_values:
              values:
                - Daily
                - Weekly
                - Monthly

      - name: dimension
        data_type: string
        description: The dimension or granularity of the metrics.
        tests:
          - accepted_values:
              values:
                - "Global"
                - "By Number Of Listings"
                - "By Billing Country"
                - "By Deal"
                - "By New Dash Version"
                - "By Has Upgraded Service"
                - "By Service"

      - name: dimension_value
        data_type: string
        description: The value or segment available for the selected dimension.
        tests:
          - not_null

      - name: created_services
        data_type: bigint
        description: The daily created services for a given date, dimension and value.

      - name: booking_with_created_services_count
        data_type: bigint
        description: |
          The daily bookings with created services for a given date, dimension and value.
          This is an approximation to booking count since different services can 
          apply to the same booking and these do not need to be created in the same
          time period. Therefore, it's not an additive metric.