Skip to content

Commit 6a568dc

Browse files
authored
Marketo to Adobe stratnav (#1404)
* Add three marketo items to Adobe menu, since it's part of the adobe fam * well that didn't work * combine headings. * doc-138 react native deps * add table for now * cleanup capitalization Co-authored-by: sanscontext <>
1 parent 97c6782 commit 6a568dc

File tree

5 files changed

+61
-15
lines changed

5 files changed

+61
-15
lines changed

src/_data/sidenav/strat.yml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
sections:
33
- slug: adobe
4-
section_title: Adobe Analytics
4+
section_title: Adobe Integrations
55
section:
66
- path: /connections/destinations/catalog/adobe-analytics
77
title: Adobe Analytics destination
@@ -15,6 +15,12 @@ sections:
1515
title: Adobe Analytics Heartbeat
1616
- path: /connections/destinations/catalog/adobe-analytics/best-practices
1717
title: Adobe Analytics best practices
18+
- path: /connections/destinations/catalog/marketo-v2
19+
title: Marketo destination
20+
- path: /connections/destinations/catalog/marketo-static-lists
21+
title: Marketo static lists destination (Personas)
22+
- path: /connections/sources/catalog/cloud-apps/marketo
23+
title: Marketo cloud source
1824

1925
- slug: facebook
2026
section_title: Facebook Integrations

src/connections/destinations/catalog/marketo-static-lists/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: Marketo Static Lists Destination
33
hide-boilerplate: true
4+
strat: adobe
45
---
56

67
> note "Marketo vs Marketo Static Lists Destinations"

src/connections/destinations/catalog/marketo-v2/index.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,13 @@
11
---
22
title: Marketo V2 Destination
3+
strat: adobe
34
---
45

56
## Getting Started
67

78
To start sending data to Marketo, there are two things you must do. **Both of these steps require that you to log in with the Admin Marketo Account.**
89

9-
### 1. Enter your Marketo Credentials into your Destination settings.
10+
### Enter your Marketo Credentials into your Destination settings
1011
We'll need your Munchkin Account ID, Client Secret, and Client ID.
1112

1213
To get your Munchkin Account ID [login to your Marketo account](https://login.marketo.com/), click Admin in the top right corner, then click Munchkin on the left side bar.
@@ -15,12 +16,13 @@ To get your Munchkin Account ID [login to your Marketo account](https://login.ma
1516

1617

1718
To get your Client Secret and Client ID, you must create a role that has full API access, an API only user, and then create a Service in Marketo.
19+
1820
To create a role with full API access:
1921

20-
1. Click Admin in the top right corner.
21-
2. Click Users & Roles on the left side bar.
22-
3. Click on the Roles tab.
23-
4. Click New Role. Name your role and check the API Access box to assign the user full API access. Click Create.
22+
1. Click **Admin** in the top right corner.
23+
2. Click **Users & Roles** on the left side bar.
24+
3. Click on the **Roles** tab.
25+
4. Click **New Role**. Name your role and check the API Access box to assign the user full API access. Click Create.
2426
![](images/cV2x9pHb44g+.png)
2527

2628

@@ -44,7 +46,7 @@ Next, create a Service and get Client Secret and Client ID from that Service.
4446
![](images/c3s0qJ-dDSO+.png)
4547

4648

47-
### **2. You must create a User ID and an Anonymous ID field in Marketo.**
49+
### Create a User ID and an Anonymous ID field in Marketo
4850

4951
1. Click Admin in the top right corner.
5052
2. Click Field Management on the left side bar.
@@ -79,7 +81,7 @@ Here is a sample Javascript `.identify()` call with the all the standard traits
7981
analytics.identify('1234', {
8082
firstName: 'Robyn Rihanna',
8183
lastName: 'Fenty',
82-
email: 'rihanna@badgalriri.com',
84+
email: 'rihanna@example.com',
8385
gender: 'woman',
8486
phone: '555-555-5555',
8587
company: 'Segment.com',
@@ -223,7 +225,7 @@ To upload a list to Marketo, when you are in Lead Database, click All Leads. The
223225

224226
### Migrating from Marketo to Marketo V2
225227

226-
There are a few necessary steps that have to be taken to Migrate from Marketo to Marketo V2.
228+
There are a few necessary steps that have to be taken to migrate from Segment's legacy Marketo v1 destinations, to Marketo V2.
227229

228230
**Important: Make sure you disable Marketo once you are done getting set up with Marketo V2. If you leave both enabled, there will likely be duplicate data in your Marketo account.**
229231

@@ -233,11 +235,11 @@ There are a few necessary steps that have to be taken to Migrate from Marketo to
233235
3. `Track` calls must be mapped in your Destination settings. Our Marketo Destination sent `track` calls as a Munchkin Visit WebPage event in Marketo. In Marketo V2, we'll send your track calls to your Marketo Custom Activities. Detailed instructions [here](/docs/connections/destinations/catalog/marketo-v2/#track).
234236
4. If there are any custom Lead fields that you'd like sent to Marketo in your `Identify` calls, you must add them in your Destination settings. Detailed instructions [here](/docs/connections/destinations/catalog/marketo-v2/#identify).
235237
5. Update anything in Marketo that rely on the way V1 sends `.track()` events to be triggered by your custom activities. For example, our V1 Marketo destination sent track events as a "Visit Web Page" event with `/event/<your_event_name>`. So if you a workflow that is triggered by a "Visit Web Page" event where the web page contains `/event/<your_event_name>`, you'll have to swap out the "Visit Web Page" event trigger you have with your Custom Attribute Trigger. In the right side bar, click the "Custom" folder under "Triggers" and select the trigger that you set for your custom activity:
236-
![](images/cPD4kP65buG+.png)
238+
![](images/cPD4kP65buG+.png)
237239

238240

239-
To figure out what the trigger name for that Custom Activity is, navigate to the admin section of Marketo > Marketo Custom Activities > Click on your activity from the side bar and you'll see the trigger name:
241+
To figure out what the trigger name for that Custom Activity is, navigate to the admin section of Marketo > Marketo Custom Activities > Click on your activity from the side bar and you'll see the trigger name:
240242

241-
![](images/cg6YhDEPWXv+.png)
243+
![](images/cg6YhDEPWXv+.png)
242244

243245
6. When enabling Marketo V2, because of the way Marketo's API works, there is potential to create duplicate leads, especially when the first enabling the destination. For ways to prevent this, check out the Preventing Duplicate Leads.

src/connections/sources/catalog/cloud-apps/marketo/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title: Marketo Source
33
rewrite: true
44
source-type: object
5+
strat: adobe
56
---
67
<!-- Marketo is listed as an object source, but doesn't appear in our configapi source catalog, so leave the "source-type" set here -->
78

src/connections/sources/catalog/libraries/mobile/react-native/index.md

Lines changed: 39 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,10 @@ This is why even if you see events in the debugger, the Device-mode destination
4848
> warning "React-Native version requirement"
4949
> You must use React version 0.62 or later.
5050
51+
52+
> info "Good to know - Device-mode destinations"
53+
> Segment's React Native library serves as a wrapper around the two mobile libraries for iOs and Android. If you plan to [bundle device-mode destinations](#packaging-destinations-using-device-mode) you must add these dependencies.
54+
5155
### iOS configuration
5256

5357
You should use CocoaPods (**recommended**) to manage your installation and dependencies for iOS.
@@ -99,9 +103,9 @@ To install Analytics-React-native manually:
99103

100104
### Packaging Destinations using Device-mode
101105

102-
By default, Analytics-React-Native sends all of your data first to the Segment servers, which forward the data on to any tools you enabled from the Segment web app. It does not package any external destination SDKs by default. This is known as using "Cloud-mode", and it helps reduce the size of your project.
106+
By default, Analytics-React-Native sends all of your data first to the Segment servers, which forward the data on to any tools you enabled from the Segment web app. It does not package any external destination SDKs by default. This is known as sending your data using "Cloud-mode", and it helps reduce the size of your project.
103107

104-
However, in order to function correctly some destinations require that you include code in your project that can be executed on the user's device. This is known as "device-mode". Other destinations offer a device-mode SDK, but still work (with reduced features) in cloud-mode.
108+
However, some destinations require that you include code in your project that can be executed on the user's device so that these tools can function correctly. These destinations run code that sends data directly to the destination's API endpoints, as well as sending a copy to the Segment servers for archiving. This is known as sending data in "device-mode". Other destinations offer a device-mode SDK, but still work (with reduced features) in cloud-mode.
105109

106110
You can read [more about connection modes](/docs/connections/destinations/#connection-modes) in the Destination documentation.
107111

@@ -110,7 +114,11 @@ You can read [more about connection modes](/docs/connections/destinations/#conne
110114
111115
To use a device-mode destination, you add the destination's SDK to the project. You can find information about these in the destination information pages in the Segment app. Any mobile destination with a Device-mode option includes information on how to bundle SDK.
112116

113-
These usually take the form of a dependency manager command, like the NPM example below.
117+
Segment's React Native source library is a wrapper for the iOS and Android source libraries, and the React Native device mode SDKs you bundle are generated from the iOS and Android ones.
118+
119+
To use device-mode destinations with React Native, you must add the dependencies for iOS and Android. Once you set up the device mode dependencies for iOS and Android, you can then add the React Native dependency. See the [device mode documentation in the React Native readme](https://github.com/segmentio/analytics-react-native/#packaging-device-mode-destination-sdks) for more details.
120+
121+
To add the device-mode dependencies, install the pods for iOS builds, and add the dependencies to your `build.gradle​` file in your Android project. You might also be able to use a dependency manager command, like the NPM example below.
114122

115123
```bash
116124
yarn add @segment/analytics-react-native-{bugsnag,branch,google-analytics}
@@ -131,6 +139,34 @@ await analytics.setup('YOUR_WRITE_KEY', {
131139
})
132140
```
133141

142+
#### Destinations that support device-mode for React native
143+
144+
145+
| Name | iOS | Android | npm package |
146+
| ------------------- | --- | ------- | ----------------------- |
147+
| Adjust ||| `@segment/analytics-react-native-adjust` |
148+
| Amplitude ||| `@segment/analytics-react-native-amplitude` |
149+
| Appboy ||| `@segment/analytics-react-native-appboy` |
150+
| AppsFlyer ||| `@segment/analytics-react-native-appsflyer` |
151+
| Branch ||| `@segment/analytics-react-native-branch` |
152+
| Bugsnag ||| `@segment/analytics-react-native-bugsnag` |
153+
| CleverTap ||| `@segment/analytics-react-native-clevertap` |
154+
| ComScore ||| `@segment/analytics-react-native-comscore-ios` |
155+
| Countly ||| `@segment/analytics-react-native-countly` |
156+
| Crittercism ||| `@segment/analytics-react-native-crittercism` |
157+
| Facebook App Events ||| `@segment/analytics-react-native-facebook-app-events-ios` |
158+
| Firebase ||| `@segment/analytics-react-native-firebase` |
159+
| Flurry ||| `@segment/analytics-react-native-flurry` |
160+
| Google Analytics ||| `@segment/analytics-react-native-google-analytics` |
161+
| Intercom ||| `@segment/analytics-react-native-intercom` |
162+
| Localytics ||| `@segment/analytics-react-native-localytics` |
163+
| Mixpanel ||| `@segment/analytics-react-native-mixpanel` |
164+
| Quantcast ||| `@segment/analytics-react-native-quantcast-android` |
165+
| Taplytics ||| `@segment/analytics-react-native-taplytics-ios` |
166+
| Tapstream ||| `@segment/analytics-react-native-tapstream-android` |
167+
168+
169+
134170
Now that the library is installed and some SDKs are set up, you're ready to learn about the Segment Tracking methods.
135171

136172

0 commit comments

Comments
 (0)