Merge pull request #4612 from segmentio/fixes-on-marketo-source

update marketo source doc faqs

Author: pwseg

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

@@ -278,36 +278,32 @@ Currently, Warehouses are the only supported destination for object-cloud source
 
 ## FAQs
 
-### How many API calls will the Segment source use?
+### How many API calls will the Segment source use to sync all my data?
 
-The Marketo API has different limits for the number of objects returned by different endpoints, but usually 100-300 objects per call.
+Segment doesn't provide statistics for these consumed API calls, since Segment systems only log the number of objects pulled from Marketo as throughput.
 
-At set up time, you have the option to specify a cap to the API calls that a source can consume. If no cap is specified, Segment consumes as many API calls that are available to sync the entire source.
+### Can I limit API usage on the source?
 
-Segment uses the Lead Activities bulk API to reduce the number of requests needed to sync the data; this however, also has a limit of 500MB worth of files downloaded per day.
+Yes. You can specific a daily limit to the API calls the source will consume. If you don't set a limit, Segment will, by default, consume as many API calls as are available in the limit you agreed to with Marketo to sync the entire source.
 
-If your source requires more than 10k calls or over 500MB from the bulk API to sync, Segment continues the sync the following day when a new batch of API calls are available.
+Segment also uses the `Lead` and `Activity` [Bulk Extract APIs](https://developers.marketo.com/rest-api/bulk-extract/){:target="_blank"} to reduce the number of requests needed to sync the data. For these syncs, Segment has a limit of 500 MB worth of files downloaded per day.
 
-If you have other applications that use the Marketo API, this can interfere with their ability to make requests.
+### What if my daily Marketo API quota isn't enough?
 
-### What Marketo API are you using?
+If your source needs more than 10,000 REST API calls or more than 500 MB of data to sync, Segment will continue the sync when a new batch of API calls is available.
 
-Segment uses the REST API in most situations, but also uses the Lead Activity Bulk API to reduce the number of requests needed to sync.
+Marketo's API quota applies across your subscription. If other applications share the quota, it could interfere with Segment's ability to sync the source.
 
-### Can I get other collections not default synced by the source?
+### Why can't I find the `lead_activities` table in my data warehouse? does Segment not ingest it?
 
-[Contact Support](https://segment.com/help/contact/) to request additional collections.
+You first need to enable the **Activity Type IDs (optional)** setting in the Marketo source, which must be enabled for Segment to pull the `lead_activities` collection source. Once Segment pulls the data, it will be available in your data warehouses.
 
-### Can I get other columns not default synced by the source?
-For leads and activities, Segment added  a custom fields setting where you can enter comma-separated custom fields to sync by their REST API name.
+### Can I get other collections synced by the source?
 
-By default, Segment syncs the following fields on the leads collection:
+[Contact Support](https://segment.com/help/contact/){:target="_blank"} to get additional collections added to your source.
 
-- `id`
-- `email`
-- `firstName`
-- `lastName`
-- `createdAt`
-- `updatedAt`
+### Can I get other columns synced by the source?
 
-You can find a full list of standard fields and their REST API names [here](http://developers.marketo.com/rest-api/lead-database/fields/list-of-standard-fields/). If there are other fields you're interested in, [contact support](https://segment.com/help/contact/)  for assistance.
+Yes. For `leads` and `activities`, choose **Custom Lead Fields (optional)**, which lets you enter comma-separated custom files that will be synced by Marketo's REST API name.
+
+View [Marketo's List of Standard Fields documentation](http://developers.marketo.com/rest-api/lead-database/fields/list-of-standard-fields/){:target="_blank"} for a complete list of standard fields and Marketo's REST API names. [Reach out to Segment support](https://segment.com/help/contact/){:target="_blank"} if you're interested in other fields.