2017-07-26 3 views

Antwort

1

Es gibt keinen Endpunkt für die direkte Abfrage von Berichten. Die gute Nachricht ist jedoch, dass die "Dinge", die einen "E-Mail-Leistungsbericht" ausmachen, nämlich E-Mail-Zustellung, Bounce, Öffnen und Klicken, über die API abgefragt werden können.
Dies bedeutet, dass Sie den Bericht selbst erstellen müssen, aber Sie können das Dataset abrufen, um daran zu arbeiten.

diese „Dinge“ sind Aktivitätstypen (Aktivität auf einem Blei gemessen) bezeichnet und kann durch Abfragen gegen den Get Lead Activities Endpunkt geholt werden, die auch als die Query in der API-Dokumentation erwähnt wird.
Es sitzt an der GET /rest/v1/activities.json URL und Sie müssen eine nextPageToken und die activityTypeIds als Abfrageparameter übergeben.

Die nextPageToken zeigt eine Datetime an. Aktivitäten nach diesem Datum werden von dem Anruf zurückgegeben. Um eins zu erhalten, müssen Sie einen Anruf an GET /rest/v1/activities/pagingtoken.json tätigen, wo Sie das früheste Datum angeben müssen, von dem die Aktivitäten abgerufen werden sollen. Sehen Sie mehr über .

Um den Wert activityTypeIds herauszufinden, müssen Sie zuerst die interne Ids des Leistungsart s Sie in. Um dies zu tun, sind daran interessiert, erhalten müssen, müssen Sie die GET /rest/v1/activities/types.json Endpunkt abzufragen und sucht die Leistungsart s mit Namen s wie Send Email, Email Delivered, Email Bounced, Unsubscribe Email, Open Email und Click Email. (Ich weiß nicht, ob diese Ids von Instanz zu Instanz wechseln, aber in unseren sind diese von # 6 bis # 11).

Sobald Sie alle diese Bits zur Hand haben, können Sie Ihre Anfrage so machen:

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

Das Ergebnis ist wie unten ein Array mit Elementen gibt. Artikel können anhand der primaryAttributeValue-Eigenschaft zu bestimmten E-Mails gefiltert und entsprechend weiterverarbeitet werden.

{ 
    "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":[ 
     // … 
    ] 
} 
Verwandte Themen