创建素材包
您可以使用本接口创建素材包。
注意
您每次调用本接口仅可创建一个创意素材包。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/creative/portfolio/create/|/v1.3/creative/portfolio/create/ |
| 请求参数名称|portfolio_type<br>advanced_show_time<br>advanced_guide_text_bottom<br>advanced_position<br>advanced_image_info|creative_portfolio_type<br>badge_show_time<br>call_to_action_text<br>badge_position<br>badge_image_info|
|请求参数类型|advertiser_id: number <br>asset_ids: number[] |advertiser_id: string <br>asset_ids: string[]|
| 新增请求参数|/ |sticker_param（包括该对象下的所有参数）<br>tags<br>layouts<br>description<br>category_label<br>app_id<br>profile_image<br>call_to_action<br>mobile_app_id<br>country_code<br>product_source<br>identity_id<br>identity_type<br>identity_authorized_bc_id<br>catalog_id<br>catalog_authorized_bc_id<br>store_id<br>store_authorized_bc_id<br>product_specific_type<br>product_set_id<br>item_group_ids<br>sku_ids<br>dynamic_format<br>vertical_video_strategy<br>ad_text<br>card_show_price<br>card_tags<br>card_image_index<br>showcase_products（包括该对象内的参数）<br>title<br>selling_points<br>pop_up_window_image_id<br>gesture_type<br>slide_length<br>slide_dimension<br>interactive_music_id|
|返回参数类型|creative_portfolio_id: number |creative_portfolio_id`: string|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/creative/portfolio/create/
**方法** POST
**Header**
``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|
参数
|字段{35%}|类型{15%}|描述{50%}|
|--- |--- |--- |
|advertiser_id {必填}|string|广告主ID。|
|creative_portfolio_type|string|素材包类型。<br><br> 枚举值： <ul><li>`CTA`：行动引导文案。</li><li>`CARD`：卡片（展示卡片）。</li><li>`WEB_INFO_CARD`：网站信息卡片。</li><li> `DOWNLOAD_CARD`：下载卡。</li><li>`INVENTORY_CARD`: 库存卡片。</li><li>`PRODUCT_CARD`：商品卡片。</li><li> `PRODUCT_TILE`： 商品磁贴。</li><li>`STICKER`：倒计时贴纸或礼品码贴纸。</li><li>`PREMIUM_BADGE`：弹出展示（又称福袋）。</li><li>`GESTURE`：交互手势。</li><li>`SUPER_LIKE`：点赞彩蛋。点赞彩蛋能够在受众为视频广告点赞后，为受众提供令人惊喜的视觉元素。有了点赞彩蛋，当受众点赞或点按两次广告时，屏幕上会飘过心形图标和自定义图标。</li></ul><br>默认值：`CTA`。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>所有类型的素材包单次仅可创建一个。</li><li>网站信息卡片可用于`objective_type`为`WEB_CONVERSIONS` 或 `TRAFFIC`（`promotion_type` 需设置为 `WEBSITE` ）的竞价广告。</li><li>库存卡片仅支持在汽车广告中使用。</li><li>商品卡片目前仅支持在视频购物广告中使用。</li><li>商品磁贴目前仅支持在商品来源为商品库的视频购物广告中使用。</li><li>在创建商品磁贴素材包前，需确保您的商品库中至少包含 4 个过审的商品。若想确认您的商品已有足够的过审商品用于商品磁贴素材包，可使用[/catalog/product/get/](1740564136678402.html)并确认至少 4 个商品的 `audit_status`为`approved` 。</li><li>使用商品磁贴素材包创建广告目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。</li><li> 倒计时贴纸可用于以覆盖人数（ `REACH` ）、访问量 （ `TRAFFIC` ）、视频播放量（ `VIDEO_VIEW` ）、应用推广 （ `APP_PROMOTION`）、线索收集（ `LEAD_GENERATION` ）、网站转化量 （ `WEB_CONVERSIONS` ）或商品销量（ `PRODUCT_SALES` ） 为推广目标（ `objective_type` ）的竞价广告，以及以覆盖人数（ `RF_REACH` ）为推广目标（ `objective_type` ）的覆盖和频次广告。 <ul><li>若您想在线索广告中使用倒计时贴纸，您在广告组层级仅可将优化位置设置为落地页。若想了解如何创建此类广告，请查看[创建优化位置为落地页的线索广告](1774482976097281.html)。 </li><li>在推广目标为访问量 （ `TRAFFIC` ）、应用推广（ `APP_PROMOTION` ）和网站转化量 （ `WEB_CONVERSIONS` ）的广告中使用含非直播活动或直播活动提醒的倒计时贴纸（即 `sticker_type` 为 `REMINDER_COUNTDOWN` 或 `LIVE_REMINDER_COUNTDOWN` ）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul></li><li>礼品码贴纸仅可用于以覆盖人数（`REACH`），访问量 （`TRAFFIC`）， 视频播放量（`VIDEO_VIEW`），应用推广 （`APP_PROMOTION`），线索收集（`LEAD_GENERATION`），网站转化量 （`WEB_CONVERSIONS`）或商品销量（`PRODUCT_SALES`） 为推广目标（`objective_type`）的竞价广告，以及以覆盖人数（`RF_REACH`）为推广目标（`objective_type`）的覆盖和频次广告。</li><li>交互手势仅可用于以覆盖人数（`REACH`）、访问量（`TRAFFIC`）、视频播放量（`VIDEO_VIEW`）（`optimization_goal` 需设置为 `ENGAGED_VIEW`）、应用推广（`APP_PROMOTION`）或网站转化量（`WEB_CONVERSIONS`）为推广目标（`objective_type`）的竞价广告，以及以覆盖人数（`RF_REACH`）为推广目标（`objective_type`）的覆盖和频次广告。 <ul><li> 在推广目标为应用推广（`APP_PROMOTION`）、访问量（`TRAFFIC`）或网站转化量（`WEB_CONVERSIONS`）的推广系列广告中使用交互手势目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul></li><li>点赞彩蛋仅可用于以覆盖人数（`REACH`）、访问量（`TRAFFIC`）、视频播放量（`VIDEO_VIEW`）（`optimization_goal` 需设置为 `ENGAGED_VIEW`）、社区互动（`ENGAGEMENT`）（`optimization_goal` 需设置为 `PAGE_VISIT`）、应用推广（`APP_PROMOTION`）或网站转化量（`WEB_CONVERSIONS`）为推广目标（`objective_type`）的竞价广告，以及以覆盖人数（`RF_REACH`）为推广目标（`objective_type`）的覆盖和频次广告。<ul><li>在推广目标为访问量（`TRAFFIC`）或应用推广（`APP_PROMOTION`）的推广系列广告中使用点赞彩蛋目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul></li></ul>|
|portfolio_content|object[]|素材包内容。|
#|asset_content{+条件必填}|string|当`creative_portfolio_type`为`CTA`时，本字段必填。<br><br>行动引导文案。例如：`"Learn More"`。|
#|asset_ids{+条件必填}|string[]|当`creative_portfolio_type`为`CTA`时，本字段必填。<br><br>行动引导文案ID列表。例如，`[201781, 201535]`。你需要使用`/creative/cta/recommend/`接口获取一组自动优化的行动引导文案。然后将返回的数据传入本字段。<br>注意：只有创建自动优化行动引导文案的广告主账号，才能使用该文案。|
#|card_type{+条件必填}|string|当素材包内容（`creative_portfolio_type`）为卡片（`CARD`）时，本字段必填。<br><br>卡片类型。<br><br>枚举值：`IMAGE`（展示卡片）。|
#| gesture_type {+条件必填} | string | `creative_portfolio_type` 为 `GESTURE` 时，本字段必填。 <br><br> 交互手势类型。 <br><br> 枚举值：<ul><li>`CLICK`：点击型。</li><li>`STRAIGHT_SLIDE`：直线滑动型。</li><li>`CURVED_SLIDE`：曲线滑动型。 </li></ul> |
#|image_id{+条件必填}|string| `creative_portfolio_type` 为 `CARD` 、`WEB_INFO_CARD` 、`INVENTORY_CARD`或 `SUPER_LIKE` 时，本字段必填。<br><br>图片 ID。<br><br><ul><li>对于展示卡片（`CARD`），图片尺寸必须为 750（宽）x 421（高）像素。</li><li>对于网站信息卡片（`WEB_INFO_CARD`），推荐图片尺寸为 800（宽）x 800（高）像素。</li><li>对于库存卡片（`INVENTORY_CARD`），图片尺寸必须为 600（宽）x 800（高）像素。</li><li>对于点赞彩蛋（`SUPER_LIKE`），本字段代表受众点赞或点按两次广告时，屏幕上会与心形图标一起飘过的自定义图标的图片。该图片需满足以下规格要求：<ul><li>推荐图片尺寸：200（宽）x 200（高）像素。</li><li>文件类型：JPG、JPEG 或 PNG。</li><li>文件大小：不超过 50KB。</li></ul></li></ul><br>您可通过[/file/image/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1739067433456642)或[/file/image/ad/search/](https://ads.tiktok.com/marketing_api/docs?id=1740052016789506)获取图片 ID。 |
#| pop_up_window_image_id {+条件必填}| string | <ul><li>`creative_portfolio_type` 为 `GESTURE` 时，本字段必填。</li><li>`creative_portfolio_type` 为 `SUPER_LIKE` 时，本字段为选填字段。</li></ul><br>交互手势中跳转图的图片 ID 或点赞彩蛋中弹出窗口的图片 ID。 <ul><li> `creative_portfolio_type` 为 `GESTURE` 时，本字段代表受众跟随手势后将出现的跳转图。</li><li>`creative_portfolio_type` 为 `SUPER_LIKE` 时，本字段代表在点赞彩蛋播放结束后出现的弹出窗口，当受众点击弹窗，就会跳转到您的广告落地页。</li></ul><br>支持的规格：<ul><li>推荐图片尺寸：620（宽）x 788（高）像素。</li><li>文件类型：JPG、JPEG、PNG 或 GIF。</li><li>文件大小：不超过 3MB。</li></ul><br>若想上传图片获取图片 ID，可使用 [/file/image/ad/upload/](1739067433456642.html)。 |
#|title {+条件必填}|string| `creative_portfolio_type` 为 `WEB_INFO_CARD` 时，本字段必填。<br><br>卡片标题。<br><br>长度限制：25 个字符。 |
#|selling_points{+条件必填}|string[]| `creative_portfolio_type` 为 `WEB_INFO_CARD` 时，本字段必填。<br><br>卖点，即用户应该购买您的商品的理由。<br><br>最大数量：5。<br>本字符串数组中的每个字符串代表一个卖点，单个卖点的长度限制：25 个字符。 |
#|call_to_action_text {+条件必填}|string|`creative_portfolio_type` 为 `GESTURE` 或 `PREMIUM_BADGE` 时，本字段必填。<br><br>交互手势或弹出展示中的交互引导语。 <br><ul><li>`creative_portfolio_type` 为 `GESTURE` 时，本字段代表交互手势中的交互引导语。<br> 不同交互手势类型的示例文案：<ul><li>点击型交互手势：`Click here for more details`</li><li>直线滑动型交互手势：`Slide in a straight line`</li><li>曲线滑动型交互手势：`Slide along the curve`</li></ul></li><li>`creative_portfolio_type` 为 `PREMIUM_BADGE` 时，本字段代表弹出展示中的交互引导语。<ul><li>示例文案： `Click here for details` </li></ul></li></ul><br> 长度限制：27 个字符。每个英文字母占用 1 个字符，中文、日文或韩文每个字占用 2 个字符。<br>不支持表情符号和特殊字符 `{`、`}`、`@` 和 `#` 。<br> 请勿包含条形码、商品的库存代码或任何社交媒体信息。|
#|badge_show_time {+条件必填}|integer| `creative_portfolio_type` 为 `GESTURE` 或 `PREMIUM_BADGE` 时，本字段必填。 <br><br>交互手势中手势图标或弹出展示中福袋的出现时机，单位为秒。<br><br> 视频前 3 秒和后 5 秒不可设置为起始点。<br><br> 示例：5。|
#|badge_position {+条件必填}|object| `creative_portfolio_type` 为 `GESTURE` 或 `PREMIUM_BADGE` 时，本字段必填。 <br><br> 交互手势中手势图标或弹出展示中福袋的位置信息。|
##|position_x {+条件必填}| float| 传入 `badge_position` 时必填。 <br><br>交互手势中手势图标或弹出展示中福袋左上角的相对横坐标，以左上角横坐标除以 720 表示。 <br><br>取值范围：0-1。 |
##|position_y {+条件必填}| float| 传入 `badge_position` 时必填。 <br><br> 交互手势中手势图标或弹出展示中福袋左上角的相对纵坐标，以左上角横坐标除以 1280 表示。<br><br> 取值范围：0-1。|
##|angle {+条件必填}|number|传入 `badge_position` 且满足以下任一条件时，本字段必填。<ul><li>`creative_portfolio_type` 为 `GESTURE` 且 `gesture_type` 为 `STRAIGHT_SLIDE` 或 `CURVED_SLIDE`。</li><li>`creative_portfolio_type` 为 `PREMIUM_BADGE`。</li></ul><br> 交互手势中直线滑动型或曲线滑动型手势图标的手势角度或弹出展示中福袋的弹出角度。 <br> <br> 取值范围： <ul><li>`creative_portfolio_type` 为 `GESTURE` 且 `gesture_type` 为 `STRAIGHT_SLIDE` 或 `CURVED_SLIDE` 时，推荐角度为 30-150 或 210-330 区间内的值。</li><li>`creative_portfolio_type` 为 `PREMIUM_BADGE` 时：0-360。</li></ul>|
#|badge_image_info {+条件必填}|object| `creative_portfolio_type` 为 `PREMIUM_BADGE` 时，本字段必填。 <br> <br> 弹出展示中福袋图片信息。|
##|image_id {+条件必填}|string|传入 `badge_image_info` 时必填。<br> <br> 弹出展示中福袋的图片 ID。 <br> <br> 规格要求： <ul><li>尺寸：448（宽）x 448（高）像素。 </li><li>图片格式：JPG、JPEG 或 PNG。</li><li>文件大小：不超过 1 MB。</li></ul> |
#| slide_length {+条件必填} | number | `creative_portfolio_type` 为 `GESTURE` 且 `gesture_type` 为 `STRAIGHT_SLIDE` 时必填。 <br> <br> 直线滑动型手势的长度。 |
#| slide_dimension {+条件必填} | object| `creative_portfolio_type` 为 `GESTURE` 且`gesture_type`为 `CURVED_SLIDE` 时必填。 <br> <br> 曲线滑动型手势的尺寸。 |
##| dimension_width {+条件必填} | number | 传入 `slide_dimension` 时必填。 <br> <br> 曲线滑动型手势的宽度。 |
##| dimension_height {+条件必填} | number | 传入 `slide_dimension` 时必填。 <br> <br> 曲线滑动型手势的高度。 |
#| interactive_music_id {+条件必填} | string | `creative_portfolio_type` 为 `GESTURE` 时必填。 <br> <br> 交互手势中手势音效的 URL。 <br> <br>规格要求：<ul><li>文件大小：不超过 1 MB。</li><li>文件格式：MP3。</li><li> 推荐时长：6 秒。</li></ul><br> 示例：`https://sf16-sg-default.akamaized.net/obj/tiktok-obj/0123456789.mp3`。 <br> <br> 为确保流畅的广告体验，可将视频广告的背景音乐设置为手势音效。 <br> <br> 若想将音乐上传至素材库并获取音乐 URL（`url`），可使用[/file/music/upload/](1740052650395650.html)。 |
#| layouts {+条件必填} | string[] | 当`creative_portfolio_type`为`DOWNLOAD_CARD`时必填。 <br>下载卡的布局类型。枚举值：<ul><li>`TYPE_1`：类型1，在下载卡中展示应用描述。 </li><li> `TYPE_2`：类型2，在下载卡中不展示应用描述。</li></ul><br>您可传入一种或两种类型，当您同时传入 `TYPE_1` 和 `TYPE_2`时，将同时创建一个类型1和一个类型2的下载卡。 |
#| description {+条件必填} | string | 在以下任一场景中必填：<ul><li>`creative_portfolio_type` 为 `DOWNLOAD_CARD` 且 `layouts` 的值包含 `TYPE_1`。</li><li>`creative_portfolio_type`为 `INVENTORY_CARD`。</li></ul><br>您想在下载卡中推广的应用的描述或库存卡片的文本。<br><br>对于库存卡片 (`INVENTORY_CARD`)，长度限制为 40 个字符。 |
#| tags {+条件必填} | string[] | 当`creative_portfolio_type`为`DOWNLOAD_CARD`时必填。 <br>下载卡中的标签。枚举值：<ul><li> `CATEGORIES`：在下载卡中展示您想推广的应用的分类。</li><li> `FILESIZE`：在下载卡中展示您想推广的应用的文件大小。</li><li> `RATING`：在下载卡中展示您想推广的应用的评分。</li><li> `RANKING`：在下载卡中展示您想推广的应用的排行。</li><li> `COMMENT_VOLUME`：在下载卡中展示您想推广的应用的评论数。 </li></ul> <br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>您可同时传入多个标签，当传入标签大于两个时，仅按以下优先级显示两个标签：`CATEGORIES` > `FILESIZE` > `RATING` > `RANKING`>`COMMENT_VOLUME`。 </li><li>对于类型1 的下载卡，您需至少传入一个标签。 </li><li>对于类型2 的下载卡，您需至少传入两个标签。</li></ul> |
#| category_label {+条件必填} | string | 当`creative_portfolio_type`为`DOWNLOAD_CARD`且`tags`的传入值包含`CATEGORIES`时必填。 <br>下载卡中展示的您想推广的应用的分类标签。枚举值请查看[枚举值-创意管理-分类标签](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)，您需将取值以字串传入。 |
#| app_id {+条件必填} | string | 当`creative_portfolio_type`为`DOWNLOAD_CARD`时必填。 <br>下载卡中您想推广的应用的ID。该ID为事件管理平台中显示的应用ID。 |
#| profile_image {+条件必填} | string | 当`creative_portfolio_type`为`DOWNLOAD_CARD`时必填。 <br>头像URL。 |
#| call_to_action {+条件必填} | string | 当`creative_portfolio_type`为`DOWNLOAD_CARD`时必填。<br> 下载卡中的行动引导文案。 |
#| mobile_app_id {+条件必填} | string | 当`creative_portfolio_type`为`DOWNLOAD_CARD`时必填。<br> 移动应用ID，用于从 Google Play 或App Store中提取标签信息。 <ul><li>对于iOS应用，请传入应用对应的App Store URL中`id`后的数字串作为ID。例如`https://apps.apple.com/us/app/hyperpure/id1203646221`中移动应用ID为`1203646221`。</li><li> 对于Android应用，请传入应用对应的Google Play 商店 URL中`id`后的应用程序包名作为ID。例如`https://play.google.com/store/apps/details?id=com.innersloth.spacemafia` 中移动应用ID为`com.innersloth.spacemafia`。</li></ul> |
#| country_code {+条件必填} | string[] | 当`creative_portfolio_type`为`DOWNLOAD_CARD`时必填。<br> 想要定位的地域的国家或地区代码。枚举值可参见 附录-地区代码。 |
#| sticker_param {+条件必填} | object | 当`creative_portfolio_type`为`STICKER`时，该字段为必填。<br>想要创建的倒计时贴纸和礼品码贴纸详情。倒计时贴纸和礼品码贴纸示例可查看[倒计时贴纸](https://ads.tiktok.com/help/article?aid=10007423)和[礼品码贴纸](https://ads.tiktok.com/help/article/tiktok-interactive-add-on-gift-code-sticker?lang=zh)。 <br><p><span style="color:darkred"><b>注意</b></span>：单次仅可创建一个倒计时贴纸或礼品码贴纸。 |
##| sticker_type | string | 贴纸类型。默认值： `COUNTDOWN`。 枚举值：<ul><li> `COUNTDOWN`：无提醒的倒计时贴纸。</li><li> `REMINDER_COUNTDOWN`： 含非直播活动提醒的倒计时贴纸。</li><li> `LIVE_REMINDER_COUNTDOWN`：含直播活动提醒的倒计时贴纸。</li><li>`GIFTCODE`：礼品码贴纸，用于通过提供虚拟礼品或优惠券兑换码来吸引新客户和促进现有客户。</li></ul> |
##| title {+条件必填} | string | 当`creative_portfolio_type`为`STICKER`时，该字段为必填。<br>贴纸标题。<br><ul><li>对于倒计时贴纸，最大长度为54个UTF-8字节，且不支持话题标签符号 (#)。</li><li>对于礼品码贴纸，最大长度为20个UTF-8字节。</li><ul> |
##| giftcode {+条件必填} | string | 当`sticker_type`为`GIFTCODE`时，该字段为必填。<br>当`sticker_type`不为`GIFTCODE`时，不支持传入该字段。 <br><br>礼品码。<br>本字段仅适用于礼品码贴纸。最大长度为10个UTF-8字节（10个英文字母和数字）。|
##| cutoff_time {+条件必填} | string | 当`sticker_type`为`COUNTDOWN`，`REMINDER_COUNTDOWN`，或 `LIVE_REMINDER_COUNTDOWN`时，该字段为必填。<br>当`sticker_type`为`GIFTCODE`时，不支持传入该字段。<br><br>贴纸对应的倒计时截止日期(`sticker_type`为`COUNTDOWN`或`REMINDER_COUNTDOWN`时)或直播开始时间 (`sticker_type`为`LIVE_REMINDER_COUNTDOWN`时)，格式为"2022-10-30 00:00:00" (UTC+0 时间)。 <br><p><span style="color:darkred"><b>注意</b></span>：您在此字段传入的时间将默认为UTC+0时间，且该默认时区无法更改。 |
##| color {+条件必填} | string | 当`creative_portfolio_type`为`STICKER`时，该字段为必填。<br><br>贴纸的背景色。<br><ul><li>对于倒计时贴纸，支持的枚举值：`ORANGE`(橘色)、`BLACK`(黑色)、`RED`(红色)、`BLUE`(蓝色)。</li><li>对于礼品码贴纸，支持的枚举值： `BLACK`(黑色)和`BLUE`(蓝色)|
##| display_angle {+条件必填} | integer | 当`sticker_type`为`COUNTDOWN`，`REMINDER_COUNTDOWN`，或`LIVE_REMINDER_COUNTDOWN`时，该字段为必填。<br>当`sticker_type`为`GIFTCODE`时不支持传入。贴纸的显示角度。<br>取值范围： `[-180, +180]`。 `+90` 表示将贴纸顺时针旋转90度。|
##| predefined_placement | string | <ul><li>当`sticker_type`为`COUNTDOWN`，`REMINDER_COUNTDOWN`或`LIVE_REMINDER_COUNTDOWN`时，需要传入`predefined_placement`字段，或者传入`position_x`，`position_y`和`size`字段。</li><li>当`sticker_type`为`GIFTCODE`时，需要传入`predefined_placement`，或者传入`position_x`，`position_y`字段。</li></ul>该字段用于预定义：<ul><li>礼品码贴纸的横坐标和纵坐标。</li><li>或倒计时贴纸的横坐标和纵坐标以及大小。</li></ul>例如，若将`predefined_placement`设置为`55x143x0.9`，对于<b>倒计时贴纸</b>，x轴坐标为55，y轴坐标为143，大小为90%。 <br>同样，若将`predefined_placement`设置为`86x179`，那么对于<b>礼品码贴纸</b>，x轴坐标为86，y轴坐标为179。<br><br>本字段的枚举值，请参见“<a href="#item-link-预定义位置">预定义位置</a>”章节。<br><span style="color:darkred"><b>注意</b></span>：<ul><li>对于倒计时贴纸，若指定了`predefined_placement`，同时也指定了`position_x`，`position_y和size`，`position_x`，`position_y`和`size`的值将被忽略。</li><li>对于礼品码贴纸，若指定了`predefined_placement`，同时也指定了`position_x`，`position_y`，那么`position_x`和`position_y`的值将被忽略。|
##| position_x {+条件必填}| integer | <ul><li>当`sticker_type`为`COUNTDOWN`，`REMINDER_COUNTDOWN`或`LIVE_REMINDER_COUNTDOWN`时，需要传入`predefined_placement`字段，或者传入`position_x`，`position_y`和`size`字段。</li><li>当`sticker_type`为`GIFTCODE`时，需要传入`predefined_placement`，或者传入`position_x`，`position_y`字段。</li></ul>贴纸左上角相对于屏幕左上角的横坐标。<br><ul><li>对于倒计时贴纸：<br>本字段的取值范围随贴纸大小变动：<ul><li>`size`设置为`0.6`时，本字段取值范围为[50, 301]。</li><li>`size`设置为`0.7`时，本字段取值范围为[50, 253]。</li><li>`size`设置为`0.8`时，本字段取值范围为[50, 205]。</li><li>`size`设置为`0.9`时，本字段取值范围为[50, 157]。</li><li>`size`设置为`1`时，本字段取值范围为[50, 109]。</li><li>`size`设置为`1.1`时，本字段取值范围为[50, 61]。</ul><li>对于礼品码贴纸：本字段取值范围[79, 145]。</li></ul><span style="color:darkred"><b>注意</b></span>：对于倒计时贴纸和礼品码贴纸，若同时传入`predefined_placement`和`position_x`，那么`position_x`将被忽略。|
##| position_y {+条件必填} | integer | <ul><li>当`sticker_type`为`COUNTDOWN`，`REMINDER_COUNTDOWN`或`LIVE_REMINDER_COUNTDOWN`时，需要传入`predefined_placement`字段，或者传入`position_x`，`position_y`和`size`字段。</li><li>当`sticker_type`为`GIFTCODE`时，需要传入`predefined_placement`，或者传入`position_x`，`position_y`字段。</li></ul>贴纸左上角相对于屏幕左上角的纵坐标。<ul><li>对于倒计时贴纸：<br>本字段的取值范围随贴纸大小变动：<ul><li>`size`设置为`0.6`时，本字段取值范围为[141, 639]。</li><li>`size`设置为`0.7`时，本字段取值范围为[141, 606]。</li><li>`size`设置为`0.8`时，本字段取值范围为[141, 573]。</li><li>`size`设置为`0.9`时，本字段取值范围为[141, 540]。</li><li>`size`设置为`1`时，本字段取值范围为[141, 506]。</li><li>`size`设置为`1.1`时，本字段取值范围为[141, 473]。</ul><li>对于礼品码贴纸：本字段取值范围[169, 683]。</li></ul><span style="color:darkred"><b>注意</b></span>：对于倒计时贴纸和礼品码贴纸，若同时传入`predefined_placement`和`position_x`，那么`position_x`将被忽略。|
##| size {+条件必填} | string | <ul><li>当`sticker_type`为`COUNTDOWN`，`REMINDER_COUNTDOWN`或`LIVE_REMINDER_COUNTDOWN`时，需要传入`predefined_placement`字段，或者传入`position_x`，`position_y`和`size`字段。</li><li>当`sticker_type`为`GIFTCODE`时，不支持传入`size`字段。</li></ul>以百分比表示的贴纸大小。枚举值：`0.6`(60%), `0.7`(70%), `0.8`(80%), `0.9`(90%), `1`(100%), `1.1`(110%)。<br><span style="color:darkred"><b>注意</b></span>：对于倒计时贴纸，如果同时传入`predefined_placement`和`size`，那么`size`将被忽略。 |
##| opacity {+条件必填} | string | <ul><li>当`sticker_type`为`COUNTDOWN`，`REMINDER_COUNTDOWN`或`LIVE_REMINDER_COUNTDOWN`时，该字段为必填。</li><li>当`sticker_type`为`GIFTCODE`时，不支持传入该字段。</li></ul>贴纸的不透明度。枚举值：`0.7`, `0.8`, `0.9`, `1`。值越小，表示倒计时贴纸的透明度越高。|
##| reminder_time {+条件必填} | string | 设置的提醒时间。 当`sticker_type`为`REMINDER_COUNTDOWN`或`LIVE_REMINDER_COUNTDOWN`时必填。<br> 对于非直播倒计时贴纸 (即`sticker_type`为`REMINDER_COUNTDOWN`)，枚举值为：<ul><li> `ONE_MINUTE_EARLIER`: 在非直播活动前一分钟发送提醒。</li><li> `ONE_HOUR_EARLIER `: 在非直播活动前一小时发送提醒。</li><li> `ONE_DAY_EARLIER`: 在非直播活动前一天发送提醒。</li></ul> 对于非直播倒计时贴纸 (即`sticker_type`为`LIVE_REMINDER_COUNTDOWN`), 枚举值为：<ul><li> `ONE_MINUTE_AFTER`: 在直播活动开始一分钟后发送提醒。</li><li> `FIVE_MINUTES_AFTER`: 在直播活动开始五分钟后发送提醒。</li><li> `TEN_MINUTES_AFTER`: 在直播活动开始十分钟后发送提醒。</li></ul> |
##| landing_page_url {+条件必填} | string | 落地页URL，在非直播活动的倒计时结束后，点击提醒时会跳转至此URL。 仅当`sticker_type`为`REMINDER_COUNTDOWN`时必填。 |
##| live_tiktok_user_id {+条件必填} | string | 直播活动主播的TikTok用户ID 。仅当 `sticker_type`为`LIVE_REMINDER_COUNTDOWN`时必填。 传入本字段后，当您点击直播活动的提醒时，会自动跳转至主播的直播间。 |
#| product_source {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`或 `PRODUCT_TILE`时必填。<br>`creative_portfolio_type`为 `PRODUCT_TILE` 时，本字段仅支持设置为`CATALOG` 。<br><br>商品来源，即您要推广的商品的来源。 <br>枚举值：`UNSET`， `CATALOG` （商品库），`STORE`（TikTok Shop 店铺），`SHOWCASE` （TikTok 橱窗）。 <br>若您将本字段设置为`STORE`，您需同时传入`item_group_ids`。<br><p><span style=“color:darkred”><b>注意</b></span>：若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告组层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。 |
#| identity_id {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`或 `PRODUCT_TILE`时必填。<br> <br>认证身份ID。 |
#| identity_type {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`或 `PRODUCT_TILE`时必填。 <br>`creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`STORE`时，本字段支持的值为`AUTH_CODE`，`TT_USER`和`BC_AUTH_TT`。<br><br>认证身份类型。<br><br>枚举值: `CUSTOMIZED_USER`（自定义用户）, `AUTH_CODE`（授权用户）, `TT_USER`（TikTok用户），`BC_AUTH_TT`（已添加到商务中心的TikTok用户）。 <br><br>关于认证身份的更多信息，请查看[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。 |
#| identity_authorized_bc_id {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`或 `PRODUCT_TILE`且`identity_type`为`BC_AUTH_TT`时必填。 <br>与添加到商务中心的TikTok用户这一认证身份绑定的商务中心的ID。 |
#| catalog_id {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`CATALOG`，或`creative_portfolio_type`为`PRODUCT_TILE` 时必填。 <br>商品库ID。 <br><p><span style=“color:darkred”><b>注意</b></span>：<ul><li>您可使用[/store/list/](https://ads.tiktok.com/marketing_api/docs?id=1752267762718722)获取广告账户下可用商店对应的`catalog_id`，`store_id`和`store_authorized_bc_id`。</li><li>若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告组层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。</li></ul> |
#| catalog_authorized_bc_id {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`CATALOG`，或`creative_portfolio_type`为`PRODUCT_TILE`时必填。<br> 拥有商品库（`catalog_id`）权限的商务中心的ID。 <br><p><span style=“color:darkred”><b>注意</b></span>：若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告组层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。 |
#| store_id {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`STORE`时必填。<br> `creative_portfolio_type`为`PRODUCT_TILE` 时不支持本字段。<br><br>TikTok Shop 店铺 ID。 <br><p><span style=“color:darkred”><b>注意</b></span>：<ul><li>欲获取 TikTok Shop 店铺 ID，您可以调用[/bc/asset/get/](https://ads.tiktok.com/marketing_api/docs?id=1739432717798401)： <ul><li>当返回中的`asset_type`为`TIKTOK_SHOP`时，对应的`asset_id`为TikTok Shop店铺ID。 </li></ul></li><li>若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告组层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。</li></ul> |
#| store_authorized_bc_id {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`STORE`时必填。<br> `creative_portfolio_type`为`PRODUCT_TILE` 时不支持本字段。<br><br> 有该店铺 (`store_id`）权限的商务中心的ID。 <br><p><span style=“color:darkred”><b>注意</b></span>：若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告组层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。 |
#| product_specific_type {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`CATALOG`，或`creative_portfolio_type`为`PRODUCT_TILE`时必填。<br> 指定商品的方式。 枚举值：<ul><li> `ALL`：所有商品。 允许TikTok动态选择商品库中的所有商品。您此时不需同时传入`sku_ids`，`item_group_ids` 或`product_set_id` 。</li><li> `PRODUCT_SET`：商品系列。请选择一个商品系列，TikTok将动态选择该商品系列中的商品。您此时需同时传入`item_group_ids`或`product_set_id`。</li><li>`CUSTOMIZED_PRODUCTS`：特定商品。最多可从您的商品库中选择20个商品。您需同时传入`sku_ids` 。</li></ul><br><p><span style=“color:darkred”><b>注意</b></span>：若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。 |
#| product_set_id {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`或 `PRODUCT_TILE`且`product_specific_type`为`PRODUCT_SET`时，您需传入`product_set_id`或`item_group_ids`。 <br>商品系列ID。您可以使用[/catalog/set/get/](https://ads.tiktok.com/marketing_api/docs?id=1740570556295169)获取商务中心下商品库的商品系列列表。<br><p><span style=“color:darkred”><b>注意</b></span>：若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。 |
#| item_group_ids {+条件必填} | string[] | `creative_portfolio_type`为`PRODUCT_CARD`或 `PRODUCT_TILE`且`product_source`为`STORE`时必填。<br> `creative_portfolio_type`为`PRODUCT_CARD`且`product_specific_type`为`PRODUCT_SET`时，您需传入`product_set_id`或`item_group_ids`。<br> 商品 SPU ID列表。最大数量： 20。 <br><p><span style=“color:darkred”><b>注意</b></span>：若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。 |
#| sku_ids {+条件必填} | string[] | `creative_portfolio_type`为`PRODUCT_CARD` 或 `PRODUCT_TILE`且`product_specific_type`为`CUSTOMIZED_PRODUCTS`时必填。 <br>商品 SKU ID列表。最大数量： 20。 <br><p><span style=“color:darkred”><b>注意</b></span>：若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告层级</strong>本字段传入创建商品卡片时所用的值。否则，广告实际投放时，商品卡片中的商品缩略图可能与所推广的商品不符。 |
#| dynamic_format {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`CATALOG`时必填。<br> `creative_portfolio_type`为`PRODUCT_TILE` 时不支持本字段。<br> <br>`creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`STORE`时，则此字段不可设置为`DYNAMIC_CREATIVE`，您可不传入此字段，或将本字段设置为`UNSET`。<br> 是否使用动态样式。动态样式功能将视频素材、商品卡片以及落地页根据顾客的购买意图进行不同的组合，以实现转化最大化。<br> 枚举值： `UNSET`，`DYNAMIC_CREATIVE`（使用动态样式生成创意）。 <br><p><span style=“color:darkred”><b>注意</b></span>： <ul><li>受众再营销广告（广告组的`shopping_ads_retargeting_type`不是`OFF`）无法使用`dynamic_format`。当 `dynamic_format` 设置为`DYNAMIC_CREATIVE`时，会自动创建卡片。这意味着您无需传入与卡片相关的字段（`card_show_price`， `card_tags`和 `card_image_index `）。 </li><li>若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告层级</strong>本字段传入创建商品卡片时所用的值。</li></ul> |
#| vertical_video_strategy {+条件必填} | string | `creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`CATALOG`时必填。<br> `creative_portfolio_type`为`PRODUCT_TILE` 时不支持本字段。<br><br> `creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`STORE`时，您可不传入此字段，或将本字段设置为`SINGLE_VIDEO`。 <br>商品销量（即购物广告）场景中使用的视频类型。 枚举值： `UNSET` (未设置), `SINGLE_VIDEO` (单个视频），`CATALOG_VIDEOS`（商品库视频）。 <br>如果`dynamic_format`为`DYNAMIC_CREATIVE`，该字段必须设置为`UNSET`。 <br><p><span style=“color:darkred”><b>注意</b></span>：若您创建完商品卡片后希望在创建广告时使用商品卡片，需确保在<strong>广告层级</strong>本字段传入创建商品卡片时所用的值。 |
#| ad_text | string | `creative_portfolio_type`为`PRODUCT_CARD`时生效。<br>广告文案，将作为广告创意的一部分展示给你的受众，向他们传达你想要推广的信息。若您不清楚如何创建有效文案，可以使用智能文案功能，根据行业和语言获取文案推荐。<br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>广告文案长度允许值为1-100 字符，不能包含emoji。</li><li>中文或日文每个字占用2个字符，每个英语字符占用1个字符。</li></ul> |
#| card_show_price {+条件必填} | boolean | `creative_portfolio_type`为`PRODUCT_CARD`时必填。<br>是否在商品卡片中显示商品价格。 |
#| card_tags {+条件必填} | string[] | `creative_portfolio_type`为`PRODUCT_CARD`时必填。 <br>想要在商品卡片中显示的商品标签。 枚举值：`BRAND` （品牌名称）， `DESC`（说明）。 |
#| card_image_index | integer | `creative_portfolio_type`为`PRODUCT_CARD`或 `PRODUCT_TILE`时生效。 <br>您可使用本字段指定在商品卡片或商品磁贴中使用的图片。您通过本字段设置的数字将作为索引，查询您调用[/catalog/product/upload/](https://ads.tiktok.com/marketing_api/docs?id=1740497429681153)时通过`additional_image_urls`字段传入的图片URL。 <br>例如，`card_image_index`为1代表您将使用`additional_image_urls`的值中的第二图片URL对应的图片。 |
#| showcase_products {+条件必填}| object[] |`creative_portfolio_type`为`PRODUCT_CARD`且`product_source`为`SHOWCASE`时必填。您可查看[创建商品来源为橱窗的视频购物广告](https://ads.tiktok.com/marketing_api/docs?id=1759232259360770)了解详情。<br>您想要用在广告中的橱窗商品列表。最大数量：20。<br> 您可调用[/showcase/product/get/](https://ads.tiktok.com/marketing_api/docs?id=1759233576199169)，获取可用的橱窗商品。 |
##| item_group_id | string | 商品的SPU ID。 |
##| store_id | string | 商品（`item_group_id`）所属的店铺ID。<br>请注意本字段仅支持TikTok Shop店铺。 |
##| catalog_id | string | 商品（`item_group_id`）所属的商品库ID。 |
示例
创建商品来源为商品库的商品卡片素材包
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/portfolio/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"advertiser_id": "{{advertiser_id}}",
"creative_portfolio_type": "PRODUCT_CARD",
"portfolio_content": [{
"product_source": "CATALOG",
"catalog_id": "{{catalog_id}}",
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
"product_specific_type": "PRODUCT_SET",
"ad_text": "{{ad_text}}",
"identity_id": "{{identity_id}}",
"identity_type": "{{identity_type}}",
"dynamic_format": "UNSET",
"vertical_video_strategy": "SINGLE_VIDEO",
"card_show_price": true,
"card_tags": ["BRAND"],
"item_group_ids": ["{{item_group_ids}}"],
"card_image_index": 0
}]
}'
(/code)
创建商品来源为TikTok Shopping 的商品卡片素材包
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/portfolio/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"advertiser_id": "{{advertiser_id}}",
"creative_portfolio_type": "PRODUCT_CARD",
"portfolio_content": [{
"product_source": "STORE",
"identity_id": "{{identity_id}}",
"identity_type": "{{identity_type}}",
"catalog_id": "{{catalog_id}}",
"store_id": "{{store_id}}",
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"item_group_ids": ["{{item_group_ids}}"],
"card_show_price": true,
"card_tags": ["BRAND"]
}]
}'
(/code)
创建商品磁贴素材包
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/creative/portfolio/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"creative_portfolio_type": "PRODUCT_TILE",
"portfolio_content": [
{
"product_source": "CATALOG",
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"catalog_id": "{{catalog_id}}",
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
"product_specific_type": "CUSTOMIZED_PRODUCTS",
"sku_ids": [
"{{sku_id}}",
"{{sku_id}}",
"{{sku_id}}",
"{{sku_id}}"
],
"card_image_index": 0
}
]
}'
(/code)
返回
|字段|类型|描述|
|-|-|-|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据。|
#| creative_portfolio_id | string| 创意素材包ID。 |
|request_id |string|请求日志ID。|
示例
(code JSON python)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"creative_portfolio_id": 6911933716445006853
},
"request_id": "2020123008310401023125104012852"
}
(/code)
预定义位置
下表列出了predefined_placement字段的枚举值和对应示例。
倒计时贴纸预定义位置
|枚举值{50%}|示例{50%}|
|---|---|---|
| `196x148x0.8` | 右上角<br><img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/ca68c114cef0add37df636b40a7b68bf" alt="COUNTDOWN_PLACEMENT_9" width="60%" style="color:#808080"/> |
| `57x148x0.8` | 左上角<br><img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/439d7c76fcc55d22e10949b111a0c79c" alt="COUNTDOWN_PLACEMENT_8" width="60%" style="color:#808080"/> |
| `196x564x0.8` | 右下角<br><img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/d06aabf0173308b00ecbc71969284537" alt="COUNTDOWN_PLACEMENT_11" width="60%" style="color:#808080"/> |
| `57x564x0.8` | 左下角<br><img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/1e8a0fe0e86779da9868de9bbdcf19fe" alt="COUNTDOWN_PLACEMENT_10" width="60%" style="color:#808080"/> |
| `129x370x0.8` | 中心<br><img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/83b408385b884d7ace6770f21ef513e9" alt="COUNTDOWN_PLACEMENT_12" width="60%" style="color:#808080"/> |
|`55x143x0.9`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/be021357066081e5769ba26c955af616" width="60%" style="color:#808080"/>|
|`157x141x0.9`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/7ca2bd7f170e3f73326061de2253fd68" width="60%" style="color:#808080"/>|
|`110x236x0.9`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/912cc599d8297feadd0788b843d46803" width="60%" style="color:#808080"/>|
|`112x327x0.9`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/0543f07c0581ebb192479b3e605fdeef" width="60%" style="color:#808080"/>|
|`105x533x0.9`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/0ff8530da5201a7c7fa76d5ca661c38e" width="60%" style="color:#808080"/>|
|`53x533x0.9`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/b267cea43bf8afcec1649c19bc8d6d01" width="60%" style="color:#808080"/>|
|`143x533x0.9`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/106fb4f10aa987b49a454b0848e301df" width="60%" style="color:#808080"/>|
礼品码贴纸预定义位置
|枚举值{50%}|示例{50%}|
|---|---|---|
| `141x176` | 右上角<br> <img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/7819dfe3260ca32eb3a570b646f87487" alt="GIFTCODE_PLACEMENT_8" width="60%" style="color:#808080"/>|
| `86x176` | 左上角<br> <img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/793f73c6a3858fb71d24142123ac7a34" alt="GIFTCODE_PLACEMENT_9" width="60%" style="color:#808080"/>|
| `141x678` | 右下角<br><img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/a18f865abc0ce80588f83860c15865c2" alt="GIFTCODE_PLACEMENT_10" width="60%" style="color:#808080"/> |
| `86x678` | 左下角<br><img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/f0cdb0da5e922f21322bc7ae57d3acd9" alt="GIFTCODE_PLACEMENT_11" width="60%" style="color:#808080"/> |
| `112x432` | 中心<br><img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/dd60d214a9ac405972727f76cfd52c5c" alt="GIFTCODE_PLACEMENT_12" width="60%" style="color:#808080"/> |
|`86x179`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/b32f3ed996a90e09ac2ff54a968a6f22" width="60%" style="color:#808080"/>|
|`113x179`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/5284de1a9e0d39086c1d05ad35d8c009" width="60%" style="color:#808080"/>|
|`113x308`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/59b13f092993aa8eeef20596299dbf15" width="60%" style="color:#808080"/>|
|`113x462`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/fc3e59ef800b0e8177fb2625bb185ab1" width="60%" style="color:#808080"/>|
|`113x676`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/5ac0e002f63b4664c63dc4f31e9534d1" width="60%" style="color:#808080"/>|
|`88x676`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/1a1adf96886ed0d00875579761853dbb" width="60%" style="color:#808080"/>|
|`138x676`|<img src="https://sf16-adcdn-sg.ibytedtos.com/obj/open-api-file-public-i18n/415777de1d7a02c679b98869d0d3fd1f" width="60%" style="color:#808080"/>|