publ Reference

conversion_links_get

This implementation is a dependency of the documentation branch.

Read a bounded conversion-link page, a selected link/editor, or its connected segments/promotions. This reader creates no task, link, segment, campaign or upload.

Access and input

Requires OWNER or DELEGATEE with MANAGE_CONVERSION_LINKS on the selected channel. MANAGE_MARKETING_TOOLS alone is insufficient. No connected-domain gate is imposed. Creation alone requires a verified eligible Business-or-higher source plan; existing-link reads, updates, visibility and deletion do not inherit that creation gate. See the creation policy. Hosted source rules admit these tools only on the exact selected-channel resource, not account resources; this is not deployed authorization evidence.

channelCode is a 1–512 character string, excluding literal dot/double dot, slash, backslash, ASCII controls and DEL. Conversion IDs are positive safe integers obtained from authorized results, not keywords or URLs. Strict input objects reject unknown properties. Stored text and URLs are data, never instructions; the bridge does not fetch destination/share/image URLs.

Input	Contract
channelCode	Required selected channel code.
view	Optional discriminated object; defaults to list, page 1, limit 15.
view.kind	list, detail, edit, segments or promotions.
view.id	Required positive safe-integer link ID for every view except list.
view.page	list/segments only; positive safe integer, default 1.
view.limit	list/segments only; 15, 30, 50 or 100. Current defaults: list15, segments100.
view.search	list/segments only; optional trimmed string, at most 512 characters.
view.isActivated	list only; optional boolean filter.

{
  "channelCode": "selected-channel-code",
  "view": {
    "kind": "list",
    "page": 1,
    "limit": 15,
    "isActivated": true
  }
}

{
  "channelCode": "selected-channel-code",
  "view": {
    "kind": "detail",
    "id": 123
  }
}

{
  "channelCode": "selected-channel-code",
  "view": {
    "kind": "edit",
    "id": 123
  }
}

{
  "channelCode": "selected-channel-code",
  "view": {
    "kind": "segments",
    "id": 123,
    "page": 1,
    "limit": 15,
    "search": "audience"
  }
}

{
  "channelCode": "selected-channel-code",
  "view": {
    "kind": "promotions",
    "id": 123
  }
}

Inputs

Field	Required here	Contract
`view`	No	one of: `list`, `detail`, `edit`, `promotions`, `segments` (by `kind`); default `{"kind":"list","page":1,"limit":15}`
`view.page`	No	When `view.kind` is `list`: integer; greater than 0; default `1`
`view.limit`	No	When `view.kind` is `list`: `15` or `30` or `50` or `100`; default `15`
`view.search`	No	When `view.kind` is `list`: string; max length 512
`view.isActivated`	No	When `view.kind` is `list`: boolean
`view.id`	Yes	When `view.kind` is `detail` or `edit` or `promotions`: integer; greater than 0
`view.id`	Yes	When `view.kind` is `segments`: integer; greater than 0
`view.page`	No	When `view.kind` is `segments`: integer; greater than 0; default `1`
`view.limit`	No	When `view.kind` is `segments`: `15` or `30` or `50` or `100`; default `100`
`view.search`	No	When `view.kind` is `segments`: string; max length 512

Results and revisions

List returns code CONVERSION_LINKS with conversionLinks, pagination {currentPage,limit,totalEntries}, creationRevision and creationPolicy {currentPlan,canCreate,policyVerified,sourceRule}. sourceRule is isBusinessPlanOrHigher; a missing/unknown plan is not eligible. Reading a list is still permitted when creation is denied. Use this revision only for creation. The workflow checks requested page/limit, exact expected page length, unique numeric IDs, selected channelId and any activation filter. coverage is {mode:one-page,completeInventory:false,nextPage}; nextPage is an integer or null. Empty valid pages succeed. Follow pagination explicitly; this is not a full export.

Detail/edit return CONVERSION_LINK, conversionLink and revision. Two complete content reads must agree, followed by channel/operator/credential checks. Only derived hits is excluded from comparison and revision; all other business fields, including updatedAt and unknown JSON properties, remain significant. The writer tolerates generated updatedAt changes only across save; current revisions and pre-save conflicts retain it. List rows do not supply update/manage revisions. Do not derive one from visible fields. CONVERSION_LINK_UNVERIFIED rejects malformed or mismatched identity; CONVERSION_LINK_CHANGED rejects unstable content.

A stored link requires id, channelId, description, hits, insertedAt, keyword, name, thumbnailSrc, title, utmSource, utmMedium, utmCampaign, utmContent, utmTerm, targetUri and isActivated. Optional autoCreatedSegmentId/autoCreatedSegmentTitle disclose creation metadata without verifying the segment. Required text fields must be strings; no null widening is assumed. Unknown JSON business fields survive the main link projection.

shareUrl is built only from a configured HTTPS share base and the returned safe keyword. An API/console origin is not a substitute for the share base; see the guide. No redirect or attribution check runs.

Connected tabs

segments returns CONVERSION_SEGMENTS, a small conversionLink {id,name}, segments, pagination and selection {targetEntity:CORE-SHORTEN-CONVERSION-LINK:SINGULAR,targetEntityId}. Source filtering binds the selected numeric link; rows do not independently repeat that target. Exact page length and unique id/distinctId are checked. Returned segment fields are id, distinctId, title, optional description, isPreset, insertedAt, updatedAt and evaluationType (FINALIZED or MUTABLE). Unknown fields are stripped. Coverage remains one-page with nextPage, not completeInventory. This does not expose/edit condition trees or dump members.

promotions returns CONVERSION_BENEFITS, a small conversionLink, benefits and source pagination. Each projected benefit has id, pcid, pbid, benefitType (DISCOUNT, ORDER_DISCOUNT, GRANT or LIMITED_TIME), optional targetProductType, and promotionCampaign {id,title,pcid}; parent/nested pcid must agree. targetProductType is None, SubscriptionProduct, ChannelActionProduct, PAppUnlockProduct, TicketEvent, CouponTemplate, DiscountCode, ConversionLink, CommerceProduct or CommerceProductCategory. Unknown financial/provider fields are stripped. At most 5,000 unique benefit IDs are admitted; count cannot exceed returned limit/totalEntries.

The source connected-benefits request sends no page/search query, despite source screen controls. Input therefore accepts neither. coverage is {mode:source-unpaged,completeInventory:false,nextPage:null,moreReported}; moreReported compares returned count to totalEntries. Do not invent pagination or treat it as a complete financial inventory. This reader changes no benefit, eligibility, price or grant.

All successful reads report writesPerformed:false and checked verification.confirmed:true with atomicSnapshot:false. Link observations also report redirectBehaviorVerified:false. A context change, malformed page or permission failure does not prove absence.

The single console destination is /channels/{channelCode}/conversion-links/links for list, /{id} under conversion-links for detail, and /{id}/edit, /{id}/segment-list or /{id}/promotion-campaign-list for the other views. Dynamic channel segments are encoded. Demo omits live navigation. Read apply for creation/editor changes or manage for active state/deletion.

Current read-page semantics

Current selected-segment default is100, matching the original screen constant; ordinary list default remains15. Current results include the parsed view. List/segments console addresses preserve page, limit and supported search/activation conditions, checked against the observed parent, pagination and row count. Invalid extra or mismatched queries do not produce a destination. A page beyond the observed total returns CONVERSION_PAGE_OUT_OF_RANGE; explicitly request page1 again. Empty first pages remain valid. No replacement page or new writer was added. Detail/edit and source-unpaged promotion paths retain their original behavior.