Create Primary Tracking ID

POST

/openapi/publisher/v1/tracking-ids/primary

Creates a primary tracking ID for a Publisher account in ArtemisAds.
This tracking ID acts as a top-level identifier that helps large organizations and agencies manage multiple sub-level promoters under the same Publisher account.

In cases where a Publisher organization distributes product links to multiple individual promoters—or even nested sub-organizations (e.g., second or third-level agents)—a primary tracking ID allows for structured attribution and reporting across all downstream promoters.

Once created, this ID can be referenced by sub tracking IDs (Sub-IDs) to enable granular tracking of promotion performance for the same ASIN across different agents under the same Publisher.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠409Primary Tracking ID already exists

🟠422Input Validation Failed

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - 成功示例

{
  "primaryTrackingId": "primary-id-1",
  "productLinkCount": 0,
  "brandLinkCount": 0,
  "subTrackingIds": null
}

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

List Brands

Create Sub Tracking ID