Skip to content

Commit 5cd294c

Browse files
authored
Merge branch 'develop' into DOCSPLAT-2990
2 parents 8d884c8 + b860f7c commit 5cd294c

File tree

93 files changed

+944
-1043
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

93 files changed

+944
-1043
lines changed

src/_data/catalog/kotlin_resources.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ items:
1616
categories:
1717
- app
1818
- name: Android AdvertisingId Plugin
19-
url: https://github.com/segmentio/analytics-kotlin/blob/main/samples/kotlin-android-app/src/main/java/com/segment/analytics/next/plugins/AndroidAdvertisingIdPlugin.kt
19+
url: https://github.com/segmentio/analytics-kotlin/blob/1ef79eaf035549d08f91bac4e0a1de8ca6793e7b/samples/kotlin-android-app/src/main/java/com/segment/analytics/next/plugins/AndroidAdvertisingIdPlugin.kt
2020
categories:
2121
- plugin
2222
- name: Screen Recording Plugin

src/connections/auto-instrumentation/configuration.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,21 @@ This guide assumes that you've already added the Signals SDK to your application
1313
> info "Auto-Instrumentation in public beta"
1414
> Auto-Instrumentation is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
1515
16+
> info "Regional availability"
17+
> Auto-Instrumentation isn't supported in EU workspaces.
18+
1619
## Converting signals to events
1720

1821
After you set up the Signals SDK to capture the signals you want to target, you can create rules in your Segment workspace to translate the captured signals into traditional Segment analytics events. These rules are deployed in your application the next time a user launches your app.
1922

23+
The process works like this:
24+
25+
1. The SDK sends raw signals from your app or website to Segment.
26+
2. You build event rules in your workspace that define how those signals should become analytics events.
27+
3. You publish the event rules.
28+
29+
After publishing, Segment analyzes user interactions in your app or website against these rules and automatically generates analytics events when matching interactions occur.
30+
2031
### Getting started with rule creation
2132

2233
1. Ensure you have the `Workspace Owner` or `Source Admin` role in Segment. If your source is connected to a tracking plan, you will also need, at a minimum, the `Tracking Plan Read-only` role. To view the content in the Event Builder tab, you will need, at a minimum, the `Source Read-only` role.
@@ -47,13 +58,11 @@ You can enrich your events by adding properties based on signal metadata. For ex
4758

4859
These properties are sent alongside your event, giving your team deeper insights without requiring any manual instrumentation.
4960

61+
<!-- PW, 6 August 2025: Commenting this section out for now
5062
#### Preview your event rule
5163
5264
To verify that a rule is working as expected, you don't need to enter a cycle of creating and updating the rule, generating signals, then checking the source debugger for the generated event. As you create, edit, or view a rule, you can preview it in real time against the current signal buffer to see which signals match and what the resulting event will look like. Event properties are mapped to the values found in the matched signals, and complete matches are grouped by anonymous ID.
5365
54-
55-
<!-- PW, 6 August 2025: Commenting this section out for now
56-
5766
The Rules Editor also lets you test your rules with recent signals to verify that they produce the data you need before you deploy.
5867
5968
The following example tracks all Screen events:

src/connections/auto-instrumentation/event-builder.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,9 @@ You can use it to create Track, Identify, Page, and other event types directly f
1010
> info "Auto-Instrumentation Private Beta"
1111
> Auto-Instrumentation is currently in Private Beta and is governed by Segment's [First Access and Beta Preview Terms](https://www.twilio.com/en-us/legal/tos){:target="_blank"}. Segment is actively iterating on and improving the Auto-Instrumentation user experience.
1212
13+
> info "Regional availability"
14+
> Auto-Instrumentation isn't supported in EU workspaces.
15+
1316
## Access the Event Builder
1417

1518
The Event Builder appears as a tab within each source, next to the Debugger. If you don't see the Event Builder tab, first confirm that you've installed the required Auto-Instrumentation SDK.

src/connections/auto-instrumentation/index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,9 @@ Auto-Instrumentation simplifies tracking in your websites and apps by removing t
2929
> info "Auto-Instrumentation in public beta"
3030
> Auto-Instrumentation is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
3131
32+
> info "Regional availability"
33+
> Auto-Instrumentation isn't supported in EU workspaces.
34+
3235
## Background
3336

3437
Collecting high-quality analytics data is essential, but traditional tracking setups often fall behind as business needs change. Instrumentation updates take time away from other engineering priorities, and these delays reduce visibility and increase the burden on engineering teams.

src/connections/auto-instrumentation/kotlin-setup.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,9 @@ This guide shows how to install and configure the library, as well as how to ena
1010
> info "Auto-Instrumentation in public beta"
1111
> Auto-Instrumentation is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
1212
13+
> info "Regional availability"
14+
> Auto-Instrumentation isn't supported in EU workspaces.
15+
1316
## Before you start
1417

1518
To use Signals with Android, you need:

src/connections/auto-instrumentation/swift-setup.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,9 @@ Learn how to connect an existing source, integrate dependencies, turn on Auto-In
1010
> info "Auto-Instrumentation in public beta"
1111
> Auto-Instrumentation is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
1212
13+
> info "Regional availability"
14+
> Auto-Instrumentation isn't supported in EU workspaces.
15+
1316
## Step 1: Get your source write key
1417

1518
You need the `writeKey` from an existing Segment source. To find it:

