MarketingGoal

Represents a measurable target for a marketing program or a campaign, tracking target values, actual results, and assignments across different levels of the marketing hierarchy.

Introduced in API version 67.0.

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The actual monetary amount achieved till current date.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Specifies the type of source that hosts the information about the actual value or the actual amount of the marketing goal.
  • Possible values:
    • MANUAL — MANUAL
    • SDM — SDM — Semantic Model
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The actual value achieved till current date.
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the attribution model associated with the marketing goal.

    This field is a relationship field.

  • Relationship name: AttributionModel

  • Relationship type: relationship

  • Refers to: AttribModel

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    The ID of the campaign that the goal belongs to.

    This field is a relationship field.

  • Relationship name: Campaign

  • Relationship type: relationship

  • Refers to: Campaign

  • Type: textarea
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The description of the marketing goal.
  • Type: date
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The end date of the goal.
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the engagement signal metric associated with the marketing goal.

    This field is a relationship field.

  • Relationship name: EngagementSignalMetric

  • Relationship type: relationship

  • Refers to: EngagementSignalMetric

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The unique identifier of the marketing goal in an external system.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Specifies the logical rule used to evaluate actual performance against the target. This determines whether the goal is achieved by meeting a minimum threshold (At Least) or staying within a maximum limit (At Most).
  • Possible values:
    • AT_LEAST — AT_LEAST — At Least
    • AT_MOST — AT_MOST — At Most
  • Type: boolean

  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update

  • Description:

    Indicates whether the goal is a financial target (true) or a non-financial metric (false).

    The default value is false.

  • Default value: false

  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Description: The date and time when the automated rollup job last ran, aggregating actual values or amounts from child goals into this goal. This timestamp also helps identify a rollup that’s stuck in progress for more than 90–120 minutes, so it can be retriggered.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Description: Specifies the current status of the automated job that aggregates the actual values or amounts from the child goals in the rollup hierarchy and updates the aggregated value as the actual value or amount of the current goal.
  • Possible values:
    • COMPLETED — COMPLETED
    • FAILED — FAILED
    • IN_PROGRESS — IN_PROGRESS — In Progress
    • SUBMITTED — SUBMITTED
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    The ID of the marketing program that the goal belongs to.

    This field is a relationship field.

  • Relationship name: MarketingProgram

  • Relationship type: relationship

  • Refers to: MarketingProgram

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the type of measure used to identify the target and actual values of the marketing goal.
  • Type: string
  • Properties: Create, Filter, Group, idLookup, Sort, Update
  • Description: The name of the marketing goal.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Additional information about the goal.
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the goal that the current goal rolls up to.

    This field is a relationship field.

  • Relationship name: ParentGoal

  • Relationship type: relationship

  • Refers to: MarketingGoal

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    The ID of the top-level marketing goal that the current goal rolls up to.

    This field is a relationship field.

  • Relationship name: RootMarketingGoal

  • Relationship type: relationship

  • Refers to: MarketingGoal

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the semantic metric definition that hosts the information about the actual value or the actual amount of the marketing goal.

    This field is a relationship field.

  • Relationship name: SemanticMetricDefinition

  • Relationship type: relationship

  • Refers to: SemanticMetricDefinition

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The ID of the campaign or marketing program that the goal belongs to.

    This field is a polymorphic relationship field.

  • Relationship name: SourceReference

  • Relationship type: polymorphic

  • Refers to: Campaign, MarketingProgram

  • Type: picklist

  • Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Description:

    Specifies the stage of the marketing goal.

    The default value is NOT_STARTED.

  • Possible values:

    • AT_RISK — AT_RISK — At Risk
    • CANCELLED — CANCELLED
    • COMPLETE — COMPLETE
    • NOT_STARTED — NOT_STARTED (default) — Not Started
    • ON_TRACK — ON_TRACK — On Track
  • Default value: NOT_STARTED

  • Type: date
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The start date of the goal.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the subtype of marketing goal.
  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The target monetary amount of the goal.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The target value of the goal.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the type of marketing goal.

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version.