广告消耗数据上传指南

本节详细说明了广告消耗数据文件的格式、栏位和验证规则。如果您使用Excel或Google Sheets来创建该文件，请务必参照Excel格式说明进行操作。

参见文件示例。

下图列出了创建CSV文件时最容易出现的一些错误，请在实际操作中着重留意。

下文详细说明了广告消耗数据文件的格式、栏位和验证规则。如果您使用Excel或Google Sheets来创建该文件，请务必参照Excel格式说明进行操作。

CSV广告消耗数据文件的内容规则和栏位

CSV广告消耗数据文件的栏位

Ad Spend token用于验证邮件发送方是否具有广告消耗数据文件的上传权限。广告主和广告平台分别有其各自的token。

• 广告主token：
  • 一个账户下的所有应用共用同一个token。
  • 一个账户下的所有用户都可以获取该token。
• 广告平台token：
  • 所有广告主共用同一个token。
  • 此外，广告主还需要为广告平台开放文件上传权限。

获取Ad Spend token的方法如下：

1. 从AppsFlyer后台进入 ROI360 > 广告消耗数据上传。
2. 点击页面右上角的查看Ad Spend token按钮。
   界面即会显示Ad Spend token。
3. 复制并保存该token。

请按以下步骤为广告平台开放广告消耗数据上传权限：

1. 广告主需要从AppsFlyer后台进入配置 > 活跃对接。
   界面打开活跃对接页面。
2. 选择相关的对接渠道。
3. 进入授权选项卡。
   
4. 确保广告平台权限开关已打开。
5. 【可选】添加账户用户。
6. 打开上传广告消耗数据开关。
   

前期准备：

• 广告主：需获取Ad Spend token。
• 广告平台 ：
  
  • 需获取Ad Spend token。
  • 广告主需要给合作渠道（广告平台）开放广告消耗数据的上传权限。

请按以下步骤通过邮件发送广告消耗数据文件：

1. 填写邮箱地址：
   • To:adspend-upload@appsflyer.com
   • CC：抄送给需要收到自动回复的用户
   • 主题：将Ad Spend token复制粘贴到主题栏中。
   • 附件：带有相关数据的CSV文件。
2. 发送邮件。
   • 数据处理完毕后，我们会向您发送状态报告邮件，邮件中说明文件上传的总体情况以及处理数据的过程中发生的具体问题和错误。原始邮件中抄送的各方以及广告主账户的管理员都会收到该邮件。如果邮件中说明出现错误，请进行必要的更正。请注意：若未接收到状态通知邮件，请参考此处。
   • 您可以在Ad Spend Ingestion页面查看已提交的文件上传状态

广告消耗数据文件的上传方式如下：

1. 从AppsFlyer后台进入 ROI360 > 广告消耗数据上传。
   界面会显示广告消耗数据上传页面。 
2. 点击广告消耗数据上传窗口中的+上传广告消耗数据文件按钮。
   
   
3. 将CSV文件拖拽至上传广告消耗数据文件窗口内。
   界面显示“正在处理文件”的消息。
4. 如果在上传过程中报错：请修正错误，然后重复相关步骤。
5. 界面打开广告消耗数据上传：文件总结窗口。

   

6. 请完成以下任一操作：
   • 如需终止数据上传，请点击取消上传。
   • 点击上传文件按钮完成上传流程。
     上传完毕后，界面会显示“准备就绪”的消息。
7. 点击继续上传其他文件或完成。

如需查看文件层级的上传状态，请按以下方式操作：

• 进入ROI369 > 广告消耗数据上传。
  广告消耗数据上传页面会列出已上传的文件。
• 如果您有文件中所有应用的权限，就可以点击操作按钮，完成以下操作：
  
  • 下载CSV文件：下载之前上传的CSV文件副本。
  • 下载文件中所有应用的未匹配数据报告。

您可按以下方式查看应用层级的数据上传状态：

• 选择相关文件。
  界面会显示应用层级的文件状态页面，并列出该文件中所包含的应用。

  

• 按以下说明完成文件层级或应用层级的操作：
• 文件层级：如果您具有文件中所有应用的权限，就可以使用页面右上方的空间完成以下操作：
  • 还原（取消）文件中所有应用的广告消耗数据上传。
  • 下载之前上传的CSV文件副本。
• 应用层级：如果您仅具备其中某个应用的权限，则可以使用操作按钮来完成以下操作：
  • 下载应用数据。
  • 下载该应用的未匹配数据报告
  • 还原（取消）所选应用的广告消耗数据上传。

数据匹配是指AppsFlyer系统通过数据接入机制将上传文件中的广告消耗数据各行与AppsFlyer面板中记录到的归因数据进行匹配。该机制会对文件栏位中所有维度的数据都进行匹配，包括媒体渠道、广告系列、广告组、广告等等。如果文件中某行数据的所有维度都与面板数据匹配，AppsFlyer会该行标记为is-matching=TRUE。

名称与ID

广告消耗数据接入机制通过名称而非ID来识别相应的维度，如广告系列、广告组或广告的名称等。目前该机制还不支持通过ID来上报消耗数据。

注意：无论匹配状态如何，AppsFlyer都会记录该广告消耗数据。

上传页面中会显示已匹配行的占比。

如果出现意料之外的数据不匹配情况，请下载未匹配数据报告，以便考察问题根因。必要时请点击“还原”按钮以取消数据上传。

