[New SA360 Reporting API] New metrics, resources, fields and updated definitions

[searchads-api-announcements]

This update includes new metrics, resources, fields and some new mapping definitions. Be sure to update the client library to take advantage of all these changes.

Metrics added

• cross_device_conversions_by_conversion_date: The number of cross-device conversions by conversion date.
• cross_device_conversions_value_by_conversion_date: The sum of cross-device conversions value by conversion date.
• general_invalid_click_rate: The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks.
• general_invalid_clicks: Number of general invalid clicks.

cross_device_conversions_by_conversion_date and cross_device_conversions_value_by_conversion_date are compatible with these resources: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view, and shopping_performance_view.

Field mappings redefined

The field mappings for dfaActions, dfaActionsCrossEnv, dfaActionsCrossEnv, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv have changed for some legacy reports.

See details in the release notes.

List of legacy reports that have changed the field mapping

• Account
• Ad
• AdGroup
• AdGroupTarget
• Advertiser
• BidStrategy
• Campaign
• Keyword
• ProductAdvertised

New fields

We are adding campaign.effective_labels and ad_group.effective_labels.

Effective Labels are labels inherited or directly assigned.

New resources

Related to the new effective_labels fields, the new resources keep metadata of the between the effective labels and the campaign (campaign_effective_label) or ad_group (ad_group_effective_label).