所有文章 > API设计 > 如何通过CD平台如何将数据以API的方式同步到facebook

如何通过CD平台如何将数据以API的方式同步到facebook

如何将CD转化通过API同步数据到fb 

分为两步:

1.    添加affiliate的BM账户信息

2.    配置从CD平台传输到用户Event Manager的参数

这些参数可以在affiliate后台配置,也可在管理平台配置。

在管理平台,我们添加了配置必填字段的功能。在affiliate后台,添加了选项用于扩大传输转化数据。

准备好CD后台需要填写的参数

想要对接设置成功,首先需要在Facebook建立一个APP, 利用该APP生成API请求需要的参数,创建events事件。

第1步 – 建立一个app

通过开发者账户建立一个新的APP(详述用于集成对接的App)

  • 应用种类 -Business
  • App Purpose:选择自己或者自己的企业
  • BM账户 – 指定用于集成到平台的FB 账户

在平台进一步集成,需要获取App其他信息。选择Settings – Basic.

举个栗子:

●    App ID – 168045915497604

●    App Secret:

dc84363ba7abfb08a1b663c6b036e8b9

第2步 – 获取Access Token

新建一个系统用户:

  1. 点击下面链接,选择用于建立app的BM账:https://business.facebook.com/settings
  2. 侧栏菜单选择User – system Users, 点击Create键(将显示系统用户配置窗口)
  3. 指定用户名称并设置管理员

获取参数

  • 选择之前创建的用户
  • 选择 Add assets, 会弹出设置页面
  • Assets Type 栏选择app, 在Assets栏选择之前创建的app(截图以CD app为例),在最后一个设置manage app选项勾选。
  • 保存设置,选择Generate new token 生成参数。
  • Generate new token页面,选择CD app(设置的app名字),选择ads_read权限(广告阅读权限)。
  • Access token 设置保存之后,会生成系统所需的代码

Access token 栗子:

 EAACY1j0ZAZAIQBAJlDIdDZAGB1ZCKgP8886ItTkztf9oamaJuoSd7jXLjst6ExWUoTmA32bARWUZAVepmeMpNhJsQMXJVwJImLCeJW6jPAW1Jvf6Twan0PPzSQkjyBxNCZB855K02ZA7SgAPPw7jPWugdKA2AIeZCDNrAwZAsmgTNlwv7m1roWQVP

重要提示:

保存此代码,因为在关闭模式窗口进行复制后它将不可用(需要再次生成)。
此代码的有效时间不到 2 小时,一旦代码添加到平台,我们的系统会自动将其转换为有效期为 60 天的参数。

重要提示!!!!

在第 1 步和第 2 步中为设置选择的FB BM账户必须相同。

将 FB BM 添加到 ClickDealer 平台

创建app生成access token之后,进入CD后台填写数据,与 Facebook 集成用于同步转化的API

点击Add new account 新建账户-按钮1(CD后台),填写信息。

  • Facebook Business manager:输入账户名称。可以自定义,可与fb上不一样。
  • Access token:是在fb上配置后获得的参数(前面第2步设置后获得的代码)
  • App Id:在fb开发者账户中创建的app的唯一编号。必须与用于生成访问代码的编号相同。按照第1步(App ID 段落)中的说明获取编号
  • App Key:用于生成access code的App的密码。用步骤 1(App Secret)中的说明获取此代码检查数据输入是否正确,点击Configurate按钮。将发送一个请求检查回传的数据。
    如果数据输入正确,则显示成功,对接状态将显示“Yes”。

设置FB通过API回传转化(SM Campiagn)

启用和添加强制设置以回传事件创建请求(在CD系统中创建转换之后)只能在的 SM 级别

  1. Campaign层面 – FB集成
  2. 非默认event层面 – 配置
  3. smartlink campaign层面 – FB 集成部分

1.要在所需层面启用集成状态,必须将 FB集成状态更改为“是”

2. 选择所需FB BM,用于发送FB事件。如添加多个账户,请确保选择了正确的账户。

3. 设置发送到事件FB pixel ID,可以是固定值(如果FB账户设置了单个pixel)。设置动态,需在点击CD平台campaign链接时选择参数,设置pixel对应参数。

4. FB event名称设置,需选择与上面指定的pixel匹配的event(列表有标准 FB event名称)。

如果使用标准名称以外的event名称,可在自定义event栏编辑。

5. Action source 栏需输入转化点信息,默认设置为“website”,但这个参数可以修改。参数的详细说明:

https://developers.facebook.com/docs/marketing-api/conversions-

api/parameters/server-event#action-source

6. Event ID 栏需要回传与每次转化相关的唯一参数。在 fb端对参数进行去重时将使用传输的值

7. 需要Event source URL设置需向FB端发送有关转换页面的信息。

默认值是由广告商设置的,但每个aff可选择用自己的链接。

为此,需将设置重新定义为 Event source URL = Value 并输入链接。

重要提示:

输入链接的域名必须已经通过Facebook 验证

发送请求(campaign)的逻辑:

当广告主在CD系统产生转化,系统将通过以下步骤检查fb集成设置:

第1步- 在event层面启动配置“默认”检查。如果event为默认 – 检查进入下一步(第2步)。

第1步- 在event层面启动配置“默认”检查。

● fb集成为false + 使用默认campaign集成为false – 检查进入campaign层面(第 2 步)

● fb 集成为 true + 使用默认campaign集成为 false – 须通过 API 创建转换,从event获取参数(系统中有postback,须在 FB 上创建转化)

● fb追踪为true +使用默认campaign集成为true – 通过 API 创建转化,数据取自 fb集成部分(为campaign设置)

第 2 步 -在campaign层面检查集成设置,即fb追踪设置的状态

Checking the “Facebook tracking is true” settings – the conversion is created via the API on the event with the parameters specified in the Facebook integration section of the campaign.

● 检查“fb tracking is true“设置- 是通过事件的 API 使用活动的 Facebook 集成部分中指定的参数创建的

●  Facebook tracking = false – 转化不是通过API创建的

发送请求的逻辑(SM 活动) (SM campaigns)

当广告主回传转化到CD系统,流量来自smartlink campaign. 那么:

●  检查fb集成设置‘Facebook tracking is true’发生在 SM campaign级别 – 通过活动的 Facebook 集成部分中指定的参数通过事件的 API 创建转换。

●  Facebook tracking = false – 转化不是通过API创建的

文章转自微信公众号@ClickDealer

#你可能也喜欢这些API文章!