Skip to content
This repository was archived by the owner on Dec 31, 2023. It is now read-only.

Commit d3aeb71

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
docs: announce the deprecation of first-click, linear, time-decay and position-based attribution models (#350)
* docs: announce the deprecation of first-click, linear, time-decay and position-based attribution models feat: update the `default_uri` field of the `WebStreamData` type to be mutable feat: add the `ads_web_conversion_data_export_scope` field to the `ReportingAttributionModel` type feat: add `AdsWebConversionDataExportScope` enum to the Admin API v1alpha PiperOrigin-RevId: 542000614 Source-Link: googleapis/googleapis@c709b96 Source-Link: https://github.com/googleapis/googleapis-gen/commit/6bad798be7908a5cabf84c404b123a4995d290fa Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNmJhZDc5OGJlNzkwOGE1Y2FiZjg0YzQwNGIxMjNhNDk5NWQyOTBmYSJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent b005443 commit d3aeb71

9 files changed

Lines changed: 141 additions & 54 deletions

‎google/analytics/admin_v1alpha/services/analytics_admin_service/async_client.py‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9130,6 +9130,7 @@ async def sample_update_attribution_settings():
91309130
attribution_settings.acquisition_conversion_event_lookback_window = "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS"
91319131
attribution_settings.other_conversion_event_lookback_window = "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_90_DAYS"
91329132
attribution_settings.reporting_attribution_model = "ADS_PREFERRED_LAST_CLICK"
9133+
attribution_settings.ads_web_conversion_data_export_scope = "ADS_PREFERRED"
91339134

91349135
request = admin_v1alpha.UpdateAttributionSettingsRequest(
91359136
attribution_settings=attribution_settings,
@@ -11751,9 +11752,9 @@ async def sample_get_enhanced_measurement_settings():
1175111752

1175211753
Returns:
1175311754
google.analytics.admin_v1alpha.types.EnhancedMeasurementSettings:
11754-
Singleton resource under a
11755-
WebDataStream, configuring measurement
11756-
of additional site interactions and
11755+
Singleton resource under a web
11756+
DataStream, configuring measurement of
11757+
additional site interactions and
1175711758
content.
1175811759

1175911760
"""
@@ -11875,9 +11876,9 @@ async def sample_update_enhanced_measurement_settings():
1187511876

1187611877
Returns:
1187711878
google.analytics.admin_v1alpha.types.EnhancedMeasurementSettings:
11878-
Singleton resource under a
11879-
WebDataStream, configuring measurement
11880-
of additional site interactions and
11879+
Singleton resource under a web
11880+
DataStream, configuring measurement of
11881+
additional site interactions and
1188111882
content.
1188211883

1188311884
"""

‎google/analytics/admin_v1alpha/services/analytics_admin_service/client.py‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9814,6 +9814,7 @@ def sample_update_attribution_settings():
98149814
attribution_settings.acquisition_conversion_event_lookback_window = "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS"
98159815
attribution_settings.other_conversion_event_lookback_window = "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_90_DAYS"
98169816
attribution_settings.reporting_attribution_model = "ADS_PREFERRED_LAST_CLICK"
9817+
attribution_settings.ads_web_conversion_data_export_scope = "ADS_PREFERRED"
98179818

98189819
request = admin_v1alpha.UpdateAttributionSettingsRequest(
98199820
attribution_settings=attribution_settings,
@@ -12462,9 +12463,9 @@ def sample_get_enhanced_measurement_settings():
1246212463

1246312464
Returns:
1246412465
google.analytics.admin_v1alpha.types.EnhancedMeasurementSettings:
12465-
Singleton resource under a
12466-
WebDataStream, configuring measurement
12467-
of additional site interactions and
12466+
Singleton resource under a web
12467+
DataStream, configuring measurement of
12468+
additional site interactions and
1246812469
content.
1246912470

1247012471
"""
@@ -12590,9 +12591,9 @@ def sample_update_enhanced_measurement_settings():
1259012591

1259112592
Returns:
1259212593
google.analytics.admin_v1alpha.types.EnhancedMeasurementSettings:
12593-
Singleton resource under a
12594-
WebDataStream, configuring measurement
12595-
of additional site interactions and
12594+
Singleton resource under a web
12595+
DataStream, configuring measurement of
12596+
additional site interactions and
1259612597
content.
1259712598

1259812599
"""

‎google/analytics/admin_v1alpha/services/analytics_admin_service/transports/rest.py‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10158,9 +10158,9 @@ def __call__(
1015810158

1015910159
Returns:
1016010160
~.resources.EnhancedMeasurementSettings:
10161-
Singleton resource under a
10162-
WebDataStream, configuring measurement
10163-
of additional site interactions and
10161+
Singleton resource under a web
10162+
DataStream, configuring measurement of
10163+
additional site interactions and
1016410164
content.
1016510165

1016610166
"""
@@ -14422,9 +14422,9 @@ def __call__(
1442214422

1442314423
Returns:
1442414424
~.resources.EnhancedMeasurementSettings:
14425-
Singleton resource under a
14426-
WebDataStream, configuring measurement
14427-
of additional site interactions and
14425+
Singleton resource under a web
14426+
DataStream, configuring measurement of
14427+
additional site interactions and
1442814428
content.
1442914429

1443014430
"""

‎google/analytics/admin_v1alpha/types/resources.py‎

Lines changed: 71 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -667,17 +667,15 @@ class WebStreamData(proto.Message):
667667
668668
Attributes:
669669
measurement_id (str):
670-
Output only. Analytics "Measurement ID",
671-
without the "G-" prefix. Example: "G-1A2BCD345E"
672-
would just be "1A2BCD345E".
670+
Output only. Analytics Measurement ID.
671+
Example: "G-1A2BCD345E".
673672
firebase_app_id (str):
674673
Output only. ID of the corresponding web app
675674
in Firebase, if any. This ID can change if the
676675
web app is deleted and recreated.
677676
default_uri (str):
678-
Immutable. Domain name of the web app being
679-
measured, or empty. Example:
680-
"http://www.google.com",
677+
Domain name of the web app being measured, or
678+
empty. Example: "http://www.google.com",
681679
"https://www.google.com".
682680
"""
683681

@@ -2189,6 +2187,9 @@ class AttributionSettings(proto.Message):
21892187
will be reflected in reports with conversion and
21902188
revenue data. User and session data will be
21912189
unaffected.
2190+
ads_web_conversion_data_export_scope (google.analytics.admin_v1alpha.types.AttributionSettings.AdsWebConversionDataExportScope):
2191+
Required. The Conversion Export Scope for
2192+
data exported to linked Ads Accounts.
21922193
"""
21932194

21942195
class AcquisitionConversionEventLookbackWindow(proto.Enum):
@@ -2247,22 +2248,44 @@ class ReportingAttributionModel(proto.Enum):
22472248
the customer clicked through (or engaged view
22482249
through for YouTube) before converting.
22492250
CROSS_CHANNEL_FIRST_CLICK (3):
2250-
Gives all credit for the conversion to the
2251-
first channel that a customer clicked (or
2252-
engaged view through for YouTube) before
2253-
converting.
2251+
Starting in June 2023, new properties can no longer use this
2252+
model. See `Analytics
2253+
Help <https://support.google.com/analytics/answer/9164320?hl=en#040623>`__
2254+
for more details. Starting in September 2023, we will sunset
2255+
this model for all properties.
2256+
2257+
Gives all credit for the conversion to the first channel
2258+
that a customer clicked (or engaged view through for
2259+
YouTube) before converting.
22542260
CROSS_CHANNEL_LINEAR (4):
2255-
Distributes the credit for the conversion
2256-
equally across all the channels a customer
2257-
clicked (or engaged view through for YouTube)
2258-
before converting.
2261+
Starting in June 2023, new properties can no longer use this
2262+
model. See `Analytics
2263+
Help <https://support.google.com/analytics/answer/9164320?hl=en#040623>`__
2264+
for more details. Starting in September 2023, we will sunset
2265+
this model for all properties.
2266+
2267+
Distributes the credit for the conversion equally across all
2268+
the channels a customer clicked (or engaged view through for
2269+
YouTube) before converting.
22592270
CROSS_CHANNEL_POSITION_BASED (5):
2260-
Attributes 40% credit to the first and last
2261-
interaction, and the remaining 20% credit is
2262-
distributed evenly to the middle interactions.
2271+
Starting in June 2023, new properties can no longer use this
2272+
model. See `Analytics
2273+
Help <https://support.google.com/analytics/answer/9164320?hl=en#040623>`__
2274+
for more details. Starting in September 2023, we will sunset
2275+
this model for all properties.
2276+
2277+
Attributes 40% credit to the first and last interaction, and
2278+
the remaining 20% credit is distributed evenly to the middle
2279+
interactions.
22632280
CROSS_CHANNEL_TIME_DECAY (6):
2264-
Gives more credit to the touchpoints that
2265-
happened closer in time to the conversion.
2281+
Starting in June 2023, new properties can no longer use this
2282+
model. See `Analytics
2283+
Help <https://support.google.com/analytics/answer/9164320?hl=en#040623>`__
2284+
for more details. Starting in September 2023, we will sunset
2285+
this model for all properties.
2286+
2287+
Gives more credit to the touchpoints that happened closer in
2288+
time to the conversion.
22662289
ADS_PREFERRED_LAST_CLICK (7):
22672290
Attributes 100% of the conversion value to
22682291
the last Google Ads channel that the customer
@@ -2277,6 +2300,29 @@ class ReportingAttributionModel(proto.Enum):
22772300
CROSS_CHANNEL_TIME_DECAY = 6
22782301
ADS_PREFERRED_LAST_CLICK = 7
22792302

2303+
class AdsWebConversionDataExportScope(proto.Enum):
2304+
r"""The Conversion Export Scope for data exported to linked Ads
2305+
Accounts.
2306+
2307+
Values:
2308+
ADS_WEB_CONVERSION_DATA_EXPORT_SCOPE_UNSPECIFIED (0):
2309+
Default value. This value is unused.
2310+
NOT_SELECTED_YET (1):
2311+
No data export scope selected yet.
2312+
Export scope can never be changed back to this
2313+
value.
2314+
CROSS_CHANNEL (2):
2315+
The Ads Web Conversion Data export scope is
2316+
Cross Channel.
2317+
ADS_PREFERRED (3):
2318+
The Ads Web Conversion Data export scope is
2319+
Ads Preferred.
2320+
"""
2321+
ADS_WEB_CONVERSION_DATA_EXPORT_SCOPE_UNSPECIFIED = 0
2322+
NOT_SELECTED_YET = 1
2323+
CROSS_CHANNEL = 2
2324+
ADS_PREFERRED = 3
2325+
22802326
name: str = proto.Field(
22812327
proto.STRING,
22822328
number=1,
@@ -2298,6 +2344,11 @@ class ReportingAttributionModel(proto.Enum):
22982344
number=4,
22992345
enum=ReportingAttributionModel,
23002346
)
2347+
ads_web_conversion_data_export_scope: AdsWebConversionDataExportScope = proto.Field(
2348+
proto.ENUM,
2349+
number=5,
2350+
enum=AdsWebConversionDataExportScope,
2351+
)
23012352

23022353

23032354
class AccessBinding(proto.Message):
@@ -2429,7 +2480,7 @@ class BigQueryLink(proto.Message):
24292480

24302481

24312482
class EnhancedMeasurementSettings(proto.Message):
2432-
r"""Singleton resource under a WebDataStream, configuring
2483+
r"""Singleton resource under a web DataStream, configuring
24332484
measurement of additional site interactions and content.
24342485
24352486
Attributes:

‎samples/generated_samples/analyticsadmin_v1alpha_generated_analytics_admin_service_update_attribution_settings_async.py‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,7 @@ async def sample_update_attribution_settings():
4343
attribution_settings.acquisition_conversion_event_lookback_window = "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS"
4444
attribution_settings.other_conversion_event_lookback_window = "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_90_DAYS"
4545
attribution_settings.reporting_attribution_model = "ADS_PREFERRED_LAST_CLICK"
46+
attribution_settings.ads_web_conversion_data_export_scope = "ADS_PREFERRED"
4647

4748
request = admin_v1alpha.UpdateAttributionSettingsRequest(
4849
attribution_settings=attribution_settings,

‎samples/generated_samples/analyticsadmin_v1alpha_generated_analytics_admin_service_update_attribution_settings_sync.py‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,7 @@ def sample_update_attribution_settings():
4343
attribution_settings.acquisition_conversion_event_lookback_window = "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS"
4444
attribution_settings.other_conversion_event_lookback_window = "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_90_DAYS"
4545
attribution_settings.reporting_attribution_model = "ADS_PREFERRED_LAST_CLICK"
46+
attribution_settings.ads_web_conversion_data_export_scope = "ADS_PREFERRED"
4647

4748
request = admin_v1alpha.UpdateAttributionSettingsRequest(
4849
attribution_settings=attribution_settings,

‎samples/generated_samples/snippet_metadata_google.analytics.admin.v1alpha.json‎

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
],
99
"language": "PYTHON",
1010
"name": "google-analytics-admin",
11-
"version": "0.17.0"
11+
"version": "0.1.0"
1212
},
1313
"snippets": [
1414
{
@@ -16787,12 +16787,12 @@
1678716787
"regionTag": "analyticsadmin_v1alpha_generated_AnalyticsAdminService_UpdateAttributionSettings_async",
1678816788
"segments": [
1678916789
{
16790-
"end": 56,
16790+
"end": 57,
1679116791
"start": 27,
1679216792
"type": "FULL"
1679316793
},
1679416794
{
16795-
"end": 56,
16795+
"end": 57,
1679616796
"start": 27,
1679716797
"type": "SHORT"
1679816798
},
@@ -16802,18 +16802,18 @@
1680216802
"type": "CLIENT_INITIALIZATION"
1680316803
},
1680416804
{
16805-
"end": 50,
16805+
"end": 51,
1680616806
"start": 41,
1680716807
"type": "REQUEST_INITIALIZATION"
1680816808
},
1680916809
{
16810-
"end": 53,
16811-
"start": 51,
16810+
"end": 54,
16811+
"start": 52,
1681216812
"type": "REQUEST_EXECUTION"
1681316813
},
1681416814
{
16815-
"end": 57,
16816-
"start": 54,
16815+
"end": 58,
16816+
"start": 55,
1681716817
"type": "RESPONSE_HANDLING"
1681816818
}
1681916819
],
@@ -16871,12 +16871,12 @@
1687116871
"regionTag": "analyticsadmin_v1alpha_generated_AnalyticsAdminService_UpdateAttributionSettings_sync",
1687216872
"segments": [
1687316873
{
16874-
"end": 56,
16874+
"end": 57,
1687516875
"start": 27,
1687616876
"type": "FULL"
1687716877
},
1687816878
{
16879-
"end": 56,
16879+
"end": 57,
1688016880
"start": 27,
1688116881
"type": "SHORT"
1688216882
},
@@ -16886,18 +16886,18 @@
1688616886
"type": "CLIENT_INITIALIZATION"
1688716887
},
1688816888
{
16889-
"end": 50,
16889+
"end": 51,
1689016890
"start": 41,
1689116891
"type": "REQUEST_INITIALIZATION"
1689216892
},
1689316893
{
16894-
"end": 53,
16895-
"start": 51,
16894+
"end": 54,
16895+
"start": 52,
1689616896
"type": "REQUEST_EXECUTION"
1689716897
},
1689816898
{
16899-
"end": 57,
16900-
"start": 54,
16899+
"end": 58,
16900+
"start": 55,
1690116901
"type": "RESPONSE_HANDLING"
1690216902
}
1690316903
],

‎samples/generated_samples/snippet_metadata_google.analytics.admin.v1beta.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
],
99
"language": "PYTHON",
1010
"name": "google-analytics-admin",
11-
"version": "0.17.0"
11+
"version": "0.1.0"
1212
},
1313
"snippets": [
1414
{

0 commit comments

Comments
 (0)