参考文档

帖子

端点描述

/{ad-account-id}/ads

创建广告。

/{business-id}/initiated_sharing_agreements

批准或拒绝待处理的业务协议请求。

/{business-creative-folder-id}

创建和更新商用素材文件夹。

/{business-id}/creative_folders

提供商用素材文件夹。

/{business-id}/images

将图片上传到创意素材文件夹。

/{business-id}/videos

将视频上传到创意素材文件夹。

/{business-creative-folder-id}/agencies

将合作伙伴添加到创意素材文件夹。

/{business-creative-folder-id}/assigned_users

获取有权访问某个商用素材文件夹的用户清单。

读取

端点描述

/{business-creative-folder-id}

获取某个商用素材文件夹的详情。

/{business-id}/creative_folders

获取某个企业可访问的商用素材文件夹清单。

/{business-id}/creatives

获取某个企业的商务管理平台图片和商务管理平台视频。

/{business-id}/initiated_sharing_agreement

获取待处理协议请求的清单。


此端点于 2020 年 5 月重新推出。此前,在图谱 API V6.0 推出后,/initiated_sharing_agreement 曾被停用。

/{business-image-id}

获取某张图片的详情。

/{business-image-id}/insights

获取所分享图片的成效分析。

/{business-video-id}

获取所分享视频的详情。

/{business-video-id}/insights

获取所分享视频的成效分析。

/{business-creative-folder-id}/agencies

获取有权访问您创意素材文件夹的企业清单。

/{business-creative-folder-id}/assigned_users

获取有权访问您创意素材文件夹的用户清单。

删除

端点描述
/{business-creative-folder-id}

删除某个创意素材文件夹。

/{business-creative-folder-id}/agencies

从创意素材文件夹中移除某个合作伙伴。

/{business-creative-folder-id}/assigned_users

从创意素材文件夹中移除某个用户。

/{business-image-id}

移除所分享的图片。

/{business-video-id}

移除所分享的视频。

允许执行的任务

业务用户允许执行的任务描述

CREATE_CONTENT

此用户可以创建文件夹。

MANAGE_CONTENT

此用户可以管理创意素材文件夹中的素材。

MANAGE_PERMISSIONS

此用户可以管理商用素材文件夹的权限。

VIEW_CONTENT

此用户可以查看某个创意素材文件夹中的素材。

VIEW_INSIGHTS

此用户可以查看某个创意素材的成效分析。

成效分析

以下指标正在逐步发展中

指标名称描述
impressions

您的图片或视频在某个广告中出现的次数。

inline_link_clicks

广告内链接的点击量。广告内链接的点击量使用固定的点击后 1 天内统计时间窗。

video_play_actions

您的视频开始播放的次数。每次展示此视频时,我们都会计算此视频开始播放的次数,不包括重播次数。

actions

用户因您的多个广告而执行的操作总数。这些操作可能包括互动、点击或转化。请参阅此文档,获取受支持类型的完整清单。

video_thruplay_watched_actions

视频完整播放或播放至少 15 秒的次数。

quality_ranking

您广告的感知质量排名。质量衡量基于广告的反馈和点击后体验。一条广告相对于争夺相同受众的其他广告的排名。


可能的值包括:

  • BELOW_AVERAGE_10
  • BELOW_AVERAGE_20
  • BELOW_AVERAGE_35
  • AVERAGE
  • ABOVE_AVERAGE
  • UNKNOWN(如果广告的相关信息不足)

这与广告相关度诊断指标有关。

可使用下列细分条件:

  • age
  • gender
  • country
  • objective
  • publisher_platform
  • platform_position
  • device_platform
  • optimization_goal