CJ Affiliate (Commission Junction)
The Switchboard Commission Junction connector automates access to Advertiser and Publisher Commission reports.
Prerequisites
To configure access to the Switchboard Commission Junction Connector, you need:
- Personal Access Token - The credential used to access automated Commission Junction reports.
- Company ID - The value is specific to your Commission Junction account.
To obtain these credentials, contact your Commission Junction Account Manager.
Scheduling
Commission Junction Connector can be scheduled to run multiple times a day at a user-defined hour and timezone.
- To configure this schedule, use the delay_hours parameter.
- By default, the connector will run once at 6am PT.
Report Types
The following report types are available:
- commission_junction:publisherCommissions
- commission_junction:advertisers
Switchboard Script Syntax
import commission_junction_raw from {
type: "commission_junction:publisherCommissions";
key: "commission_junction_key";
date_filter: "Posting";
company_id: "012345";
metrics: [
"advertiserId",
"advertiserName",
"clickDate",
"clickReferringURL",
"commissionId",
"country",
"eventDate",
"items",
"lockingDate",
"orderDiscountUsd",
"orderId",
"original",
"originalActionId",
"postingDate",
"pubCommissionAmountPubCurrency",
"pubCommissionAmountUsd",
"publisherId",
"publisherName",
"saleAmountPubCurrency",
"saleAmountUsd",
"shopperId",
"source",
"websiteId",
"websiteName"
];
} using {
"advertiserId": integer;
"advertiserName": string;
"clickDate": datetime;
"clickReferringURL": string;
"commissionId": integer;
"country": string;
"eventDate": datetime;
"originalActionId": integer;
"saleAmountUsd": float;
"pubCommissionAmountUsd": float;
"items": json;
"lockingDate": datetime;
"orderDiscountUsd": float;
"orderId": integer;
"postingDate": datetime;
"publisherId": integer;
"publisherName": string;
"shopperId": integer;
"source": string;
"websiteId": integer;
"websiteName": string;
};
Parameters
Parameter |
Description |
Required/Optional? |
date_filter |
A filter used on how report dates should be returned. Currently, "Event", "Locking," and "Posting" values are supported. |
Required |
metrics |
A list of requested metrics. For metrics descriptions, see Commission Detail API Reference Documentation. |
Required |
company_id |
The company ID specific to your reports. For Example: company_id:012345; |
Required |