我们能为您提供什么帮助?

设置 ROI360 成本 API,衡量成本数据

  • 更新

概览:通过 Cost API,您可以在应用层级或媒体渠道账户层级获取汇总营销成本数据,包括与成本相关的生命周期价值(LTV)效果指标。

概览

ROI360 提供应用层级和账号层级的成本衡量能力,便于相关方按应用分析投放支出明细,或对媒体渠道账号进行汇总分析。

成本对接的管理入口因媒体渠道而异,分为以下两类:

  • 账户层级对接在成本设置中管理。按广告账号层级进行配置。请参阅支持的广告平台列表。
  • 应用层级对接在成本标签页中管理。需要针对每个应用分别配置。如果某个媒体渠道未出现在成本设置中,请在应用层级的成本选项卡中为其配置成本对接。

角色权限控制成本设置的访问权限。如果无法打开成本设置,请联系管理员,在用户管理页面调整您的角色权限。对应的功能是成本对接。

启用 Cost API

您可在应用层级或账号层级启用成本对接:

在应用层级启用成本对接(成本选项卡)

如需为某个应用单独与媒体渠道建立专属成本对接,请按以下步骤操作:

  1. 在 AppsFlyer 中,从侧边菜单选择协作 > 合作伙伴对接 > 活跃对接,然后选择相应的合作伙伴。
  2. 点击 管理对接。
  3. 打开对接合作伙伴 成本 选项卡。
  4. 开启获取成本数据。系统将显示与该合作渠道对接所需的配置要求。
  5. 配置并验证与合作伙伴的成本对接。认证方式取决于具体媒体渠道,详见下文成本对接方式。
  6. 如果合作伙伴的成本配置包含子渠道映射,请从下拉菜单中选择所需的 Site ID 配置。详见下文子渠道映射。
  7. 点击 保存成本。
    • 成本数据将在 5–6 小时内显示在您的面板中。
    • AppsFlyer 每天从合作渠道拉取数据 6 次,平均每 4 小时一次。
    • 您通过成本选项卡在应用层级所做的配置,也会更新成本设置部分中的媒体渠道账号。
在账户层级启用成本对接(成本设置页面)

如需为多个或全部应用启用成本功能,您只需为每个媒体渠道账号完成一次对接。

在账号层级启用成本对接,请按以下步骤操作:

  1. 在 AppsFlyer 中,从侧边菜单打开 设置 > ROI360 > 成本设置。
  2. 选择要从中获取成本数据的媒体渠道,然后点击 下一步。
  3. 配置并验证与媒体渠道的成本对接。认证方式取决于具体媒体渠道,详见下文成本对接方式。
  4. 输入或自定义该成本对接名称。
  5. 选择需要纳入此成本对接的应用。
  6. 点击 保存对接。
    • 成本数据将在 5–6 小时内显示在您的面板中。
    • AppsFlyer 每天从媒体渠道拉取数据 6 次,平均每 4 小时一次。
    • 在成本设置中于账户层级所做的更新,会自动应用到相关应用及媒体渠道活跃对接的成本选项卡。

如果广告主使用代理投放其广告系列,我们建议由代理而非广告主与相关合作伙伴对接。否则,如果广告主和代理使用相同凭证,为同一款应用对接同一个媒体渠道,成本数据就会重复。

成本对接方法

启用成本对接的方式取决于该媒体渠道与 AppsFlyer 的对接模式。可能包括以下几种:

  • 登录:点击登录到 <媒体渠道>,打开媒体渠道的登录窗口。然后根据提示完成登录。
  • 凭据:输入媒体渠道专属的参数值,例如 API 密钥。
  • 无需配置:除按上文说明开启获取成本数据外,无需进行其他连接配置。

如需了解特定媒体渠道采用的方法,您可以查看媒体渠道成本对接表中的 对接方法 列。

子渠道映射

部分媒体渠道对接支持您选择在报告成本数据时,如何填充Site ID 字段。这可确保 AppsFlyer 归因链接中的 site-id 宏与媒体渠道预期的值一致。

  • 默认情况下,子渠道映射会与归因链接中的 AppsFlyer 宏一致。
  • 如果归因链接使用的宏与子渠道映射选项不一致,Site ID 数据将无法正确填充。

