Как получить данные маркетинга по электронной почте из Marketo, используя API?

Question

Я пытаюсь получить "Отчет об эффективности электронной почты" с платформы с помощью API для анализа KPI, таких как CTR и т. Д., По типу электронного письма (информационный бюллетень, электронный маркетинг и т. Д.).

Я просмотрел документацию, однако не нашел конечной точки, из которой я могу получить то же самое.

Кто-нибудь знает, есть ли способ получить эту информацию?

Answer 1

Нет конечной точки для непосредственного запроса отчетов. Тем не менее, хорошая новость заключается в том, что "вещи", составляющие "Отчет об эффективности электронной почты", а именно: доставка электронной почты, отказ, открытие и щелчок, доступны для запроса через API.
Это означает, что вам нужно создать отчет самостоятельно, но вы можете получить набор данных для работы.

Эти "вещи" называются типами активности (активность, измеряемая на потенциальной возможности) и могут быть получены путем запроса к конечной точке Get Lead Activities, которая также упоминается как запрос в документах API.
Он сидит на GET /rest/v1/activities.json URL, и вы должны передать nextPageToken и activityTypeIds в качестве параметров запроса.

nextPageToken указывает дату и время Действия после этой даты будут возвращены по телефону. Чтобы получить его, вы должны позвонить в GET /rest/v1/activities/pagingtoken.json, где вам нужно указать самое раннее время и дату, когда нужно извлекать действия. Подробнее о токенах пейджинга.

Чтобы выяснить стоимость activityTypeIds сначала вам нужно получить внутренние идентификаторы интересующих вас типов действий. Для этого вам нужно запросить конечную точку GET /rest/v1/activities/types.json и найти типы действий с имя как Send Email, Email Delivered, Email Bounced, Unsubscribe Email, Open Email а также Click Email, (Я не знаю, меняются ли эти идентификаторы от экземпляра к экземпляру, но у нас они с № 6 до № 11).

Когда у вас есть все эти биты под рукой, вы можете сделать свой запрос следующим образом:

GET https://<INSTANCE_ID>.mktorest.com/rest/v1/activities.json?activityTypeIds=<TYPE_ID>&nextPageToken=<NEXTPAGE_TOKEN>&access_token=<ACCESS_TOKEN>

В результате получается массив с элементами, как показано ниже. Элементы могут быть отфильтрованы по конкретному адресу электронной почты на основе primaryAttributeValue собственности и обрабатываются в дальнейшем соответственно.

{
    "id":7370416,
    "marketoGUID":"7170506",
    "leadId":291305,
    "activityDate":"2017-12-17T00:00:00Z",
    "activityTypeId":11,// #11 = `Click Email`
    "campaignId":1790,
    "primaryAttributeValueId":1638,
    "primaryAttributeValue":"EMAIL_NAME",// Name of the Email as seen in Marketo
    "attributes":[
        // …
    ]
}