Skip to content

Commit eff7b54

Browse files
committed
DOC-240 cleanup
1 parent f88391c commit eff7b54

File tree

3 files changed

+10
-58
lines changed

3 files changed

+10
-58
lines changed

src/_data/actions/amplitude.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -72,15 +72,15 @@ config:
7272
- device-mobile
7373
configurable: true
7474
location: "Subscription **Group Identify User**."
75-
notes: Select a value in the **Group Type** actions field.
75+
notes: Select a value in the **Group Type** actions field. This field is mandatory in Amplitude (Actions). In the Amplitude Classic destination, ommiting a value for property field resulted in Amplitude creating a group called `[Segment] Group`.
7676
- name: Group Value Trait
7777
connection_mode:
7878
- cloud
7979
- device-web
8080
- device-mobile
8181
configurable: true
8282
location: "Subscription **Group Identify User**."
83-
notes: Select a value in the **Group Value** actions field.
83+
notes: Select a value in the **Group Value** actions field. This field is mandatory in Amplitude actions. In the Amplitude Classic destination, ommiting a value for this property resulted in an alpha-numeric value.
8484
- name: Traits to Append
8585
connection_mode:
8686
- cloud
@@ -173,7 +173,7 @@ config:
173173
connection_mode:
174174
- cloud
175175
- device-web
176-
- device mobile
176+
- device-mobile
177177
configurable: true
178178
location: Global Setting
179179
notes: ""

src/_includes/components/actions-map-table.html

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
{% assign configMap = site.data.actions.amplitude.config %}
2+
{% assign conModes = site.data.actions.amplitude.config| map: 'settings' | map: 'connection_mode' | uniq | compact%}
23

34
<style>
45
tr.no-map td {
@@ -66,11 +67,9 @@
6667
<input class="table-search" type="text" id="filterInput" onkeyup="searchFilter()" placeholder="Search for setting..">
6768
<div class="button-container" id="btnContainer">
6869
<a href="#" id="all" class="button button-link active">All</a>
69-
<a href="#" id="true" class="button button-link" >Configurable</a>
70-
<a href="#" id="false" class="button button-link" >Not Configurable</a>
71-
<a href="#" id="cloud" class="button button-link">Cloud</a>
72-
<a href="#" id="device-web" class="button button-link" >Device-web</a>
73-
<a href="#" id="device-mobile" class="button button-link" >Device-mobile</a>
70+
{% for mode in conModes %}
71+
<a href="#" id="{{mode}}" class="button button-link">{{mode | capitalize}}</a>
72+
{% endfor %}
7473
</div>
7574

7675
<table id="settingsTable">
@@ -93,8 +92,7 @@
9392
id="settingRow">
9493
<td>{{setting.name}} <br /> {% for mode in setting.connection_mode %}<span
9594
class="cmode {{mode}}-mode">{{mode | capitalize}}</span> {% endfor %}</td>
96-
<!-- <td>{{setting.configurable}}</td> -->
97-
<td>{% if setting.location %}{{setting.location | markdownify}} <br /> <br /> {% endif %}{{setting.notes | markdownify}}</td>
95+
<td>{% if setting.location %}{{setting.location | markdownify}} <br /> {% endif %}{{setting.notes | markdownify}}</td>
9896
</tr>
9997
{% endfor %}
10098
{% endfor %}

src/connections/destinations/catalog/actions-amplitude/index.md

Lines changed: 2 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -207,7 +207,7 @@ This Action sets the user ID for a specific device ID, or updates the user prope
207207

208208
{% comment %}
209209
### Merge users with Anonymous ID and User ID
210-
<!-- MZ 7/29: Identify User does not have a field for Anonymous ID -->
210+
<!-- MZ 7/29: Anonymous id is in the coalesce function in Device ID -->
211211
To have Amplitude recognize an anonymous user and a known or logged-in user, make sure you include both the user’s `userId` and the `anonymousId` they had before that in your Identify call. If you don’t include the anonymousId, Amplitude can’t tell that the anonymous user is the same person as the logged-in user.
212212

213213
If you’re using a Segment server library or the Segment HTTP API, you must explicitly include both anonymousId and userId. If you’re using Analytics.js in device-mode, or a bundled SDK, Segment automatically includes anonymousId for you.
@@ -262,55 +262,9 @@ To use Amplitude's groups with Segment, you must enable the following Action set
262262

263263
## Migration from Amplitude Classic
264264

265-
Most of the classic Amplitude destination settings were related to device-mode collection (for example, batching or Log Revenue V2), and do not apply to the Amplitude (Actions) destination, which runs in cloud-mode. The following sections discuss how to replicate the old settings where possible.
265+
Configuration of the Amplitude (Actions) destination is done through Filters and Actions. Consult the table below for information about configuring your Amplitude (Actions) destination similarly to your classic Amplitude destination.
266266

267267
> info ""
268268
> Contact Segment support if you find features missing from the Amplitude (Actions) destination that were available in the classic Amplitude destination.
269269
270-
### Track Named, Categorized, or All Pages or Screens
271-
272-
The default Amplitude (Actions) subscription sends *all* Page and Screen calls.
273-
To replicate the old behavior, change the trigger to include only events that contain `name` or `category`.
274-
275-
### Prefer Anonymous ID for Device ID
276-
<!-- do we wanat to show obj-c code here? -->
277-
278-
To replicate the old behavior, change the mapping for Device ID field.
279-
Default:
280-
```objc
281-
'@if': {
282-
exists: { '@path': '$.context.device.id' },
283-
then: { '@path': '$.context.device.id' },
284-
else: { '@path': '$.anonymousId' }
285-
}
286-
```
287-
288-
### Use AdvertisingId for DeviceId
289-
290-
To replicate the old behavior, change the mapping for Device ID field.
291-
Default:
292-
```objc
293-
'@if': {
294-
exists: { '@path': '$.context.device.id' },
295-
then: { '@path': '$.context.device.id' },
296-
else: { '@path': '$.anonymousId' }
297-
}
298-
```
299-
300-
301-
### Location Tracking
302-
303-
Location Tracking is a feature of Amplitude’s mobile SDKs and is not supported in Amplitude (Actions) which run in cloud-mode only.
304-
This setting required that the user grant location permission for the mobile app. This is different from the IP-based location lookup that Amplitude can perform.
305-
306-
To work around this limitation, send `context.location.latitude` and `context.location.longitude` from your app, and let Amplitude perform the lookup.
307-
308-
### Legacy Group Behavior
309-
310-
If you don't provide “Amplitude Group Type/Value Trait”, or one of the traits was not provided in the Group call, then Segment associated the user with a group with the type `[Segment] Group` and with the value `(Group Id)`. No properties are associated with that group.
311-
312-
For example, the previous group call would associate the user with a group of type `[Segment] Group` and value `082108c8-f51e-485f-9d2d-b6ba57ee2c40`.
313-
314-
These fields are mandatory in the Group Identify User action, and the action can't run unless they are provided.
315-
316270
{% include components/actions-map-table.html %}

0 commit comments

Comments
 (0)