StarRouter Conversions API使用手册

StarRouter Conversions API支持AB站点的数据回传，该功能适用于投放Meta广告；目前仅支持Shopify跳Shopify的AB站点。后续会开放支持更多的建站系统以及自定义转化事件。

在使用该系统之前，请联系管理员开放使用权限，该功能为附加工具，需要额外进行付费使用。

在开始接入之前，建议大家使用一个记事本/备忘录记录以下数据：

• Meta pixel ID（像素ID）
• Meta pixel Access token（访问口令）
• Shopify Client ID（Shopify app id）
• Shopify Client Secret（API密钥）

以上信息的获取操作将会在接下来的步骤中有具体的操作引导！

安装Meta pixel（安装像素）

这一步很简单，在Shopify的后台，安装Facebook&instagram的app，然后正常去设置连接你的像素ID即可；

Meta pixel ID&Meta pixel Access token获取

回到Meta广告账户的管理端，我们需要获取两个信息，像素id大家都知道，另外一个是CAPI 使用服务器回传数据的访问口令，这个口令大家可以保存好。

在广告户后台——事件管理工具——数据集——选择对应的像素——设置
按照上述路径，找到图中设置直接集成，选择使用 Dataset Quality API 进行设置 然后点击生成访问口令，这个口令生成完成之后，用记事本或者备忘录记一下，因为后续只会生成新的口令；

接下来往下滑，找到白名单，将你的A站和B站的域名添加到白名单；

Shopify应用创建｜id和密钥获取

因为Shopify的官方政策，如果要上架一款app到官方的商店，审核很慢并且很麻烦，而且这种工具不一定会审核通过；但是为了大家的店铺数据安全，我们选择的是让大家在自己的商店去创建一个app应用，有专属的id和密钥。

这个应用只需要在你的B站创建
Shopify后台——设置——应用——开发应用

选择Dev Dashboard 中构建应用

应用 URL:https://star.auont.com/api/shopify/install
权限范围:read_orders,write_orders,read_products
可选权限范围：read_orders,write_orders,read_products
重定向 URL：https://star.auont.com/api/shopify/auth/oauth/callback

请选择“使用旧版本安装流程“
然后点击发布即可；

点击左侧的设置，我们就能看到客户端ID和加密密钥，同样记录下来这些内容；

点击刚刚创建的应用，然后点击选择分发方式，之后选择自定义分发，并且输入你b站的myshopify.com的二级域名，进行安装这个应用；

在API访问请求这边，申请一个访问订阅API权限，申请的理由随便填写，比如“提供CAPI回传数据到Meta，利于广告学习….” 提交完就可以，不用去等待审核。

系统后台链接CAPI

回到我们的系统后台，点击Conversions API然后添加应用

填写相关信息
所属店铺：你需要使用CAPI的B站
应用名称 ：这个你填写一个方便自己记的名称
Client ID ：Shopify创建的应用客户端ID
Client Secret：Shopify创建的应用加密密钥
Pixel ID：你的像素ID
Pixel Access Token：你像素的访问口令

填写完之后点击创建；

点击这个小铃铛，然后订阅掉这里所有的主题事件

这样B站的CAPI就算是部署完成，在B站中产生的成功转化数据都会被回传到Meta，如果有多个B站，可以将这个应用分发到其他的B站安装，然后挨个在跳转后台去创建应用，选择对应的B站就可以。
注意，如果有多个b站添加，记得在广告户管理后台给这些b站的域名添加一个白名单！