Edit

Share via


Conversion Value Rule Record - Bulk

Defines a conversion value rule. Adjusts your conversion values if the conversion meets certain conditions that are relevant to your business goals.

You can download all Conversion Value Rule records in the account by including the DownloadEntity value of ConversionValueRules in the DownloadCampaignsByAccountIds or DownloadCampaignsByCampaignIds service request. Additionally the download request must include the EntityData devicetype. For more details about the Bulk service including best practices, see Bulk Download and Upload.

The following Bulk CSV example would add a new conversion value rule.

Type,Id,Name,Status,ConversionValueRuleValue,ConversionValueRuleOperator,CurrencyCode,PrimaryConditionType,IncludedLocations,ExcludedLocations,IncludedLocationIntent,ExcludedLocationIntent,DeviceType,Audiences,LCID,,,,
Format Version,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,  
ConversionValueRule,,Example Location and Audience Rule,Active,100,Add,USD,Location,1,2,3,,PeopleIn,,,123,345,456,1033

For a Conversion Value Rule record, the following attribute fields are available in the Bulk File Schema.

Audiences

The audience condition associated with the conversion value rule. Each conversion value rule can have up to 2 conditions.

Conversion Value Rule Value

The value of the conversion value rule. It should be greater than 0.

Add: Required
Update: Optional

Conversion Value Rule Operator

The ConversionValueRuleOperator value set has the following values: Add, Multiply.

Currency Code

The currency code for the conversion value rule.

Device Type

The device condition associated with the conversion value rule. Each conversion value rule can have up to 2 conditions.

Excluded Location Intent

The intent option for excluded locations.

Excluded Locations

The locations excluded from the condition.

Id

The unique Microsoft Advertising identifier for the conversion goal.

Add: Read-only
Update: Read-only and Required

Included Location Intent

The intent option for included locations.

Included Locations

The locations included in the condition.

LCID

The locale identifier. See LCID

Name

The name of the conversion value rule.

Primary Condition Type

Indicates if this is the primary condition. Only 1 primary condition is allowed in a conversion value rule.

Status

The status of the conversion value rule. Can be Active, Deleted, Invalid, or Paused.

Type

The type of the conversion value rule. This value is ConversionValueRule when you retrieve a conversion value rule.

Add: Read-only
Update: Read-only