Create Sub Tracking ID

POST

/openapi/publisher/v1/tracking-ids/sub

Creates a sub tracking ID (Sub-ID) under a specified primary tracking ID for a Publisher in ArtemisAds.
Sub-IDs enable granular attribution and tracking of link performance among individual promoters or sub-agents within a larger publisher organization.

This is particularly useful when the same ASIN link is distributed by a top-level Publisher to multiple downstream promoters—such as individuals or second/third-level organizations. By assigning different Sub-IDs under the same primary tracking ID, the Publisher can distinguish performance metrics (e.g., clicks, conversions) across different distribution channels, while maintaining unified top-level tracking.

The associated primaryTrackingId must be provided when creating a Sub-ID.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠409Sub Tracking ID already exists

🟠422Input Validation Failed

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.artemisads.com/openapi/publisher/v1/tracking-ids/sub' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx' \
--header 'Content-Type: application/json' \
--data '{
    "primaryTrackingId": "string",
    "subTrackingId": "string"
}'

Response Example

200 - 成功示例

{
  "primaryTrackingId": "primary-id-1",
  "subTrackingId": "sub-id-1-1",
  "productLinkCount": 0,
  "brandLinkCount": 0
}

Modified at 2025-07-04 01:18:19

Create Primary Tracking ID

List Tracking IDs