在应用层级设置子渠道映射,请按以下步骤操作:

  1. 在对接合作伙伴 成本 选项卡中,前往 子渠道映射,然后从下拉菜单中选择一项配置。
  2. 点击 保存成本。该更改将于次日(UTC)生效。

删除成本对接

您可以在应用层级或账户层级删除成本对接。删除后,AppsFlyer 将无法再从该账号拉取成本数据。但这对历史数据没有影响。

在应用层级删除成本对接(成本选项卡)

您可随时删除对接。

操作步骤如下:

  1. 在 AppsFlyer 中,从侧边菜单前往协作 > 活跃对接。
  2. 选择相关对接渠道,如 Meta Ads。
  3. 点击 管理对接。
  4. 打开成本选项卡。界面会显示已对接的账户列表。
  5. 在 操作 列中,将鼠标悬停在账号上,然后点击 删除连接。
  6. 在确认提示中,点击 确认,删除。

此前在应用层级配置的成本对接已同时从应用层级和账户层级移除。成本数据将立即停止拉取。该变更不会影响已收集的历史成本数据。该变更不会影响已收集的历史成本数据。

在账户层级删除成本对接(成本设置页面)

在账号层级删除成本对接,请按以下步骤操作:

  1. 在 AppsFlyer 中,从侧边菜单选择 设置 > ROI360 > 成本设置 ,然后选择要删除对接的媒体渠道。
  2. 在该媒体渠道的对接列表中,点击相应的对接记录。
  3. 出现确认提示时,点击 确认,删除。

此前在账号层级配置的成本对接将同时从账号层级和应用层级移除,成本数据将立即停止拉取。该变更不会影响已收集的历史成本数据。该变更不会影响已收集的历史成本数据。

停用 Cost API

停用 Cost API 仅支持在应用层级操作。

停用步骤如下:

  1. 前往 活跃对接 并选择对应媒体渠道。
  2. 前往 成本 选项卡。
  3. 关闭 获取成本数据。
  4. 点击 保存成本。

如果广告主停止与某家代理合作,并在应用层级关闭了该代理的权限,只要该代理仍为相关应用配置了成本对接,系统就会继续拉取成本数据。广告主需联系代理关闭其成本对接,才能停止数据拉取。

Cost API 状态

您可通过以下方式检查成本对接状态:

查看媒体渠道的成本对接状态(成本选项卡)

媒体渠道的活跃对接页面中的成本选项卡(适用于支持通过 API 获取成本数据的媒体渠道)会显示:

  • 当前所选应用的成本对接状态。
  • AppsFlyer 最近一次成功拉取该应用匹配成本数据的时间。

查看某个应用在指定媒体渠道下的成本对接状态,请按以下步骤操作:

  1. 在 AppsFlyer 中,从侧边菜单前往协作 > 活跃对接。
  2. 选择媒体渠道。
  3. 在媒体渠道的 活跃对接页面中,从标签栏上方的应用列表中,选择要查看成本状态的应用。
  4. 点击 成本 选项卡。点击成本选项卡,即可查看状态和上次同步时间。
查看媒体渠道的汇总成本对接状态(成本设置页面)

查看媒体渠道的汇总成本对接状态,请按以下步骤操作:

  1. 从 AppsFlyer 后台的侧边栏中选择设置 > ROI360 > 成本设置。
  2. 选择相关媒体渠道。
  3. 在媒体渠道页面中,您可以在状态列查看该媒体渠道账户的状态。若该账号下所有应用状态一致,将显示统一状态。若不同应用状态不同,则显示为 混合状态。
  4. 如需查看媒体渠道账号关联的某个应用的状态,请点击该媒体渠道账号所在的行,打开成本对接页面。
  5. 并在关联应用列表中查看应用状态。
状态说明表
状态 说明/所需操作
启用 对接已启用,且与媒体渠道绑定成功。
API 未返回匹配的成本数据 可能原因如下:
• 未提供广告系列 ID,因此成本无法与广告系列匹配。

与 AppsFlyer 绑定的渠道账户不是您的投放账户(比如 Meta ads 上不同的账户之间有所混淆)。请检查连接的合作伙伴广告账号是否正确。

