@seeka-labs/cli-apps 3.7.0 → 3.8.2

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/services/google/conversions/models.ts

@@ -0,0 +1,10 @@
+import type { enums } from "google-ads-api"
+
+export type GoogleAdsConversionActionInfoWithEnum = {
+    resourceName: string,
+    id: number,
+    name: string,
+    status: enums.ConversionActionStatus,
+    type: enums.ConversionActionType,
+    category: enums.ConversionActionCategory
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/services/google/conversions/services/adjustment.ts

@@ -0,0 +1,101 @@
+import {SeekaActivityAcceptedWebhookContent, TrackingEventSourceOriginType} from "@seeka-labs/sdk-apps-server";
+import {Customer, enums, services} from "google-ads-api";
+import {last} from "lodash-es";
+import {Logger} from "winston";
+import {GoogleAdsConversionActionInfoWithEnum} from "../models";
+import {seekaIdentityToGoogleIdentifiers} from "../utils";
+import {EgressMetricInfo} from "../mediate";
+import {GoogleAdsAppInstallContext, toGoogleAdsDateTime} from "@seeka-labs-apps/google-ads-lib";
+
+// https://developers.google.com/google-ads/api/reference/rpc/v21/ConversionAdjustmentUploadService/UploadConversionAdjustments
+export const fireConversionAdjustment = async (action: GoogleAdsConversionActionInfoWithEnum, seekaActivity: SeekaActivityAcceptedWebhookContent, clickIds: string[], googleAdsApi: Customer, installation: GoogleAdsAppInstallContext, logger: Logger): Promise<EgressMetricInfo | null> => {
+    const activity = seekaActivity.activity;
+    const userAgent = seekaActivity.identifiers?.ua && seekaActivity.identifiers?.ua.length > 0 ? last(seekaActivity.identifiers?.ua) : null
+
+    const isConversionAdjustmentUploadService = true;
+    const isStoreSalesConversion = action.type === enums.ConversionActionType.STORE_SALES;
+
+    const idInfo = await seekaIdentityToGoogleIdentifiers(seekaActivity, isConversionAdjustmentUploadService, isStoreSalesConversion, logger);
+    const googleIdentities = idInfo?.ids;
+    // TODO: convert seeka TCF consent to google conversion consent object
+
+    // https://developers.google.com/google-ads/api/reference/rpc/v21/ConversionAdjustmentUploadService/UploadConversionAdjustments?transport=rest#ConversionAdjustment
+    const adjustment: services.IConversionAdjustment = {
+        // customer_type:
+        //  consent:
+        gclid_date_time_pair: {
+            gclid: clickIds && clickIds.length > 0 ? last(clickIds) : undefined,
+            conversion_date_time: toGoogleAdsDateTime(new Date(seekaActivity.activity.time)),
+        },
+        adjustment_type: enums.ConversionAdjustmentType.ENHANCEMENT,
+        conversion_action: action.resourceName
+    };
+    if (userAgent && seekaActivity.source.origin === TrackingEventSourceOriginType.Browser) {
+        adjustment.user_agent = userAgent
+    }
+
+    if (googleIdentities && googleIdentities.length > 0) {
+        adjustment.user_identifiers = googleIdentities
+    }
+
+    adjustment.order_id = activity.commerce?.orderIdentifier || activity.commerce?.orderNumber || activity?.activityId;
+
+    const googlePayload: services.IUploadConversionAdjustmentsRequest = {
+        customer_id: installation.installationState.googleAdsCustomerId,
+        validate_only: false,
+        partial_failure: true,
+        conversion_adjustments: [adjustment]
+    }
+
+    const response = await googleAdsApi.conversionAdjustmentUploads.uploadConversionAdjustments(new services.UploadConversionAdjustmentsRequest(googlePayload))
+
+    if (response.partial_failure_error?.message) {
+        logger.error('Failed to track conversion adjustment', {
+            action,
+            googlePayload,
+            response: response.results,
+            googleIdentities,
+            partialFailure: {
+                code: response.partial_failure_error?.code,
+                message: response.partial_failure_error?.message
+            },
+            jobId: response.job_id
+        })
+        throw new Error("Failed to track conversion adjustment - " + response.partial_failure_error?.message);
+    } else {
+        logger.info('Tracked conversion adjustment', {
+            action,
+            googlePayload,
+            response: response.results,
+            googleIdentities,
+            partialFailure: {
+                code: response.partial_failure_error?.code,
+                message: response.partial_failure_error?.message
+            },
+            jobId: response.job_id
+        })
+
+        return {
+            egressMetrics: {
+                egressIdentityMetrics: {
+                    qualityRating: 0,
+                    dataPoints: 0,
+                    ...idInfo?.metrics?.egressIdentityMetrics,
+                },
+                egressQualityMetrics: {
+                    'ua': Boolean(adjustment.user_agent),
+                    'gclid': Boolean(adjustment.gclid_date_time_pair?.gclid),
+                    'orderid': Boolean(adjustment.order_id),
+                    ...idInfo?.metrics?.egressQualityMetrics
+                }
+            },
+            egressRecord: {
+                destinationPlatformTypeKey: 'google.ads',
+                // destinationPlatformIdentifier: `customer/${installation.installationState.googleAdsCustomerId}/action/${action.id}`,
+                destinationPlatformIdentifier: action.resourceName,
+                publishedPayload: googlePayload,
+                destinationPlatformEgressType: `conversion.adjustment.${enums.ConversionActionCategory[action.category]}.${enums.ConversionActionType[action.type]}`
+            }
+        }
+    }
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/services/google/conversions/services/call.ts

@@ -0,0 +1,86 @@
+import {getActivityValue, SeekaActivityAcceptedWebhookContent} from "@seeka-labs/sdk-apps-server";
+import { Customer, services } from "google-ads-api";
+import { last } from "lodash-es";
+import { Logger } from "winston";
+import { TrackGoogleAdsConversionQueueItem, TrackSeekaGoogleAdsConversionPayload } from "../../queues/models";
+import { GoogleAdsConversionActionInfoWithEnum } from "../models";
+import {GoogleAdsAppInstallContext, toGoogleAdsDateTime} from "@seeka-labs-apps/google-ads-lib";
+import {queueNames, triggerBackgroundJob} from "../../../../jobs";
+
+export const getPhoneCallQueueVisibilityTimeoutSeconds = (seekaActivity: SeekaActivityAcceptedWebhookContent): number => {
+    // Set timeout in seconds to 6 hours after the original activity time
+    return Math.max(0, Math.floor((new Date(seekaActivity.activity.time).getTime() + (6 * 60 * 60 * 1000) - Date.now()) / 1000))
+}
+
+export const fireAdCallConversion = async (action: GoogleAdsConversionActionInfoWithEnum, seekaActivity: SeekaActivityAcceptedWebhookContent, clickIds: string[], googleGbraidIds: string[],
+    googleWbraidIds: string[], googleAdsApi: Customer, installation: GoogleAdsAppInstallContext, payload: TrackSeekaGoogleAdsConversionPayload, causationId: string, correlationId: string, logger: Logger) => {
+    const activity = seekaActivity.activity;
+    const conversionVal = getActivityValue(activity)
+
+    // const isConversionAdjustmentUploadService = false;
+    // const isStoreSalesConversion = action.type === enums.ConversionActionType.STORE_SALES;
+
+    // const googleIdentities = await seekaIdentityToGoogleIdentifiers(seekaActivity, isConversionAdjustmentUploadService, isStoreSalesConversion, logger);
+    // const googleCart = seekaCommerceToGoogleConversionCart(seekaActivity, conversionVal, installation, logger)
+    // TODO: convert seeka TCF consent to google conversion consent object
+
+    const hasPhoneNumbers = seekaActivity.identifiers?.phone && seekaActivity.identifiers?.phone.length > 0
+    if (!hasPhoneNumbers) {
+        logger.verbose("No phone number on seeka identity")
+        return;
+    }
+
+    // https://developers.google.com/google-ads/api/reference/rpc/v21/ClickConversion
+    const conversion: services.ICallConversion = {
+        // customer_type: 
+        //  consent: 
+        conversion_action: action.resourceName,
+        // external_attribution_data
+        // session_attributes_key_value_pairs
+        conversion_date_time: toGoogleAdsDateTime(new Date(seekaActivity.activity.time)),
+        call_start_date_time: toGoogleAdsDateTime(new Date(seekaActivity.activity.time)),
+        caller_id: last(seekaActivity.identifiers?.phone)
+    }
+
+    if (conversionVal?.value) {
+        conversion.conversion_value = conversionVal?.value
+    }
+    if (conversionVal?.currencyCode) {
+        conversion.currency_code = conversionVal?.currencyCode
+    }
+
+    // https://developers.google.com/google-ads/api/reference/rpc/v21/UploadClickConversionsRequest
+    const googlePayload: services.IUploadCallConversionsRequest = {
+        customer_id: installation.installationState.googleAdsCustomerId,
+        validate_only: false,
+        partial_failure: true,
+        conversions: [conversion]
+    }
+
+    const response = await googleAdsApi.conversionUploads.uploadCallConversions(new services.UploadCallConversionsRequest(googlePayload))
+
+    if (response.partial_failure_error?.message) {
+        if (response.partial_failure_error?.message.indexOf('import calls that occurred less than 6 hours ago') > -1) {
+            const visibilityTimeout = getPhoneCallQueueVisibilityTimeoutSeconds(seekaActivity);
+            logger.info('Deferring conversion for ad call due to Google requiring 6 hours', { visibilityTimeout, activityTime: seekaActivity.activity?.time, action, googlePayload, response: response.results, partialFailure: { code: response.partial_failure_error?.code, message: response.partial_failure_error?.message } })
+            await triggerBackgroundJob(queueNames.trackGoogleAdsConversion, {
+                payload: { ...payload },
+                applicationInstallId: installation.applicationInstallId,
+                organisationBrandId: installation.organisationBrandId,
+                organisationId: installation.organisationId,
+                causationId,
+                correlationId
+            } as TrackGoogleAdsConversionQueueItem, logger, {
+                // Set timeout in seconds to 6 hours after the original activity time
+                visibilityTimeout
+            })
+        }
+        else {
+            logger.error('Failed to track conversion for ad call', { action, googlePayload, response: response.results, partialFailure: { code: response.partial_failure_error?.code, message: response.partial_failure_error?.message } })
+            throw new Error("Failed to track conversion for ad call - " + response.partial_failure_error?.message);
+        }
+    }
+    else {
+        logger.info('Tracked conversion for ad call', { action, googlePayload, response: response.results, partialFailure: { code: response.partial_failure_error?.code, message: response.partial_failure_error?.message } })
+    }
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/services/google/conversions/services/click.ts

@@ -0,0 +1,109 @@
+import {getActivityValue, SeekaActivityAcceptedWebhookContent} from "@seeka-labs/sdk-apps-server";
+import {Customer, enums, services} from "google-ads-api";
+import {last} from "lodash-es";
+import {Logger} from "winston";
+import {GoogleAdsConversionActionInfoWithEnum} from "../models";
+import {
+    seekaCommerceToGoogleConversionCart,
+    seekaIdentityToGoogleIdentifiers,
+    seekaOriginToGoogleConversionEnvironment
+} from "../utils";
+import {GoogleAdsAppInstallContext, toGoogleAdsDateTime} from "@seeka-labs-apps/google-ads-lib";
+
+//  https://developers.google.com/google-ads/api/reference/rpc/v21/ConversionUploadService#uploadclickconversions
+export const fireClickConversion = async (action: GoogleAdsConversionActionInfoWithEnum, seekaActivity: SeekaActivityAcceptedWebhookContent, clickIds: string[], googleGbraidIds: string[], googleWbraidIds: string[], googleAdsApi: Customer, installation: GoogleAdsAppInstallContext, logger: Logger) => {
+    // Google IDs
+    // if (!clickIds || clickIds.length === 0) {
+    //   logger.verbose("No Google Click IDs found on identity, not firing click conversion")
+    //   return;
+    // }
+
+    const activity = seekaActivity.activity;
+    const conversionVal = getActivityValue(activity)
+    const ipAddress = seekaActivity.identifiers?.ip && seekaActivity.identifiers?.ip.length > 0 ? last(seekaActivity.identifiers?.ip) : null
+
+    const isConversionAdjustmentUploadService = false;
+    const isStoreSalesConversion = action.type === enums.ConversionActionType.STORE_SALES;
+
+    const idInfo = await seekaIdentityToGoogleIdentifiers(seekaActivity, isConversionAdjustmentUploadService, isStoreSalesConversion, logger);
+    const googleIdentities = idInfo?.ids;
+    const googleCart = seekaCommerceToGoogleConversionCart(seekaActivity, conversionVal, installation, logger)
+    // TODO: convert seeka TCF consent to google conversion consent object
+
+    // https://developers.google.com/google-ads/api/reference/rpc/v21/ClickConversion
+    const conversion: services.IClickConversion = {
+        // customer_type:
+        //  consent:
+        conversion_action: action.resourceName,
+        conversion_environment: seekaOriginToGoogleConversionEnvironment(seekaActivity.source.origin),
+        // external_attribution_data
+        // session_attributes_key_value_pairs
+        conversion_date_time: toGoogleAdsDateTime(new Date(seekaActivity.activity.time)),
+    }
+    if (googleCart) {
+        conversion.cart_data = googleCart
+    }
+    if (ipAddress) {
+        conversion.user_ip_address = ipAddress
+    }
+
+    if (clickIds && clickIds.length) {
+        conversion.gclid = last(clickIds);
+    }
+    if (googleIdentities) {
+        conversion.user_identifiers = googleIdentities
+    }
+    if (googleGbraidIds && googleGbraidIds.length) {
+        conversion.gbraid = last(googleGbraidIds);
+    }
+    if (googleWbraidIds && googleWbraidIds.length) {
+        conversion.wbraid = last(googleWbraidIds);
+    }
+
+    if (conversionVal?.value) {
+        conversion.conversion_value = conversionVal?.value
+    }
+    if (conversionVal?.currencyCode) {
+        conversion.currency_code = conversionVal?.currencyCode
+    }
+    if (activity.commerce?.orderIdentifier || activity.commerce?.orderNumber) {
+        conversion.order_id = activity.commerce?.orderIdentifier || activity.commerce?.orderNumber || activity?.activityId
+    }
+
+    // https://developers.google.com/google-ads/api/reference/rpc/v21/UploadClickConversionsRequest
+    const googlePayload: services.IUploadClickConversionsRequest = {
+        customer_id: installation.installationState.googleAdsCustomerId,
+        validate_only: false,
+        partial_failure: true,
+        conversions: [conversion]
+    }
+
+    const response = await googleAdsApi.conversionUploads.uploadClickConversions(new services.UploadClickConversionsRequest(googlePayload))
+
+    if (response.partial_failure_error?.message) {
+        logger.error('Failed to track conversion for click', {
+            action,
+            googlePayload,
+            response: response.results,
+            googleIdentities,
+            partialFailure: {
+                code: response.partial_failure_error?.code,
+                message: response.partial_failure_error?.message
+            },
+            jobId: response.job_id
+        })
+        throw new Error("Failed to track conversion for click - " + response.partial_failure_error?.message);
+    } else {
+        logger.info('Tracked conversion for click', {
+            action,
+            googlePayload,
+            response: response.results,
+            googleIdentities,
+            partialFailure: {
+                code: response.partial_failure_error?.code,
+                message: response.partial_failure_error?.message
+            },
+            jobId: response.job_id
+        })
+    }
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/services/google/conversions/utils.ts

@@ -0,0 +1,263 @@
+import {
+    ActivityMonetaryValue,
+    AnalyticsLibrary,
+    CommerceActivityTrackingEventProductMetadata,
+    getContentIdFromProduct,
+    PersonIdentifiers,
+    SeekaActivityAcceptedWebhookContent,
+    TrackingEventSourceOriginType
+} from "@seeka-labs/sdk-apps-server";
+import {common, enums, services} from "google-ads-api";
+import {last} from "lodash-es";
+import {Logger} from "winston";
+import {GoogleAdsConversionActionInfoWithEnum} from "./models";
+import {ActivityEgressTelemetryRecordMetrics} from "@seeka-labs/sdk-apps-server-telemetry-core";
+import {
+    GoogleAdsAppInstallContext,
+    GoogleAdsConversionActionInfo, googleAdsNormalizeAndHash,
+    googleAdsNormalizeAndHashEmailAddress
+} from "@seeka-labs-apps/google-ads-lib";
+
+export const toEnumConversionAction = (action: GoogleAdsConversionActionInfo): GoogleAdsConversionActionInfoWithEnum => {
+    return {
+        ...action,
+        status: enums.ConversionActionStatus[action.status],
+        type: enums.ConversionActionType[action.type],
+        category: enums.ConversionActionCategory[action.category]
+    };
+}
+
+export const seekaOriginToGoogleConversionEnvironment = (origin: TrackingEventSourceOriginType): enums.ConversionEnvironment | undefined => {
+    switch (origin) {
+        case TrackingEventSourceOriginType.Mobile: {
+            return enums.ConversionEnvironment.APP;
+        }
+        case TrackingEventSourceOriginType.Server:
+        case TrackingEventSourceOriginType.Browser: {
+            return enums.ConversionEnvironment.WEB;
+        }
+        default: {
+            throw new Error(`Unknown conversion environment ${origin}`);
+        }
+    }
+}
+
+export const seekaCommerceToGoogleConversionCart = (seekaActivity: SeekaActivityAcceptedWebhookContent, monetaryValue: ActivityMonetaryValue, installation: GoogleAdsAppInstallContext, logger: Logger): services.ICartData | undefined => {
+    const contentIdBehavior = installation.installationState?.trackingSettings?.analytics?.libraries?.googleAnalytics?.merchant?.productItemIdBehavior;
+    if (!contentIdBehavior) {
+        logger.warn("No product item id behavior found in installation state")
+    }
+
+    return {
+        //  merchant_id: null,
+        feed_country_code: monetaryValue?.currencyCode,
+        // feed_language_code?: (string|null);
+        local_transaction_cost: monetaryValue?.value,
+        items: seekaActivity.activity?.commerce?.products?.map((p) => seekaCommerceProductToGoogleConversionCartItem(p, installation)).filter(Boolean)
+    };
+}
+
+export const seekaCommerceProductToGoogleConversionCartItem = (seekaProduct: CommerceActivityTrackingEventProductMetadata, installation: GoogleAdsAppInstallContext): services.CartData.IItem | undefined => {
+    if (!seekaProduct) return undefined
+    return {
+        quantity: seekaProduct.quantity,
+        product_id: getContentIdFromProduct(seekaProduct, installation.installationState?.trackingSettings, AnalyticsLibrary.GoogleAds),
+        unit_price: seekaProduct.unitPrice
+    };
+}
+
+// https://developers.google.com/google-ads/api/reference/rpc/v21/UserIdentifier
+export const seekaIdentityToGoogleIdentifiers = async (seekaActivity: SeekaActivityAcceptedWebhookContent, isConversionAdjustmentUploadService: boolean, isStoreSalesConversion: boolean, logger: Logger): Promise<{
+    ids: common.IUserIdentifier[],
+    metrics: ActivityEgressTelemetryRecordMetrics
+} | undefined> => {
+
+    // /** UserIdentifier address_info */
+    // address_info?: (google.ads.googleads.v21.common.IOfflineUserAddressInfo|null);
+
+    let dataPoints = 0;
+    let qualityRating = 0;
+    const egressQualityMetrics: Record<string, boolean> = {
+        em: false,
+        ph: false,
+        clk: false,
+        "ad.street": false,
+        "ad.state": false,
+        "ad.cntry": false,
+        "ad.city": false,
+        "ad.zip": false,
+        'fn': false,
+        'ln': false,
+    }
+
+    // Max 5
+    const googleIdentities: common.IUserIdentifier[] = []
+    const seekaProfile = seekaActivity.identifiers;
+    const userIdentifierSource = enums.UserIdentifierSource.FIRST_PARTY
+    if (!seekaProfile) {
+        logger.warn("No identifiers found in seeka activity")
+        return undefined;
+    }
+    let populated = false;
+
+    if (seekaProfile.phone && seekaProfile.phone.length > 0) {
+        googleIdentities.push({
+            hashed_phone_number: googleAdsNormalizeAndHash(last(seekaProfile.phone)),
+            user_identifier_source: userIdentifierSource
+        });
+        populated = true;
+        dataPoints++;
+        qualityRating += 3;
+        egressQualityMetrics['ph'] = true;
+    }
+
+    if (seekaProfile.email && seekaProfile.email.length > 0) {
+        googleIdentities.push({
+            hashed_email: googleAdsNormalizeAndHashEmailAddress(last(seekaProfile.email)),
+            user_identifier_source: userIdentifierSource
+        });
+        populated = true;
+        dataPoints++;
+        qualityRating += 3;
+        egressQualityMetrics['em'] = true;
+    }
+
+    if (seekaProfile.phone && seekaProfile.phone.length > 1 && googleIdentities.length < 5) {
+        // Push all remaining phone numbers up to max 5 identifiers
+        for (let i = 0; i < seekaProfile.phone.length; i++) {
+            if (googleIdentities.length >= 5) break;
+            const phone = seekaProfile.phone[i];
+            if (phone && phone.length > 0) {
+                const hashedPhone = googleAdsNormalizeAndHash(phone);
+                // Avoid duplicates
+                if (!googleIdentities.find(id => id.hashed_phone_number === hashedPhone)) {
+                    googleIdentities.push({
+                        hashed_phone_number: hashedPhone,
+                        user_identifier_source: userIdentifierSource
+                    });
+                    populated = true;
+                    dataPoints++;
+                    qualityRating += 2;
+                    egressQualityMetrics['ph'] = true;
+                }
+            }
+        }
+    }
+
+    if (seekaProfile.email && seekaProfile.email.length > 1 && googleIdentities.length < 5) {
+        // Push all remaining emails up to max 5 identifiers
+        for (let i = 0; i < seekaProfile.email.length; i++) {
+            if (googleIdentities.length >= 5) break;
+            const email = seekaProfile.email[i];
+            if (email && email.length > 0) {
+                const hashedEmail = googleAdsNormalizeAndHashEmailAddress(email);
+                // Avoid duplicates
+                if (!googleIdentities.find(id => id.hashed_email === hashedEmail)) {
+                    googleIdentities.push({hashed_email: hashedEmail, user_identifier_source: userIdentifierSource});
+                    populated = true;
+                    dataPoints++;
+                    qualityRating += 2;
+                    egressQualityMetrics['em'] = true;
+                }
+            }
+        }
+    }
+
+    // if (seekaActivity.personId) {
+    //     googleIdentity.third_party_user_id = await googleAdsNormalizeAndHash(seekaActivity.personId);
+    //     googleIdentity.user_identifier_source = enums.UserIdentifierSource.THIRD_PARTY;
+    //     return googleIdentity;
+    // }
+
+    if (seekaProfile.address && seekaProfile.address.length > 0 && googleIdentities.length < 5) {
+        // Push all remaining addresses up to max 5 identifiers
+        for (let i = 0; i < seekaProfile.address.length; i++) {
+            if (googleIdentities.length >= 5) break;
+            const address = seekaProfile.address[i];
+            if (address) {
+                const googleAddress = await seekaIdentityToGoogleAddress({
+                    ...seekaProfile,
+                    address: [address]
+                }, isConversionAdjustmentUploadService, isStoreSalesConversion);
+                if (googleAddress) {
+                    googleIdentities.push({address_info: googleAddress, user_identifier_source: userIdentifierSource});
+                    populated = true;
+                    dataPoints++;
+                    qualityRating += 0.9;
+                    if (googleAddress.hashed_street_address) egressQualityMetrics['ad.street'] = true;
+                    if (googleAddress.city) egressQualityMetrics['ad.city'] = true;
+                    if (googleAddress.state) egressQualityMetrics['ad.state'] = true;
+                    if (googleAddress.country_code) egressQualityMetrics['ad.cntry'] = true;
+                    if (googleAddress.postal_code) egressQualityMetrics['ad.zip'] = true;
+                    if (googleAddress.hashed_first_name) egressQualityMetrics['fn'] = true;
+                    if (googleAddress.hashed_last_name) egressQualityMetrics['ln'] = true;
+                }
+            }
+        }
+    }
+
+    // TODO: /** UserIdentifier mobile_id */ (IDFA) for mobile apps
+    // mobile_id?: (string|null);
+
+    if (!populated) return undefined;
+
+    return {
+        ids: googleIdentities,
+        metrics: {
+            egressQualityMetrics: {},
+            egressIdentityMetrics: {
+                dataPoints,
+                qualityRating: qualityRating > 1 ? 1 : qualityRating
+            }
+        }
+    };
+}
+
+// https://developers.google.com/google-ads/api/reference/rpc/v21/OfflineUserAddressInfo
+// allowDetailedAddress set to true for ConversionAdjustmentUploadService.
+export const seekaIdentityToGoogleAddress = async (seekaIdentity: PersonIdentifiers, isConversionAdjustmentUploadService: boolean, isStoreSalesConversion: boolean): Promise<undefined | common.IOfflineUserAddressInfo> => {
+    let populated = false;
+    const googleAddress: common.IOfflineUserAddressInfo = {};
+
+    const seekaAddress = seekaIdentity.address && seekaIdentity.address.length > 0 ? last(seekaIdentity.address) : null;
+    if (!seekaAddress) return undefined;
+    if (isConversionAdjustmentUploadService || isStoreSalesConversion) {
+        if (seekaAddress.locality) {
+            googleAddress.city = seekaAddress.locality
+            populated = true
+        }
+        if (seekaAddress.stateCode) {
+            googleAddress.state = seekaAddress.stateCode
+            populated = true
+        }
+    }
+    if (seekaAddress.countryCode) {
+        googleAddress.country_code = seekaAddress.countryCode
+        populated = true
+    }
+
+    if (seekaAddress.postcode) {
+        googleAddress.postal_code = seekaAddress.postcode
+        populated = true
+    }
+
+    if (seekaIdentity.firstName && seekaIdentity.firstName.length > 0) {
+        googleAddress.hashed_first_name = googleAdsNormalizeAndHash(last(seekaIdentity.firstName));
+        populated = true
+    }
+    if (seekaIdentity.lastName && seekaIdentity.lastName.length > 0) {
+        googleAddress.hashed_last_name = googleAdsNormalizeAndHash(last(seekaIdentity.lastName));
+        populated = true
+    }
+
+    if (isConversionAdjustmentUploadService) {
+        if (seekaAddress.addressLine1) {
+            googleAddress.hashed_street_address = googleAdsNormalizeAndHash(seekaAddress.addressLine1);
+            populated = true
+        }
+    }
+
+    if (populated) return googleAddress;
+
+    return undefined;
+}