Reports API Version 2 Attribution
Introduction
The attribution section of the report API allows you to read the active attribution models that have been set for the given IGRP.
List Attribution Models
Returns a list of all attribution models that are active for the given IGRP.
Request:
GET /reports/v2/igrps/{IGRP SPECIFIER}/attribution
URL Path Params
- IGRP SPECIFIER (int) - Installation ID.
GET Params
- filter (array) OPTIONAL - One or more filters.
- sort (array) OPTIONAL - One or more sorting params.
- limit (integer) OPTIONAL - Limit on the result set.
- offset (integer) OPTIONAL - Offset on the result set.
Filter Types
- modelId (int) - Attribution model ID.
- igrp (int) - Installation ID.
- modelName (string) - Attribution model description.
- modelType (string) - Attribution model reference.
- modelStatus (int) - Attribution model status.
Sort Types
Same as Filter Types
Response:
All active attribution models for the given IGRP spec.
- modelId (int) - Attribution model ID.
- igrp (int) - Installation ID.
- modelName (string) - Attribution model description.
- modelType (string) - Attribution model reference.
- matchCriteria (json) - Matching criteria configuration.
- lookbackDays (int) - Lookback time in days.
- modelStatus (int) - Attribution model status.
- createDatetime (string) - Date and time when the Attribution model was created.
- updateDatetime (string) - Date and time when the Attribution model was last updated.
- deleteDatetime (string) - Date and time when the Attribution model was deleted.
- weight (int) OPTIONAL - The assigned weight for the type of model.
- channelsMode (string) OPTIONAL - Config for exluding or including particular channels. Valid values are “exclude” and “include”.
- channels (array) OPTIONAL - List of channel IDs for inclusion or exclusion.
- firstWeight (int) OPTIONAL - First weighting for the attribution model.
- lastWeight (int) OPTIONAL - Last weighting for the attribution model.
{"modelId":"1","igrp":"1","modelName":"Weighted First (exc. PPC)","modelType":"weightedFirst","lookbackDays":30,"weight":4,"channels":[1],"channelsMode":"exclude","matchCriteria":"","modelStatus":"200","createDatetime":"2016-12-01 14:05:57","updateDatetime":"2016-12-02 14:05:57","deleteDatetime":"0000-00-00 00:00:00"}
{"modelId":"2","igrp":"1","modelName":"Bath Tub","modelType":"spread","lookbackDays":90,"firstWeight":2,"lastWeight":3,"channels":[1],"channelsMode":"exclude","matchCriteria":"","modelStatus":"200","createDatetime":"2016-12-01 14:05:57","updateDatetime":"2016-12-02 14:05:57","deleteDatetime":"0000-00-00 00:00:00"}
Read Attribution Model
Returns a single row attribution model for the given IGRP ID and attribution model ID.
Request:
GET /reports/v2/igrps/{IGRP SPECIFIER}/attribution/{ATTRIBUTION SPECIFIER}
URL Path Params
- IGRP SPECIFIER (int) - Installation ID.
- ATTRIBUTION SPECIFIER (int) - Attribution model ID.
Response:
Single row of the attribution model details.
- modelId (int) - Attribution model ID.
- igrp (int) - Installation ID.
- modelName (string) - Attribution model description.
- modelType (string) - Attribution model reference.
- matchCriteria (json) - Matching criteria configuration.
- lookbackDays (int) - Lookback time in days.
- modelStatus (int) - Attribution model status.
- createDatetime (string) - Date and time when the Attribution model was created.
- updateDatetime (string) - Date and time when the Attribution model was last updated.
- deleteDatetime (string) - Date and time when the Attribution model was deleted.
- weight (int) OPTIONAL - The assigned weight for the type of model.
- channelsMode (string) OPTIONAL - Config for exluding or including particular channels. Valid values are “exclude” and “include”.
- channels (array) OPTIONAL - List of channel IDs for inclusion or exclusion.
- firstWeight (int) OPTIONAL - First weighting for the attribution model.
- lastWeight (int) OPTIONAL - Last weighting for the attribution model.
{"modelId":"1","igrp":"1","modelName":"Weighted First (exc. PPC)","modelType":"weightedFirst","lookbackDays":30,"weight":4,"channels":[1],"channelsMode":"exclude","matchCriteria":"","modelStatus":"200","createDatetime":"2016-12-01 14:05:57","updateDatetime":"2016-12-02 14:05:57","deleteDatetime":"0000-00-00 00:00:00"}