{
  "$result_object_key": {
    "job_id": "1335925420095247666",
    "results": [
      {
        "conversion_action": "customers/123456789/conversionActions/987654321",
        "conversion_date_time": "2025-01-17T10:57:05Z",
        "gbraid": "EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE",
        "gclid": "EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE",
        "user_identifiers": [
          {
            "hashed_email": "6b583232e99af45c3b436798f32800a4dd6f3524624ba6507ed8269b53ce82a3",
            "hashed_phone_number": "b49f9168e8a886ffd61a090b51a26e117717f5f6fa804af49ea67043a2bfa4f0",
            "mobile_id": "1234567890",
            "source": "THIRD_PARTY",
            "third_party_user_id": "1234567890"
          }
        ],
        "wbraid": "CP7ToZIG_7oCFQsHiAkdzZoKWg"
      }
    ]
  }
}

{
  "$result_object_key": {
    "job_id": "Job ID",
    "results": {
      "conversion_action": "Conversion Action",
      "conversion_date_time": "Conversion DateTime",
      "gbraid": "Google Braid",
      "gclid": "Google Click ID",
      "user_identifiers": {
        "hashed_email": "Hashed Email",
        "hashed_phone_number": "Hashed Phone Number",
        "mobile_id": "Mobile ID",
        "source": "User Identifier Source",
        "third_party_user_id": "Third Party User ID"
      },
      "wbraid": "Web Braid"
    }
  }
}

{
  "$result_object_key": {
    "job_id": "1335925420095247666",
    "results": [
      {
        "conversion_action": "customers/123456789/conversionActions/987654321",
        "conversion_date_time": "2025-01-17T10:57:05Z",
        "gbraid": "EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE",
        "gclid": "EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE",
        "user_identifiers": [
          {
            "hashed_email": "6b583232e99af45c3b436798f32800a4dd6f3524624ba6507ed8269b53ce82a3",
            "hashed_phone_number": "b49f9168e8a886ffd61a090b51a26e117717f5f6fa804af49ea67043a2bfa4f0",
            "mobile_id": "1234567890",
            "source": "THIRD_PARTY",
            "third_party_user_id": "1234567890"
          }
        ],
        "wbraid": "CP7ToZIG_7oCFQsHiAkdzZoKWg"
      }
    ]
  }
}

{
  "$result_object_key": {
    "job_id": "Job ID",
    "results": {
      "conversion_action": "Conversion Action",
      "conversion_date_time": "Conversion DateTime",
      "gbraid": "Google Braid",
      "gclid": "Google Click ID",
      "user_identifiers": {
        "hashed_email": "Hashed Email",
        "hashed_phone_number": "Hashed Phone Number",
        "mobile_id": "Mobile ID",
        "source": "User Identifier Source",
        "third_party_user_id": "Third Party User ID"
      },
      "wbraid": "Web Braid"
    }
  }
}

Getting Started

Track Google Ads conversion events directly from Morf workflows. Before you begin, you’ll need to grant Morf access to your Google Ads account.

In Google Ads

Go to your Google Ads account dashboard — not the manager account.
Navigate to Admin > Access and Security and click + to add a new user.

Click on 'Admin' > 'Access and Security' > '+ button (Add)'

Fill in the following:
- Email: morf-google-ads@morf-prod-5f7d.iam.gserviceaccount.com
- Access Expires: Never
- Account access level: Standard

Conversion Action Setup

When using the conversion API to send conversions to Google Ads, you will need to create new import conversion actions.

In your Google Ads account go to Tools > Conversions.
Click + New Conversion Action to create a new conversion action.
Select Import.
Select Other data sources or CRMs and Track conversions from clicks, then click Continue.
Configure your conversion action within Google Ads. This configuration is the same as any other action in Google Ads.
Update the Count setting to only count conversion actions once. This allows you to replay events if there are any issues without double counting conversions.
Get the Conversion Action ID for this new action from the ctId param in the URL.
- Example: if the URL is https://ads.google.com/aw/conversions/detail?ocid=00000000&ctId=576882000, your Conversion Action ID is 576882000.

In the Morf Dashboard

Navigate to Integrations and add a new integration.
Select Google Ads.
Enter your Google Ads account ID (found in the top-right of your Google Ads dashboard, e.g. 123-456-7891) — not the manager account ID.

You can now use the Send Conversion Event action in your workflows.

FAQ and Testing

Customer ID and Conversion Action ID should always be different values

Customer ID is an account-level ID that is the same for all conversion actions in your Google Ads account.Conversion Action ID is unique to each conversion action and is configured per mapping. It can only be found in the browser URL of your given conversion action under the ctId parameter. For example, if the URL is https://ads.google.com/aw/conversions/detail?ocid=00000000&ctId=576882000, your Conversion Action ID is 576882000.

Seeing events coming through

To debug and validate that events are going through, look at the metric all conv. (at conv. time) — this shows the number of events coming through. It can take up to 24 hours for events to appear in the Google dashboard.

"The required field was not present., at conversions[0].gclid" error

Events sent to Google require a GCLID, an email, or a phone_number. If one of those identifiers is not being sent, you may see this error. Double-check that at least one of those fields is being passed on each payload.

Parameters

Hide parameters

string

required

This field maps to the destination API conversionAction field.

timing.v1.Timestamp

required

This field maps to the destination API conversionDateTime field.

string