未匹配数据报告中有一栏叫做is-matched，该字段可能出现的值为TRUE（表示匹配）或FALSE（表示未匹配）。

广告消耗数据上传页面会显示已匹配行的占比。

如果您新近上传的广告消耗数据文件与之前的文件具有完全相同的key，就可以覆盖（更正）之前上传的广告消耗数据，

该key由数据中的日期、媒体渠道和广告系列字段组成。当该key匹配时，最新上传的数据就会覆盖之前上传的数据。

以下示例解释了广告消耗数据发生覆盖的场景。

下表列出了广告消耗数据上传时可能出现的所有报错消息和相应的解决方法。

问题1：广告消耗数据文件上传成功后，面板没有显示相应的成本数据。

1. 请检查面板中是否重复出现相关广告系列的名称。
2. 如果有重复出现的广告系列名称，请找出campaign ID为空的那一行。
   campaign ID为空的那一行中包含面板未显示的成本数据。 

问题2：上传的成本数据单开一行显示（即多出一行），而且没有效果数据（激活）。该行的campaign ID参数为空。

原因：归因数据中同时存在广告系列ID和广告系列名称信息时，CSV文件中必须也同时包含这两种信息，这样AppsFlyer才能准确地将其匹配到对应的成本数据，并避免单独分行显示。

如果您使用Excel/Google Sheets创建CSV文件，请务必先确认日期（date）和广告消耗（spend）字段的设置正确无误，然后再将文件保存为CSV格式。请按下文所述步骤对date和spend字段进行格式化。

保存CSV文件之后，请检查其格式是否正确无误。注意：请勿使用Excel来检查文件格式，而须在编辑器中检查。 

在Excel中对日期单元格进行格式化

在Excel中使用YYYY-MM-DD的格式对日期单元格进行格式化：

1. 选中需要格式化的单元格。
2. 右键点选Format cells（格式化单元格）。
   界面会打开格式化单元格的窗口。
   

   

3. 选择Custom（自定义）。
4. 在类型（Type）字段中，输入YYYY-MM-DD
5. 点击OK。
   日期格式化完毕。

在Excel中对广告消耗单元格进行格式化

如下图所示，Excel对数值单元格进行格式化时，通常使用逗号作为千位分隔符。请勿在上传到AppsFlyer的广告消耗数据文件中使用这种格式。

您可以在Excel中对这些单元格进行格式化，便可更正此问题。

请按以下方式对金额进行格式化，勿使用千位分隔符： 

1. 选中需要格式化的单元格。
2. 右键点选Format cells（格式化单元格）。
   格式化单元格的窗口打开。
3. 选择Number。
   

   

1. 取消Use 1000 separator (,)（使用逗号为千位分隔符）的勾选。
2. 【可选】设置数值的小数点后位数。默认是2位，最多可以设置到5位。
3. 点击OK。
   单元格格式化完毕。

如需检查CSV文件的内容，请务必在编辑器中查看该文件。

• Windows：Notepad、Notepad++
• macOS：TextEdit

下图为CSV示例文件在编辑器中的截屏。

编辑器视图

在编辑器中检查CSV文件时请特别注意以下几点：

• 空格：请确保字段分隔符（即逗号）的前后没有空格。您可以在Excel中使用@trim命令来删除空格。
• 日期（date）：请确保日期字段的格式为YYYY-MM-DD。
• 广告消耗（spend）：请确保spend字段中没有逗号。

   

如果Excel生成CSV文件时使用分号“;”等非逗号的字符作为分隔符：

• 这可能是因为您电脑的区域设置为非英语语言/地区。
• 当区域设置为德语时，此问题尤其普遍。
• 在不同的计算机操作系统（macOS或Windows）中解决此问题的方法不同。
• 如需解决此问题，请在Microsoft或其他论坛中搜索相关指南。您可以在搜索中使用以下关键词：Operating system (macOS or Windows) Excel change delimiter for CSV files（在macOS或Windows中通过Excel更改CSV文件分隔符）。

广告消耗数据文件尚未处理时会发生这种情况，这可能是由于以下各种原因导致的：

内容类型（content-type）错误

AppsFlyer仅处理multipart/mixed类型的消息。由于其他类型的内容不会得到处理，因此也就不会生成并发送相应的状态通知邮件。一般情况下，邮件客户端会自动将带有附件的邮件自动设为multipart/mixed。

您可以在邮件标头中查看内容类型，并确保邮件的内容类型（content-type）为multipart/mixed。

• 如需在Gmail中查看邮件标头，请参考Gmail的相关文档。
• 如需在Outlook中查看邮件标头，请参考Outlook的相关文档。

邮件HTML格式不正确

HTML错误会使邮件无法得到正常处理。常见的HTML错误包括标签为空或缺失等等。请检查您的脚本，确保其中没有HTML错误。

广告主和代理都可以制备CSV文件，用于上传并接入成本数据。制备这些CSV文件时，请务必确保文件中包含一个带有代理名称（即af_prt参数的值）的Agency（代理）字段。详见CSV文件结构示例。

另请注意以下几点：

• 一个文件中仅可包含一个代理，且不能出现非该代理代投的广告系列。
• 每行都必须包含该代理的名称。代理字段一列不能出现空白的单元格。
• 代理必须具备文件中涵盖的所有应用的权限。
• 只有广告主可以上传文件，代理不能上传数据。但代理可以制备文件，然后将这些文件发送给广告主，让广告主完成上传。