跳到主要内容

直客账号


0 整体流程

interface_prepare_01



1 上报前

1.1 获得数据源

概念介绍

数据源是在 DataNexus 中操作数据上报、数据量级查看、数据授权、数据分发的载体,您可以基于网站、应用、线下、小程序/公众号/小游戏等建立对应的数据源,上报对应场景下的用户数据、商品数据、订单数据等,并将上报的数据作为资产授权给其他账号或分发给各应用场景。

数据源类型可创建数量应用限制
微信按小程序/公众号/小游戏/视频号 的 AppID 维度创建,每个投放账号下每个 AppID 只可创建 1 个
App按 iOS/Android 的 AppID 维度创建,每个投放账号下每个 AppID 只可创建 1 个
Web每个账号下只可创建 1 个
线下无限制不可用于转化归因

操作步骤

数据源支持以下两类操作。

  1. 非首次上报数据

    数据源接入 页面,通过搜索数据源名称、ID,筛选数据源类型,找到列表可复用的数据源信息。

interface_prepare_02


  1. 首次上报数据

    数据源接入 页面,点击【新建数据源】按钮,按提示完成操作,在列表中看到您刚添加的数据源信息,说明新建成功。

interface_prepare_03


判断是否首次上报请参考以下描述。

客户端类型是否首次上报
微信该客户端的 AppID 在该投放账号下是否已新建过微信数据源
App该客户端的 AppID 在该投放账号下是否已新建过 iOS/Android 数据源
Web该投放账号下是否已新建过 Web 数据源


1.2 开启数据源分发开关

概念介绍

将某个数据源的数据分发至您指定的应用场景进行使用。


操作步骤

资产分发支持以下两类场景的操作。

  1. 资产分发 页面新建数据源后,根据弹框提示,点击【前往分发】,快速开启资产分发的相关配置 。

interface_prepare_04


  1. 从目录的数据资产 - 资产分发进入 资产分发 页面,进行资产分发的相关配置。

interface_prepare_05


重要

当前您已明确数据上报的目标(应用场景),请在数据上报前开启资产分发开关。若数据上报时,状态仍为“分发已关闭”,您已上报至该数据源 ID 的数据将无法分发给指定应用场景。


2 上报中

2.1 获取 access_token

2.1.1 概念介绍

Token 是在 Marketing API 操作指定账号的身份凭证,当您需要操作特定广告账号时(包括上报数据),您需要使用该广告账号对您的开发者应用进行授权,以获取 access_token 和 refresh_token。或请您的开发者登录 DataNexus,授权 DataNexus 代为生成永久token。所有接口均通过请求参数中传递的 access_token(授权令牌)来进行身份认证和鉴权。


2.1.2 操作步骤

获取 access_token 支持以下两类操作。

  1. 通过 DataNexus 代为生成永久密钥

    当接口权限集 = 数据上报(User Actions)时,在 数据源接入 页面,点击 【查看密钥】,获得 token 信息。

interface_prepare_08


  1. 自行生成密钥

    当接口权限集 ≠ 数据上报(User Actions),请 通过 Oauth 2.0 获得 access_token 引导完成操作 。


权限集 = 数据上报(User Actions)的接口示例

行为:user_actions/add

订单:order/add,order_after_sale/add

数据源:user_action_sets/add,user_action_sets/get



2.2 上报数据

查看 上报 API 开发指引



3 上报后

3.1 核对数据量

操作步骤

  • 若同一时间段内,页面展示的数据条数 = 自己上报的数据条数,则说明数据上报完成,并请告知发起数据上报的需求方;
  • 若不相等,则说明数据上报异常,请检查接口的 返回码 。点击右下角【反馈工单】,可获得进一步帮助。

interface_prepare_09




FAQ

Q:没有「DataNexus」的账号,该如何处理?

A:请前往 腾讯广告 注册成为广告主。


Q:广告主注册流程复杂/暂不想投放广告,只想先上报数据,该如何处理?

A:数据上报类型账号暂未开放注册。可点击右下角的【反馈工单】向我们反馈您的诉求。


Q:使用「DataNexus」的密钥信息,接口返回“The API you requested is out of the scope of authority”,该如何处理?

A:该信息意为您的接口超出了授权范围,即接口的权限集 ≠ 数据上报(User Actions),请自行通过 Oauth 2.0 获得 access_token。


Q:非”数据上报(User Actions)“的接口获取 access_token 遇到问题,需要技术指导,该如何处理?

A:可点击右下角的【反馈工单】寻求技术答疑支持。




该内容是否有帮助?