ID PII This field maps to the destination API gclid field.

string

ID This field maps to the destination API gbraid field.

string

ID This field maps to the destination API wbraid field.

This field maps to the destination API consent.adUserData field.

This field maps to the destination API consent.adPersonalization field.

float64 (double)

This field maps to the destination API conversionValue field.

string

This field maps to the destination API orderId field.

string

This field maps to the destination API currencyCode field.

string

This field maps to the destination API conversionEnvironment field.

string

required

This field maps to the destination API userIdentifiers.userIdentifierSource field.

string

PII This field maps to the destination API userIdentifiers.hashedEmail field.

string

PII This field maps to the destination API userIdentifiers.hashedPhoneNumber field.

string

ID This field maps to the destination API userIdentifiers.thirdPartyUserId field.

bool

This field maps to the destination API debugEnabled field.

{
  "$result_object_key": {
    "job_id": "1335925420095247666",
    "results": [
      {
        "conversion_action": "customers/123456789/conversionActions/987654321",
        "conversion_date_time": "2025-01-17T10:57:05Z",
        "gbraid": "EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE",
        "gclid": "EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE",
        "user_identifiers": [
          {
            "hashed_email": "6b583232e99af45c3b436798f32800a4dd6f3524624ba6507ed8269b53ce82a3",
            "hashed_phone_number": "b49f9168e8a886ffd61a090b51a26e117717f5f6fa804af49ea67043a2bfa4f0",
            "mobile_id": "1234567890",
            "source": "THIRD_PARTY",
            "third_party_user_id": "1234567890"
          }
        ],
        "wbraid": "CP7ToZIG_7oCFQsHiAkdzZoKWg"
      }
    ]
  }
}

{
  "$result_object_key": {
    "job_id": "Job ID",
    "results": {
      "conversion_action": "Conversion Action",
      "conversion_date_time": "Conversion DateTime",
      "gbraid": "Google Braid",
      "gclid": "Google Click ID",
      "user_identifiers": {
        "hashed_email": "Hashed Email",
        "hashed_phone_number": "Hashed Phone Number",
        "mobile_id": "Mobile ID",
        "source": "User Identifier Source",
        "third_party_user_id": "Third Party User ID"
      },
      "wbraid": "Web Braid"
    }
  }
}

Result Object Field Details

You can use the result of the action’s data as inputs to downstream workflow actions. Each fetch action requires an object name, which nests the action’s result data inside the downstream data context in the workflow. See Passing Data Between Actions for how to set it and reference the result from downstream nodes. Here we demonstrate how to refer to this data using the prefix $result_object_key.

Fetch Action Response Object

Hide fields

string

required

Job ID

CEL

$result_object_key.job_id

Example

"1335925420095247666"

[]object

required

Conversion Event Results

CEL

$result_object_key.results

Example

[
{
"conversion_action": "customers/123456789/conversionActions/987654321",
"conversion_date_time": "2025-01-17T10:57:05Z",
"gbraid": "EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE",
"gclid": "EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE",
"user_identifiers": [
{
  "hashed_email": "6b583232e99af45c3b436798f32800a4dd6f3524624ba6507ed8269b53ce82a3",
  "hashed_phone_number": "b49f9168e8a886ffd61a090b51a26e117717f5f6fa804af49ea67043a2bfa4f0",
  "mobile_id": "1234567890",
  "source": "THIRD_PARTY",
  "third_party_user_id": "1234567890"
}
],
"wbraid": "CP7ToZIG_7oCFQsHiAkdzZoKWg"
}
]

[]string

required

Mapped array of: Google Click ID

CEL

$result_object_key.results.map(x, x.gclid)

Example

[
"EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE"
]

[]string

required

Mapped array of: Google Braid

CEL

$result_object_key.results.map(x, x.gbraid)

Example

[
"EAIaIQobChMI4_3o8Yze9QIVjLfICh2QaQjKEAAYASAAEgLvIPD_BwE"
]

[]string

required

Mapped array of: Web Braid

CEL

$result_object_key.results.map(x, x.wbraid)

Example

[
"CP7ToZIG_7oCFQsHiAkdzZoKWg"
]

[]bool

required

Mapped array of: User Identifiers

CEL

$result_object_key.results.map(x, x.user_identifiers)

Example

[
[
{
"hashed_email": "6b583232e99af45c3b436798f32800a4dd6f3524624ba6507ed8269b53ce82a3",
"hashed_phone_number": "b49f9168e8a886ffd61a090b51a26e117717f5f6fa804af49ea67043a2bfa4f0",
"mobile_id": "1234567890",
"source": "THIRD_PARTY",
"third_party_user_id": "1234567890"
}
]
]

[]string

required

Mapped array of: Conversion Action

CEL

$result_object_key.results.map(x, x.conversion_action)

Example

[
"customers/123456789/conversionActions/987654321"
]

[]timing.v1.Timestamp

required

Mapped array of: Conversion DateTime

CEL

$result_object_key.results.map(x, x.conversion_date_time)

Example

[
"2025-01-17T10:57:05Z"
]

​Getting Started

​In Google Ads

​Conversion Action Setup

​In the Morf Dashboard

​FAQ and Testing

​Parameters

​Result Object Field Details

Getting Started

In Google Ads

Conversion Action Setup

In the Morf Dashboard

FAQ and Testing

Parameters

Result Object Field Details