多账户专用转化 API 网关控制平面 API:参考文档

对象

Tenant

字段描述

id
字符串

此账户的唯一标识符

name
字符串

此账户的名称

status
整数

可使用 3 个值来表示账户状态:


描述

0

活跃

1

待配置

2

已停用

canPartnerManage
布尔值

此标记表示某个合作伙伴能否管理此账户

users
用户

此账户的用户名单

availableRoles
身份

此账户的可用身份

canEditTenantSettingsInUI
布尔值

此标记表示用户能否修改 Pixel 像素代码、网域等账户设置。

canViewTenantInUI
布尔值

此标记表示用户实际上能否在用户界面中查看账户详情。

canEditTenantUsersInUI
布尔值

此标记表示用户能否在账户用户名单中添加/移除用户或更改其权限。

Tenant
TenantUsage

有关租户使用情况的信息。

User

字段描述

id
字符串

此用户的唯一标识符

email
字符串

用户的邮箱

status
整数

可使用 3 个值来表示用户状态:


描述

0

已停用

1

已激活

2

待处理

roles
身份

用户身份清单

tenants
租户

用户所属的账户

isSelf
布尔值

表示已登录的用户是否是同一用户(使用 API 时,值将始终为 false)。

canBeDeleted
布尔值

表示用户是一个/多个账户的唯一管理员,因此无法删除。

defaultTenantId
字符串

当前用户的默认账户编号。


Role

字段描述

name
字符串

身份的全称。


可以是代理商(合作伙伴)用户或广告主(账户)用户的身份。


身份名称遵循以下格式:

合作伙伴:agency-[ROLE-ACTION]


广告主:advertiser-[ROLE-ACTION]-[tenantId]


[ROLE-ACTION] — 描述了此身份的职责。可使用以下 3 个值之一:

  1. admin
  2. user
  3. view

[tenantId] — 要向用户分配身份的账户的编号

displayName
字符串

此身份的 [ROLE-ACTION]

UserType

描述

AGENCY

适用于合作伙伴/主机

ADVERTISER

适用于租户/账户。

SignalConfig

字段描述

id
编号

格式 SignalConfig:<pixel id> 的唯一标识符

connectionId
字符串

Pixel 像素代码编号

connectionStatus
ConnectionStatus

Pixel 像素代码的连接状态

ConnectionStatus

字段描述

id
编号

Pixel 像素代码连接 ConnectionStatus:<pixel id> 的唯一标识符

connected
布尔值

指示 Pixel 像素代码编号和访问口令是否存在。

active
布尔值

指示 Pixel 像素代码是否正在工作。

eventBridgeActive
布尔值

指示 Event Bridge 对 Pixel 像素代码是否有效。

publishingEnabled
布尔值

指示事件能否发布。

accessKey
字符串

Event Bridge 的访问密钥

apiErrorCode
字符串

发布到 Meta 转化 API 过程中的最后一个错误代码。值将采用格式 <error code>.<error subcode>(参考文档)

pixelID
字符串

Pixel 像素代码的唯一标识符

pixelName
字符串

Pixel 像素代码的名称

accessTokenAvailable
布尔值

指示是否存在发布到转化 API 所需要的访问口令

totalEventsPublished
浮点数

已发布事件总数

lastPublished
浮点数

上个已发布事件的时间戳

totalEventsReceived
浮点数

收到的事件总数

lastReceived
浮点数

上个已收到事件的时间戳

IngressDomain

字段描述

id
编号

入口网域的唯一编号

tenantName
字符串

此账户的名称

ingress
字符串

广告主网域

enhancementTenantIngressVerifiedResult
EnhancementTenantIngressVerifiedResult

参见下文

cnameResolveSuccess
布尔值

广告主网域的 CName 已通过认证

EnhancementTenantIngressVerifiedResult

字段描述

id
编号

格式 <tenantId>:tenantIngressVerified 的唯一编号

tenantIngressVerified
布尔值

表示增强功能的有效域

EventFilter

字段描述

id
字符串

事件筛选条件的唯一标识符

eventName
字符串

事件的名称

pixelId
字符串

此筛选条件将应用到的 Pixel 像素代码。如果此筛选条件将应用到所有 Pixel 像素代码,此字段值将为“null”。

filterState
EventFilterState

事件筛选条件的状态

EventFilterState

PUBLISH

DROP

MIXED

DomainFilter

字段描述

id
字符串

网域筛选条件的唯一标识符

eventName
字符串

网域的名称

pixelId
字符串

此筛选条件将应用到的 Pixel 像素代码。如果此筛选条件将应用到所有 Pixel 像素代码,此字段值将为“null”。

filterState
DomainFilterState

事件筛选条件的状态

DomainFilterState

PUBLISH

DROP

MIXED

EventTrafficSummary

字段描述

id
编号

EventTrafficSummary 的标识符 — 始终表示为 EventTrafficSummary:incoming

eventNamesCount
整数

已收到事件名称的数量

eventsCount
整数

收到的事件总数

ConversionsApiPublishSummary

字段描述

id
编号

ConversionsApiPublishSummary 的标识符 — 始终表示为 ConversionsApiPublishSummary:global

eventNamesCount
整数

已发送事件名称的数量

eventsCount
整数

已发送事件总数

publishSuccessRate
浮点数

事件发布的成功率

EventActivity

字段描述

id
编号

以下格式 EventActivity 的标识符 — EventActivity:<event name>

name
字符串

事件名称

receivedCount
整数

收到的事件总数

publishedCount
整数

已发布事件总数

lastUpdated
字符串

上次更新时间

DomainActivity

字段描述

id
编号

以下格式 DomainActivity 的标识符 — DomainActivity:<domain name>

domainName
字符串

域名

receivedCount
整数

收到的事件总数

publishedCount
整数

已发布事件总数

TenantUsage

字段描述

totalPixels
整数

此账户的 Pixel 像素代码总数

totalActivePixels
整数

此账户的工作中的 Pixel 像素代码总数

totalInactivePixels
整数

此账户的未工作的 Pixel 像素代码总数

tenantUsageByTraffic
TenantUsageByTraffic

按流量划分的租户使用情况

TenantUsageByTraffic

字段描述

totalEventsReceived
整数

一个租户在一段时间内收到的事件总数

totalPixelsWithTraffic
整数

一段时间内具有流量的 Pixel 像素代码总数

publishError
布尔值

一段时间内发布到转化 API 时出现的错误

publishedCount
整数

一段时间内已发布到转化 API 的事件总数

durationInHours
整数

时长

lastUpdatedAt
字符串

上次更新时间