src/connections/auto-instrumentation/web-setup.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,9 @@ Learn how to connect an existing source, integrate dependencies, turn on Auto-In
1010
> info "Auto-Instrumentation in public beta"
1111
> Auto-Instrumentation is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
1212
13+
> info "Regional availability"
14+
> Auto-Instrumentation isn't supported in EU workspaces.
15+
1316
## Step 1: Get your source write key
1417

1518
You need the `writeKey` from an existing Segment source. To find it:

src/connections/destinations/catalog/ab-smartly/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,12 @@ Segment provides specific implementation details for A/B Smartly in the sections
2424
1. From the Destinations catalog page in the Segment App, click **Add Destination**.
2525
2. Search for "A/B Smartly" in the Destinations Catalog, and select the "A/B Smartly" destination.
2626
3. Choose which Source should send data to the "A/B Smartly" destination.
27-
4. Go to the A/B Smartly dashboard(https://your-org-name.absmartly.com/apikey/list){:target="_blank”}, find and copy the "API key" that you created for segment.
27+
4. Go to the A/B Smartly dashboard (`https://your-org-name.absmartly.com/apikey/list`), find and copy the "API key" that you created for segment.
2828
5. Enter the "API Key" in the "A/B Smartly" destination settings in Segment.
2929
6. If the integration requests for an Application name go to your A/B Smartly dashboard (`https://your-org-name.absmartly.com/application/create`) and create an Application named "Segment", or whatever you would like to call it. Use that name in the Application field of the integration settings.
3030
7. Add also your A/B Smartly Collector endpoint. It's the same endpoint that you are using in all your A/B Smartly SDKs.
3131
8. Enter the environment from your Environment list (`https://your-org-name.absmartly.com/environment/list`) that should receive your Segment data. Most likely it will be the production one.
32-
9. And finally a mapping of Segment Identities to A/B Smartly Units(`https://your-org-name.absmartly.com/unit/list`). You should map all of your Segment identities that you would like to use in your A/B tests to the units that you already have in A/B Smartly. Users must map all the identity types, but not for the individual users. Map all of your ids in your Unit List(`https://your-org-name.absmartly.com/unit/list`).
32+
9. And finally a mapping of Segment Identities to A/B Smartly Units (`https://your-org-name.absmartly.com/unit/list`). You should map all of your Segment identities that you would like to use in your A/B tests to the units that you already have in A/B Smartly. Users must map all the identity types, but not for the individual users. Map all of your ids in your Unit List(`https://your-org-name.absmartly.com/unit/list`).
3333
10. Optionally go to "Goal Mapping" and start adding the track calls that you would like to see showing up on A/B Smartly as goals. You only need to create a name mapping if the name of the goal on A/B Smartly's platform is different from the name of the track call in Segment.
3434

3535
## Page

src/connections/destinations/catalog/aboardly/index.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,6 @@ Once the Segment library is integrated with your server, toggle Aboardly on in y
1010

1111
Aboardly supports the `identify` and `track` methods.
1212

13-
- - -
14-
1513
## Identify
1614

1715
When you `identify` a user, we'll pass that user's information to Aboardly with `userId` as Aboardly's External Customer ID. Aboardly recognizes all traits sent by Segment, however in order to send emails you should always add the `email` trait when possible.

src/connections/destinations/catalog/actions-first-party-dv360/index.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ redirect_from: /connections/destinations/catalog/first-party-dv360/
99

1010
Google’s [Display & Video (DV360)](https://marketingplatform.google.com/about/display-video-360/){:target="_blank"} is an end-to-end campaign management tool that enables enterprise customers to plan, measure, and run display and video advertisements. Segment’s integration with DV360 enables Segment customers to sync audiences created in Engage with DV360 for centralized audience management and improved retargeting.
1111

12-
This destination is different from the existing DV360 Actions as it allows you to upload [contact info](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfo){:target="_blank"} and the [mobile device ID](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#mobiledeviceidlist){:target="_blank"}.
12+
This destination is different from the existing DV360 Actions as it allows you to upload [contact info](https://developers.google.com/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#contactinfo){:target="_blank"} and the [mobile device ID](https://developers.google.com/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#mobiledeviceidlist){:target="_blank"}.
1313

1414
This destination can only be used with Engage.
1515

@@ -68,12 +68,15 @@ Segment automatically sends consent as `TRUE` for this destination. Segment use
6868

6969
## Data requirements
7070
Based on Google’s documentation, make sure you send the correct required identifiers:
71-
* [Contact info list requirements](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#contactinfo){:target="_blank"}
71+
* [Contact info list requirements](https://developers.google.com/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#contactinfo){:target="_blank"}
7272
* For example, you must send first name, last name, ZIP code, and country code all together and not just one. Make sure all phone numbers are in [E.164 format](https://en.wikipedia.org/wiki/E.164){:target="_blank"}.
73-
* [Mobile ID Requirements](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#mobiledeviceidlist){:target="_blank"}
73+
* [Mobile ID Requirements](https://developers.google.com/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#mobiledeviceidlist){:target="_blank"}
7474

7575

7676
## FAQs
7777

7878
#### When will my data appear in DV360?
7979
When you complete the connection between Segment and DV360, it can take from 24 to 48 hours for Google to create the user list. This must complete before Segment can begin to sync users into that list.
80+
81+
#### What is membershipDurationDays and its limit?
82+
The duration in days that an entry remains in the audience after the qualifying event. The set value must be greater than 0 and less than or equal to 540.

0 commit comments

Comments
 (0)