Google Ad Manager (GAM)

GAM

Lyft Data supports collecting Google Ad Manager (GAM) report exports stored in Google Cloud Storage or S3-compatible buckets.

Configure Lyft Data to read GAM exports from Google Cloud Storage

Use the gcs input when GAM exports land in GCS:

• bucket-name – GAM export bucket (required).
• object-names – prefix such as gam/reports/.
• mode – list-and-download to fetch each report.
• include-regex – match .csv/.csv.gz depending on export configuration.
• preprocessors – use extension to decompress .gz and convert CSV lines to events if needed.
• credentials – service account with storage.objects.get and storage.objects.list.

Example: download GAM CSV exports from GCS

input:
  gcs:
    bucket-name: gam-reports
    object-names:
      - reports/daily/
    mode: list-and-download
    include-regex:
      - "\\.csv(\.gz)?$"
    fingerprinting: true
    timestamp-mode: last-modified
    credentials:
      service-account:
        key: ${secrets.gam_gcs_reader}
    preprocessors:
      - extension

Configure Lyft Data to read GAM exports from S3

If reports are delivered to S3 or compatible storage, configure the s3 input:

• bucket-name – destination bucket.
• object-names – GAM export prefix.
• mode – list-and-download.
• include-regex – match .csv or .json.gz.
• access-key / secret-key – credentials with list/get permissions.
• preprocessors – extension or gzip to decode compressed reports.

Example: download GAM exports from S3

input:
  s3:
    bucket-name: gam-export-s3
    object-names:
      - reports/daily/
    mode: list-and-download
    include-regex:
      - "\\.csv(\.gz)?$"
    fingerprinting: true
    timestamp-mode: last-modified
    access-key: ${secrets.gam_s3_access_key}
    secret-key: ${secrets.gam_s3_secret_key}
    preprocessors:
      - extension