渠道成本对接的凭证字段有误,如 Bundle ID。请检查并更正对接凭证。

您的广告已停投,因而没有数据。
合作伙伴 API 没有响应 • 合作伙伴的服务器未响应 AppsFlyer 的请求。
请等待 6 小时。如果之后仍出现该报错消息,请联系 AppsFlyer 技术支持团队。
Invalid credentials(凭证无效) • AppsFlyer 无法通过 API 获取数据,因为提供的凭证无效。
请使用正确的凭证重新连接。
请联系您的广告平台客户经理,获取报告 API 权限。 请与渠道客户经理配合,启用其系统中的成本对接。
合作伙伴 API 未返回数据,请检查对接配置。 Review integration.(渠道 API 未返回数据,请检查对接) 出现这种情况的原因如下:
• 您的广告系列已暂停,因此没有数据。
您的账号尚未在合作伙伴系统中启用成本数据获取功能 请联系相关渠道。
混合状态 仅当「成本设置」> 媒体渠道页面中关联的应用状态不一致时,才会显示混合状态。从媒体渠道页面打开对接页面,查看各应用的状态。该状态不会显示在状态数据面板中

支持账号层级成本配置的媒体渠道

ROI360 客户可以在成本设置和成本选项卡中,于账户层级创建和编辑成本对接。以下媒体渠道支持账户级成本配置:

支持的媒体渠道
字段名称 对接 ID
AdAction3 adaction5_int
Adbloom adbloom_int
AdColony adcolony_int
AdGate Media adgatemedia_int
adjoe GmbH adjoe_int
Adikteev Retargeting trademob_int
Apple Search Ads iossearchads_int
AppLift applift_int
AppLovin applovin_int
Aura aura_int
Blind Ferret Agency blindferret_int
Bluestacks bluestacks_int
bytedance bytedance_int
Chartboost chartboost_int
Dataseat dataseat_int
Digital Turbine Legacy appia_int
Digital Turbine On Device digitalturbine_int
Domob domobc_int
DV360 dv360_int
GlobalWide Media globalwide_int
Google Ads googleadwords_int
InMobi inmobi_int
InMobi DSP inmobidsp_int
Liftoff Influence jetfuelit_int
Mediaforce mediaforce_int
Meta Ads facebook
Mintegral mintegral_int
Mobupps mobupps_int
Moloco moloco_int
MoPub Acquire crossinstall_int
Opera Mobile operaevent_int
Persona.ly RTB personalyrtb_int
pinterest pinterest_int
Pinsight pinsight_int
Point2Web point2web_int
Reddit reddit_int
Smadex smadex_int
Snapchat snapchat_int
Tapjoy tapjoy_int
Taptica taptica_int
抖音 tiktokglobal_int
TUNE hasoffers_int
Unity Ads unityads_int
X (Twitter) twitter

通过 InCost 广告平台还可以使用更多媒体渠道。如需获取支持 InCost 的广告平台完整列表,请联系您的客户成功经理(CSM)。

特性与限制

特性 描述
代理 代理无法通过成本设置同时为多个应用进行成本对接。
新增应用是否自动继承账号层级成本设置。 当前暂不支持
广告主与代理同时连接同一广告平台时的成本数据处理逻辑
如果广告主和代理都对接了同一个广告平台账户(例如 Google Ads)的成本数据,系统会从获得归因的账户拉取成本数据。

示例:
  • 广告主使用广告主凭证完成成本对接
  • 代理使用代理凭证完成成本对接
  • 归因分配给代理账户。

那么将出现以下情况:

  • ROI360 从代理连接中拉取成本数据。
  • 广告主连接显示为“无数据”。
Google 成本对接自动断开 如果成本对接连续超过 365 天显示No Data(无数据)或Invalid credentials(凭证无效),系统会自动断开对接。仅适用于 Google 对接。
配置 TikTok 广告主 ID 列表

在账户层级配置广告主 ID 列表时,仅使用广告平台中与 TikTok 用户关联的广告主 ID。

如果添加到列表中的广告主 ID 与广告平台中的用户不匹配,则不会返回成本数据。