Package google.shopping.merchant.conversions.v1beta

Index

• ConversionSourcesService (interface)
• AttributionSettings (message)
• AttributionSettings.AttributionModel (enum)
• AttributionSettings.ConversionType (message)
• ConversionSource (message)
• ConversionSource.Controller (enum)
• ConversionSource.State (enum)
• CreateConversionSourceRequest (message)
• DeleteConversionSourceRequest (message)
• GetConversionSourceRequest (message)
• GoogleAnalyticsLink (message)
• ListConversionSourcesRequest (message)
• ListConversionSourcesResponse (message)
• MerchantCenterDestination (message)
• UndeleteConversionSourceRequest (message)
• UpdateConversionSourceRequest (message)

ConversionSourcesService

Service for managing conversion sources for a merchant account.

CreateConversionSource
rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource) Creates a new conversion source. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/content For more information, see the OAuth 2.0 Overview.

DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty) Archives an existing conversion source. If the conversion source is a Merchant Center Destination, it will be recoverable for 30 days. If the conversion source is a Google Analytics Link, it will be deleted immediately and can be restored by creating a new one. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/content For more information, see the OAuth 2.0 Overview.

GetConversionSource
rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource) Fetches a conversion source. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/content For more information, see the OAuth 2.0 Overview.

ListConversionSources
rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse) Retrieves the list of conversion sources the caller has access to. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/content For more information, see the OAuth 2.0 Overview.

UndeleteConversionSource
rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource) Re-enables an archived conversion source. Only Available for Merchant Center Destination conversion sources. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/content For more information, see the OAuth 2.0 Overview.

UpdateConversionSource
rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource) Updates information of an existing conversion source. Available only for Merchant Center Destination conversion sources. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/content For more information, see the OAuth 2.0 Overview.

AttributionSettings

Represents attribution settings for conversion sources receiving pre-attribution data.

Fields
attribution_lookback_window_days	int32 Required. Lookback windows (in days) used for attribution in this source. Supported values are 7, 30, 40.
attribution_model	AttributionModel Required. Attribution model.
conversion_type[]	ConversionType Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard "purchase" type will be automatically created if this list is empty at creation time.

AttributionModel

The attribution model used for this source. We support the same set of models offered by Google Analytics 4, as described in: https://support.google.com/analytics/answer/10596866.

Enums
ATTRIBUTION_MODEL_UNSPECIFIED	Unspecified model.
CROSS_CHANNEL_LAST_CLICK	Cross-channel Last Click model.
ADS_PREFERRED_LAST_CLICK	Ads-preferred Last Click model.
CROSS_CHANNEL_DATA_DRIVEN	Cross-channel Data Driven model.
CROSS_CHANNEL_FIRST_CLICK	Cross-channel First Click model.
CROSS_CHANNEL_LINEAR	Cross-channel Linear model.
CROSS_CHANNEL_POSITION_BASED	Cross-channel Position Based model.
CROSS_CHANNEL_TIME_DECAY	Cross-channel Time Decay model.

ConversionType

Message representing a types of conversion events

Fields
name	string Output only. Conversion event name, as it'll be reported by the client.
report	bool Output only. Option indicating if the type should be included in Merchant Center reporting.

ConversionSource

Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.

Fields
name	string Output only. Identifier. Generated by the Content API upon creation of a new ConversionSource. Format: [a-z]{4}:.+ The four characters before the colon represent the type of conversio source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: - galk: For GoogleAnalyticsLink sources. - mcdn: For MerchantCenterDestination sources.
state	State Output only. Current state of this conversion source. Can't be edited through the API.
expire_time	Timestamp Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.
controller	Controller Output only. Controller of the conversion source.
Union field source_data. Required. Conversion source data specific to each different type of source. source_data can be only one of the following:
google_analytics_link	GoogleAnalyticsLink Immutable. Conversion Source of type "Link to Google Analytics Property".
merchant_center_destination	MerchantCenterDestination Conversion Source of type "Merchant Center Tag Destination".

Controller

Entity controlling the conversion source.

Enums
CONTROLLER_UNSPECIFIED	Default value. This value is unused.
MERCHANT	Controlled by the Merchant who owns the Conversion Source.
YOUTUBE_AFFILIATES	Controlled by the YT Affiliates program.

State

Represents state of the conversion source.

Enums
STATE_UNSPECIFIED	Conversion source has unspecified state.
ACTIVE	Conversion source is fully functional.
ARCHIVED	Conversion source has been archived in the last 30 days and not currently functional. Can be restored using the undelete method.
PENDING	Conversion source creation has started but not fully finished yet.

CreateConversionSourceRequest

Request message for the CreateConversionSource method.

Fields
parent	string Required. The merchant account that will own the new conversion source. Format: accounts/{account}
conversion_source	ConversionSource Required. The conversion source description. A new ID will be automatically assigned to it upon creation.

DeleteConversionSourceRequest

Request message for the DeleteConversionSource method.

Fields
name	string Required. The name of the conversion source to be deleted. Format: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

Request message for the GetConversionSource method.

Fields
name	string Required. The name of the conversion source to be fetched. Format: accounts/{account}/conversionSources/{conversion_source}

GoogleAnalyticsLink

"Google Analytics Link" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account.

Fields
property_id	int64 Required. Immutable. ID of the Google Analytics property the merchant is linked to.
attribution_settings	AttributionSettings Output only. Attribution settings for the linked Google Analytics property.
property	string Output only. Name of the Google Analytics property the merchant is linked to.

ListConversionSourcesRequest

Request message for the ListConversionSources method.

Fields
parent	string Required. The merchant account who owns the collection of conversion sources. Format: accounts/{account}
page_size	int32 Optional. The maximum number of conversion sources to return in a page. If no page_size is specified, 100 is used as the default value. The maximum value is 200. Values above 200 will be coerced to 200. Regardless of pagination, at most 200 conversion sources are returned in total.
page_token	string Optional. Page token.
show_deleted	bool Optional. Show deleted (archived) option.

ListConversionSourcesResponse

Response message for the ListConversionSources method.

Fields
conversion_sources[]	ConversionSource List of conversion sources.
next_page_token	string Token to be used to fetch the next results page.

MerchantCenterDestination

"Merchant Center Destination" sources can be used to send conversion events from an online store using a Google tag directly to a Merchant Center account where the source is created.

Fields
destination	string Output only. Merchant Center Destination ID.
attribution_settings	AttributionSettings Required. Attribution settings being used for the Merchant Center Destination.
display_name	string Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. Limited to 64 characters.
currency_code	string Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.

UndeleteConversionSourceRequest

Request message for the UndeleteConversionSource method.

Fields
name	string Required. The name of the conversion source to be undeleted. Format: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

Request message for the UpdateConversionSource method.

Fields
conversion_source	ConversionSource Required. The new version of the conversion source data. Format: accounts/{account}/conversionSources/{conversion_source}
update_mask	FieldMask Required. List of fields being updated.