Re: Where can I find the official documentation for activity types?

Anurag
Level 2

Where can I find the official documentation for activity types?

Open Email, Click Email, Visit Webpage, etc. - is there any official documentation for these and other activity types? One of the answers somewhat makes it clear https://nation.marketo.com/t5/Product-Discussions/Difference-between-Open-Email-Click-Link-and-Click... . I understand that tracking IDs are used to register those activities but I was just wondering if Marketo has listed out all the activity types and provided definitions for them somewhere?

 

Another related question:

I am trying to get a view on how active people (within our database) are but it seems like different activity types sometimes register the same activity (making one activity seem like two or more). Eg: Visited webpage and Click link activity types can register the same link as an activity, but in reality that was a single action. In general, I am wondering if there are any suggestions on how to go about cleaning the activity data to ready it for analysis? I understand that this is a vague question, but any answers are welcome. 

3 REPLIES 3
Oz_Platero
Level 6

Re: Where can I find the official documentation for activity types?

Hello @Anurag ,

 

Q1) Navigate here.  Call the API (you will need to get up to speed on doing so if you are not already familiar).

https://developers.marketo.com/rest-api/endpoint-reference/lead-database-endpoint-reference/#/Activi...

 

{{baseUrl}}/rest/v1/activities/types.json

** Replace {{baseUrl}} with your REST API info.

 

It will give you an array  (see example below)

 "result": [
        {
            "id"1,
            "name""Visit Webpage",
            "description""User visits a web page",
            "primaryAttribute": {
                "name""Webpage ID",
                "dataType""integer"
            },
            "attributes": [
                {
                    "name""Client IP Address",
                    "dataType""string"
                },
                {
                    "name""Personalized URL",
                    "dataType""boolean"
                },
                {
                    "name""Query Parameters",
                    "dataType""string"
                },
                {
                    "name""Referrer URL",
                    "dataType""string"
                },
                {
                    "name""Search Engine",
                    "dataType""string"
                },
                {
                    "name""Search Query",
                    "dataType""string"
                },
                {
                    "name""User Agent",
                    "dataType""string"
                },
                {
                    "name""Webpage URL",
                    "dataType""string"
                }
            ]
        },
        {
            "id"2,
            "name""Fill Out Form",
            "description""User fills out and submits a form on web page",
            "primaryAttribute": {
                "name""Webform ID",
                "dataType""integer"
            },
            "attributes": [
                {
                    "name""Client IP Address",
                    "dataType""string"
                },
                {
                    "name""Form Fields",
                    "dataType""text"
                },
                {
                    "name""Query Parameters",
                    "dataType""string"
                },
                {
                    "name""Referrer URL",
                    "dataType""string"
                },
                {
                    "name""User Agent",
                    "dataType""string"
                },
                {
                    "name""Webpage ID",
                    "dataType""integer"
                }
            ]
 
 
Q2) You will need to make smart lists and reports to filter off your particular interests on how you determine someone to be "active".   A good starting point if you are new to Marketo is to basically do the reverse of what Marketo suggests you use to find possible SPAM traps.  See here for more details on smart lists configurations:
 
thanks,
oz
SanfordWhiteman
Level 10 - Community Moderator

Re: Where can I find the official documentation for activity types?


Eg: Visited webpage and Click link activity types can register the same link as an activity, but in reality that was a single action.

Not so! Clicked Link in Web Page and Visited Web Page in fact have very notable differences.

 

Clicked Link fires when an <a> with a remote href is clicked. That doesn't mean there will be a resulting Visited Web Page.

  • For one thing, the click may just trigger a JS operation.
  • Or the click event may be aborted so nothing (navigation-wise) happens at all.
  • Or the click may result in a file download, which will never trigger a Visited Web Page
  • Or the click may go to a site that isn't running Munchkin.

Visited Web Page runs on any page that can load the instance's Munchkin code. But even when it does get logged, it doesn't have all the information that Clicked Link has.

  • If the source page does not send the Referrer (due to default browser restrictions or deliberate use of the meta referrer tag) then only the Clicked Link will contain the full picture including both the source URL and target URL.
Ajay_Parikh1
Level 3

Re: Where can I find the official documentation for activity types?