通过

Microsoft PromoteIQ 技术文档

本指南用作 PromoteIQ 的技术文档。

i. 环境信息

适用于我们的零售商客户的 PromoteIQ 沙盒环境是为测试目的而构建的专用环境。

) PromoteIQ API 终结点：

  • 广告机会：

POST https：//retailer-specific-url/request

  • 印象跟踪器：

GET https：//retailer-specific-url/impression

  • 视图跟踪器：

GET https：//retailer-specific-url/view

  • 单击“跟踪器”：

GET https：//retailer-specific-url/click

  • 转换跟踪器：

POST https：//retailer-specific-url/conversion

b) PromoteIQ Web 门户：

  • URL：https：//retailer-name.promoteiq.com/

访问：当管理员用户将其添加到系统中时，需要访问的用户将收到电子邮件通知

ii. Swagger 文档

PromoteIQ 集成 API Swagger 是 JSON 格式的文档，其中列出了 API 请求的预期模式和参数，以及客户端和服务器端集成响应，可以将其视为 API 协定。 请与技术客户经理联系以接收 Swagger 文档。

该文件是单独提供的，可以通过转到 http://editor.swagger.io/ 并选择“文件 -> 导入文件”来查看这些文档。

第三。 集成类型

PromoteIQ 支持服务器端集成和客户端集成，以及将它们混合用于不同的 PromoteIQ API 调用。 例如，零售商可以在服务器端调用广告机会 API 请求，并根据需要在客户端上调用 Impression 和 Click Tracker API 请求。

) 服务器端集成

此集成类型允许零售商在后端与 PromoteIQ API 进行连接。

b) 客户端集成

此集成类型允许零售商在前端与 PromoteIQ API 进行连接。

四。 请求 & 响应示例流

此示例集成流为零售商提供了简化的讨论文档，用于与 PromoteIQ 进行体系结构讨论和设计会话。 提供了几个请求示例，以说明零售商可以传递一组有机产品，这些产品将用于 PromoteIQ 广告服务器或一组类别标识符，或两者兼有。 零售商还可以传递属性信息（如果可用）。

分步流

) 用户执行搜索或导航到零售商的产品列表页面

b) 零售商根据搜索或浏览页面/结果确定一组产品，以便由 PromoteIQ (和/或一组类别用于类似目标。)

c) 零售商向 PromoteIQ 发出传递这些匹配的产品或类别的请求：

解放军：

示例 POST /request (未筛选的类似产品目标) 

    {
        "user": "retailer-user-id", // hashed retailer user id
        "session": "retailer-session-id", // hashed retailer session id
        "slot": 20010, // static number provided by PIQ
        "targets": {
            "match_products": [ //list of SKUs matching Product Feed
                "14933470", 
                "18796871"
            ]
        },
        "count": 5, // number of product ads requested
        "count_fill": 3, // number of ads that will be shown
        "internal": false // flag to identify test / do not bill traffic
    }

示例 POST /request (未筛选的类别目标) 

    {
        "user": "retailer-user-id", // hashed retailer user id
        "session": "retailer-session-id", // hashed retailer session id
        "slot": 20010, // static number provided by PIQ
        "targets": {
            "category": [ // list of category IDs matching Product Feed
                "Sunglasses-129977", 
                 "SkiGoggles-129807"
            ] 
        },
        "count": 5, // number of product ads requested
        "count_fill": 3, // number of ads that will be shown
        "internal": false // flag to identify test / do not bill traffic
    }

按属性) 筛选的示例 POST /request (

    {
        "user": "retailer-user-id", // hashed retailer user id
        "session": "retailer-session-id", // hashed retailer session id
        "slot": 20010, // static number provided by PIQ
        "targets": {
            "match_products": [ // list of SKUs matching Product Feed
                "14933470", 
                "18796871"
            ],
        "attributes": { // attribute(s) used for filtering
            "color": "black",
             "shape": "round"
            }
        },
        "count": 5, // number of product ads requested
        "count_fill": 3, // number of ads that will be shown
        "internal": false // flag to identify test / do not bill traffic
    }

示例 POST /request (存储位置筛选) 

    {
        "user": "retailer-user-id", // hashed retailer user id
        "session": "retailer-session-id", // hashed retailer session id
        "slot": 20010, // static number provided by PIQ
        "targets": {
            "match_products": [ // list of SKUs matching Product Feed
                "14933470", 
                "18796871"
            ],
            "store_ids": [ // store id(s) used for filtering
                "3554"
            ]
        },
        "count": 5, // number of product ads requested
        "count_fill": 3, // number of ads that will be shown
        "internal": false // flag to identify test / do not bill traffic
    }

示例 POST /request (受众目标) 

    {
        "user": "retailer-user-id", // hashed retailer user id
        "session": "retailer-session-id", // hashed retailer session id
        "slot": 20010, // static number provided by PIQ
        "targets": {
            "match_products": [ // list of SKUs matching Product Feed
                "14933470", 
                "18796871"
            ],
            "audiences": [ // list of Audience_IDs 
                 "20_1",
                 "20_2"
            ]
        },
        "count": 5, // number of product ads requested
        "count_fill": 3, // number of ads that will be shown
        "internal": false // flag to identify test / do not bill traffic
    }

示例 POST /request

    {
        "user": "retailer-user-id", // hashed retailer user id
        "session": "retailer-session-id", // hashed retailer session id
        "slot": 20010, // static number provided by PIQ
        "targets": {
            "category": [ // list of category IDs matching Product Feed
                "Sunglasses-129977", 
                "SkiGoggles-129807"
            ] 
        },
        "width": 750,
        "height": 95,
        "count": 5, // number of product ads requested
        "count_fill": 3, // number of ads that will be shown
        "internal": false // flag to identify test / do not bill traffic
    }

d) 零售商收到模板化响应，其中包含一组已订购的匹配产品广告。

在下面的示例中，响应是包含两个产品的结构化数据集。 该集基于 PromoteIQ 拍卖进行排序，因此在此示例中，第一个产品是赢家，第二个产品是亚军。 “sku”字段用于指示获胜的产品，并且为每个产品提供了“impression_id”，用于对 PromoteIQ 的印象、视图和点击事件 API 调用。

对于上面的请求示例，由于“count”参数的值为 5，因此 PromoteIQ 将在响应中返回最多 5 个产品集。

示例响应

   [
       {
            "product": {
                "available": true,
                "rating": 4.6,
                "reviewCount": 167,
                "description": "<section class="productDescription"><div class="product-component"><p>The sky is the limit with the Oakley&reg; Women’s Tie Breaker Sunglasses. This ultra-feminine frame features a blend of Oakley C-5&trade; wire front and warm tones of an acetate stem.</p></div><div class="product-component"><h3>Fit</h3><ul><li>Three-Point Fit: Comfort and performance that holds lenses in precise optical alignment</li></ul> <h3>Technology</h3><ul> <li>Ultra-lightweight hi-modulus C-5&trade; metal frame material with stress resistant acetate ear stems</li><li>Unobtainium&reg; stem pads prevent glasses from slipping out of place</li></ul><h3>Design</h3></ul></div> <a data-em="Product_PageElement_Prop65" href="http://www.retailer.com/s/california-disclosures" target="_blank">California Proposition 65</a></div></section>",
                "brand": "Oakley",
                "color": "Black",
                "imageLarge": "https://retailer.scene7.com/is/image/GolfGalaxy/19OAKWTBRKRPLBLKPSGS_Pol_Blk_Prizm_Tungsten?wid=2000&fmt=pjpeg",
                "priceList": 186,
                "priceCurrent": 186,
                "priceFlag": "N",
                "priceCurrency": "USD",
                "manufacturer_model_number": "888392404640",
                "imageSmall": "https://retailer.scene7.com/is/image/retailercdn/19OAKWTBRKRPLBLKPSGS_Pol_Blk_Prizm_Tungsten_is/?$Retailer_ProductCard$",
                "name": "Oakley Women's Tie Breaker Sunglasses",
                "onSale": false,
                "sku": "19896667",
                "landingPageUrl": "https://www.retailer.com/p/oakley-womens-tie-breaker-sunglasses-19oakwtbrkrplblkpsgs/19oakwtbrkrplblkpsgs", 
            },
            "impression_id": "ce848523-11bc-4a65-9f9a-6c872c66ec67",
            "impression_tracker": "https://ad-retailer.tagdelivery.com/impression?id= ce848523-11bc-4a65-9f9a-6c872c66ec67",
            "product_id": "123456789",
            "sponsored": true,
            "click_tracker": "https://ad-retailer.tagdelivery.com/click?id=ce848523-11bc-4a65-9f9a-6c872c66ec67&redirect=",
            "view_tracker": "https://ad-retailer.tagdelivery.com/view?id=ce848523-11bc-4a65-9f9a-6c872c66ec67&redirect=",
            "campaign_id": 12345
       }, 
       {
            "product": {
                "available": true,
                "rating": 4.7,
                "reviewCount": 213,
                "description": "<section class="productDescription"><div class="product-component"><p>You'll want to stay out in the sun longer to show off the Ray-Ban&reg; Chris Sunglasses. Featuring a rubber finish with a textured feel and a lightweight element for easy wear, these frames will add an instantly cool vibe to any outfit.</p></div><div class="product-component"><h3>Fit</h3><UL><LI>Frames compliment most face shapes</LI></UL><h3>Design</h3><UL><LI>Square shape</LI><LI>Rubber frame finish for a textured feel</LI></UL><h3>Specs</h3> <UL><LI>Size lens-bridge: 54 18</LI><LI>Temple Length: 145</LI></UL></div> </section>",
                "brand": "Ray-Ban",
                "color": "Multi",
                "imageLarge": "https://retailer.scene7.com/is/image/GolfGalaxy/19RYBACHRSRBRBLKGSGS_Rbr_Blk_Gry_Gra_Drk_Gry?wid=2000&fmt=pjpeg",
                "priceList": 143,
                "priceCurrent": 147,
                "priceFlag": "N",
                "priceCurrency": "USD",
                "manufacturer_model_number": "713132581131",
                "imageSmall": "https://retailer.scene7.com/is/image/retaiercdn/19RYBACHRSRBRBLKGSGS_Rbr_Blk_Gry_Gra_Drk_Gry_is/?$Retailer_ProductCard$",
                "name": "Ray-Ban Chris Sunglasses",
                "onSale": false,
                "sku": "19896712",
                "landingPageUrl": "https://www.retailer.com/p/ray-ban-chris-sunglasses-19rybachrsrbrblkgsgs/19rybachrsrbrblkgsgs", 
               }, 
       }
   ….]

e) 零售商将产品 () 正常呈现到页面上，以及包含赞助产品的“impression_id”的标记。

f) 零售商要么将印象、视图和点击跟踪器作为客户端的像素触发，要么对分析流进行后期处理，以异步方式设置事件调用的格式并发送事件调用，并为每个呈现的印象、查看的印象或点击的产品传递impression_id。

注意：impression_id的 TTL 为 6 小时。 6 小时后收到的印象、可见印象和点击数将被丢弃。

g) 零售商单独调用 PIQ 的 /conversion 或 /collect 终结点，以同步或异步方式将订单数据发送到 PromoteIQ。

槽级别选项

对于每个库存槽，还有几个可在 PromoteIQ 中配置的选项。 这些设置通常不同，例如，对于网格内搜索请求与产品详细信息页面轮播请求。

名称 说明 选项
完全匹配 此参数指示将产品传递到 PromoteIQ 进行匹配时的响应行为。 如果内容与默认match_product (匹配，则 TARGET 会提高内容分数) FILTER 删除match_product列表中$A R E$ $N O T$ 的所有内容，$E X C L U D E$ 删除match_product列表中$A R E$ 的所有内容
推断品牌定位 此参数指示 PIQ 应假定体验具有品牌 (例如搜索特定品牌、品牌筛选器) 发送到 PIQ 的产品集来自同一品牌。 INFERRED BRAND FILTER ENABLED (Y 或 N) 阈值指示平台应用筛选器需要相同产品的百分比
属性筛选 此参数指示在零售商产品源中可用时，应如何使用产品属性 (例如颜色) 。 如果内容与此属性匹配，则 TARGET 会提高内容的分数 FILTER 删除与此属性的匹配项中$A R E$ NOT 的所有内容
深度增量 此参数控制在匹配符合条件的产品时允许广告服务器遍历分类层次结构的上行程度。 例如，深度 Delta = 0 指示广告服务器仅显示最精细级别匹配的产品（零售商为 L3）。 深度增量 = 1 仍将首先显示最相关的 L3 匹配产品，但如果 L3 级别没有匹配项，服务器将返回 L2 产品。 DEPTH_DELTA排名符合条件的产品时允许广告服务器遍历的分类级别数
可测量的 此参数指示槽是否已实现可查看性度量 True/False

v. 事件跟踪

PromoteIQ 支持两种方式的印象、视图和点击跟踪器 API 调用：

  • 通过构造自己的调用来调用相应的终结点，或者
  • 使用广告机会响应中的impression_tracker、view_tracker和click_tracker URL 调用。

Impression_tracker (呈现的印象) ：通常在页面加载或视图时触发。 此指标用于计算用户可以查看广告的次数。 PIQ 建议在页面加载时触发此事件。

View_tracker (可查看印象) ：此指标用于捕获可查看的印象。 PIQ 建议遵循 IAB 和 MRC 可查看性准则，在用户可见空间中 1 秒内广告为 $50 %$时触发view_tracker。

view_tracker 事件不应替换impression_tracker。 PromoteIQ 建议将视图和印象事件发送到：

  1. 丰富用于预测和故障排除的数据模型
  2. 启用基于视图的横幅盈利
  3. 启用基于视图的 PLA 优化
  4. 向广告客户扩展可查看性报告
  5. 遵守 MRC 可查看性准则

Click_tracker：用于捕获用户参与 PLA 或横幅的指标。

六。 转换跟踪

PromoteIQ 提供了一种机制，用于跟踪和归因由 PromoteIQ 市场活动驱动的市场活动转换。 PromoteIQ 还支持以下各项：

  • 转换源：联机和 In-Store
  • 转换类型：一次性购买、订阅 (自动交付) 购买、加载项到购物车、加载项列表。
    • Add-To-Cart 和 Add-To-List 要求零售商发送此转换指标，用于有机列表和赞助列表上的所有 Add-To-Cart/Add-To-List 交互。 PLA 上的加载项到购物车交互需要将两个事件发送到 PIQ 1) 点击跟踪器事件和 2 个) ATC 转换跟踪器。

请与技术客户经理联系，详细了解支持的转换类型。

转换跟踪实现

本部分介绍将转换跟踪与现有“谢谢”页集成以通知 PromoteIQ 转换的过程。

可以使用以下方法将订单发送到 PromoteIQ：

  1. /conversion 终结点直接从服务器端
  2. /conversion 终结点直接从客户端 (不支持 CORS)
  3. JavaScript 客户端

PromoteIQ 的分析平台在调用 /conversion 终结点时识别以下参数对象。 这些表描述了此哈希的键值对。

订阅购买的示例 POST /conversion

以下示例演示了如何使用 /conversion 终结点实现转换跟踪。

{
    "pid": "retailer-specific-Id", //static number provided by PIQ
    "txnid": "order-1234",
    "user": "session-1234",
    "customer": "customer-5678",
    "currency": "USD",
    "revenue": 5.99,
    "source_type": "online",
    "conversion_type": "SUBSCRIPTION",
    "items": [{ 
                "sku": "0004300004641",
                "price": 6.99,
                "sold_price": 5.99,
                "recurring_qty": 1,
                "recurring_sold_price": 0
            }]
}

加载项购物车的示例 POST/转换

{
     "pid": "retailer-specific-Id", //static number provided by PIQ
     "user": "session-1234",
     "customer": "customer-5678",
     "currency": "USD",
     "source_type": "online",
     "conversion_type": "ATC",
     "items": [{
                "sku": "0004300004641",
                "price": 6.99,
                "qty": 1
             }]
}

b) Javascript 客户端

加载 Javascript 客户端会将 TagDeliveryData 对象添加到全局范围 (例如窗口。TagDeliveryData) 。 此对象上提供了两种记录的方法：

方法 1：TagDeliveryData.collect (事件，[parameters=null])

此方法通过为已加载但未附加到 DOM 的图像像素创建 URL，以参数的形式收集指定事件的数据。

参数 类型 是否必需？ 说明
Event String 始终 以下事件类型之一
参数 Object 可选 一个对象/哈希，其中包含事件的相应键和值

返回值

  • 指示成功分析和传输事件及其数据的布尔值

方法 2：TagDeliveryData.getErrors ()

此方法提供自上一次调用此方法以来在 TagDeliveryData 模块中记录的所有错误，如果以前从未调用过，则提供自页面加载以来记录的所有错误。 在开发和集成期间最有用/最相关的调试，但也可用于生产监视。

返回值

  • 包含错误字符串的数组。 可以为空。

事件类型

PromoteIQ 的分析平台当前可识别以下事件，在调用 TagDeliveryData.collect () 时，每个事件都需要不同的参数。 这些表描述了每个事件类型的此哈希的键值对。

  • conversion：summary
    捕获有关转换或购买的高级详细信息。 除非提供项，否则不允许使用 SKU 或产品级属性。

  • conversion：item
    从转换或购买中捕获行项详细信息。 可以/应针对购买中的每个行项重复调用。

示例

以下示例演示了如何使用 Javascript API 实现转换跟踪。 单个调用示例最具启发性，并提供了 API 工作原理的最佳理解，组合调用显示更适合实际生产使用的模式。

示例组合 GET /collect

可以对 TagDeliveryData.collect () 进行单个组合调用，以同时提供 conversion：summary 和 conversion：item 数据。 父级和子级中存在的密钥不需要包含在子级 (例如 txnid 和客户) 。

<script type="text/javascript" src="https://cdn.tagdelivery.com/data/client/standard.full.js"></script>

/* PIQ provides a deployment-specific ID for conversion tracking -- contact your account manager for 
details */

var myPromoteIqId = 'SomeIdFromPIQ';

/* Submitting summary data to PIQ */
var success = TagDeliveryData.collect(
 'conversion:summary',
 {
     pid: ‘myPromoteIqId’,
     txnid: 'Order-1234',
     user: 'Session-1234'
     customer: 'Customer-5678',
     revenue: (42 + 5 + 4.20),
     shipping: 5,
     tax: 4.20,
     currency: 'USD',
     conversion_type: 'ONETIME',
     items: [
             {
                 sku: 'Product-ABC',
                 qty: 2,
                 price: 15,
                 brand: 'Brand-321',
                 supplier: 'Vendor-987',
                 rfc: 10,
                 sfc: 7
             },
             {
                 sku: 'Product-DEF',
                 qty: 1,
                 price: 12,
                 brand: 'Brand-654',
                 supplier: 'Vendor-543',
                 rfc: 9,
                 sfc: 6
             }
            ],
     tags: ['DESKTOP', 'FOO']
 }
);
if(success){
 console.log('Successfully submitted conversion:summary and conversion:item data');
} else {
 console.error('Error(s) while submitting conversion:summary and/or conversion:item data', 
TagDeliveryData.getErrors());
}

个人 GET/收集

可以对 TagDeliveryData.collect () 进行多次调用，以提供转换：摘要和转换：项数据：

<script type="text/javascript" src="https://cdn.tagdelivery.com/data/client/standard.full.js"></script>

/* PromoteIQ provides a deployment-specific ID for conversion tracking -- contact your account manager for details */
var myPromoteIqId = 'SomeIdFromPIQ';

/* Submitting summary data to PIQ */
var summarySuccess = TagDeliveryData.collect(
 
/* event type */
 'conversion:summary',
 
 /* parameters object with appropriate keys for event type */
 {
     pid: myPromoteIqId,
     txnid: 'Order-1234',
     user: 'Session-1234',
     customer: 'Customer-5678',
     revenue: (42 + 5 + 4.20),
     shipping: 5,
     tax: 4.20,
     currency: 'USD',
     conversion_type: 'SUBSCRIPTION',
 }
);
if(summarySuccess){
 console.log('Successfully submitted conversion:summary data');
} else {
 console.error('Error(s) while submitting conversion:summary data', TagDeliveryData.getErrors());
}
var firstProductSuccess = TagDeliveryData.collect(
 'conversion:item',
 {
     pid: myPromoteIqId,
     txnid: 'Order-1234',
     sku: 'Product-ABC',
     user: 'Session-1234',
     customer: 'Customer-5678',
     qty: 1,
     price: 14,
     recurring_qty: 2,
     currency: 'USD',
     brand: 'Brand-321',
     supplier: 'Vendor-987',
     rfc: 10,
     sfc: 7
 }
);
if(firstProductSuccess){
 console.log('Successfully submitted conversion:item data for first product');
} else {
 console.error('Error(s) while submitting conversion:item data for first product', 
TagDeliveryData.getErrors());
}
var secondProductSuccess = TagDeliveryData.collect(
 'conversion:item',
 {
     pid: myPromoteIqId,
     txnid: 'Order-1234',
     sku: 'Product-DEF',
     user: 'Session-1234',
     customer: 'Customer-5678',
     recurring_qty: 1,
     price: 12,
     currency: 'USD',
     brand: 'Brand-654',
     supplier: 'Vendor-543',
     rfc: 9,
     sfc: 6
 }
);
if(secondProductSuccess){
 console.log('Successfully submitted conversion:item data for second product');
} else {
 console.error('Error(s) while submitting conversion:item data for second product', 
TagDeliveryData.getErrors());
}

七。 产品源概述

产品源开始与 PromoteIQ 的集成，应在流程开始时可供 PromoteIQ 访问。 源越早交付到 PromoteIQ，集成开始速度越快。

产品源（有时称为产品数据馈送）是一种持续更新的数据流，其中包含有关电子商务网站上提供的产品的所有相关元数据。 PromoteIQ 使用产品源在交付期间通知目标，在许多情况下，使用产品数据为购物者呈现有关促销的信息。 我们还使用产品源数据为广告商的营销活动创建流程提供支持。 在市场活动创建过程中，广告客户将看到与其帐户关联的可用产品列表，以供促销选择。

产品源包括产品分类和其他产品元数据。 产品分类对于使产品准确定位到网站上的库存和页面尤其重要。

保持源中的数据质量对于为购物者提供良好的最终用户体验至关重要。 高度精细、更新和完整的产品数据可实现更好的定位，并推动更高的 CDR (点击率) 和转换。

规格

本部分简要概述了数据要求。 本文档的附录中提供了每个源中所需数据的更详细概述。

产品源中的每个项目都应包含所需的信息，例如 SKU 编号、价格、品牌、图像 URL、登陆页 URL、库存中/售完指示器和分类。

我们支持产品源 API 或任何标准基于文本的交换格式，例如采用 UTF-8 编码的 CSV、TSV 或 JSON。

零售商通常每天发送一次完整的产品源到 PromoteIQ。 可以根据需要容纳更频繁的更新，在这些情况下，更新可以限制为增量。

集成

PromoteIQ 提供产品源 API 及其 swagger 文档。

如果选择不使用 API，则 PromoteIQ 还会提供 SFTP 服务器，该服务器可用于按常规节奏传递源文件。 若要通过 SFTP 服务器发送产品源文件，需要设置基于密钥的身份验证。 执行此操作的步骤如下：

  1. 客户端创建 SSH 密钥对，并向我们发送公钥，以及将连接到 SFTP 服务器的任何 IP 地址列表
  2. PromoteIQ 使用公钥配置 SFTP 服务器，允许列出 IP 地址，并提供放置位置
  3. 客户端在上传到服务器时使用私钥进行身份验证

Bash 示例

echo "put local/path/to/feed.csv" | sftp -b - -i  
local/path/to/ssh private key you@sftp.promoteiq.com :~/data

源管理

组织内有多个团队可以创建和/或管理产品源：

  • ETL 团队
  • 产品信息管理团队
  • 管理产品数据的任何团队

作为加入/实施过程的一部分，请务必与这些团队沟通，以确定产品/源更新计划。 意外更新或未传达的更新可能会导致产品无法在 PromoteIQ 系统中进行促销。

八。 销售归属

销售归因是衡量数字广告活动效果的关键一步。 销售归属，反过来，ROAS (广告支出) 的回报，对于定量评估广告市场活动的表现至关重要。

每个 PromoteIQ 计划捕获销售和归因数据，以提供见解和报告，以确定未来的预算、策略和营销方向。

PromoteIQ 支持根据需求配置属性。

  • 属性窗口：横幅) 默认为 1、7、14 (，PLA) 天默认为 30 (
  • 属性光环：
    • 品牌光环效果 (默认) ：如果购买的产品与任何单击的 PLA 或查看的横幅来自同一品牌，则购买的产品的付费价格将归因于 PLA 的最新点击以及该品牌横幅的最新印象。 特性化产品不需要是赞助产品。
    • 类别光环：如果品牌跨不同的子类别推广多个横幅和 PLA，则如果市场活动中推广的 SKU/横幅与购买的 SKU 属于同一类别，则转换有资格归因于市场活动。 类别 Halo 旨在提高广告和购买之间的相关性。

PromoteIQ 归因要求

PromoteIQ 提供了多种归因模型，使零售商能够灵活地满足各种垂直行业、广告商、购物者行为和业务目标的需求。 默认情况下，PromoteIQ 对赞助产品使用点击后和印象后“品牌光环效果”归属模型。 请与技术客户经理协作，了解可用选项。

默认归因模型的工作原理

  • 订单明细项目详细信息在每次购物车签出后发送到 PromoteIQ。这包括但不限于 - 购物者标识符 () (仅用于归因销售) 、购买的产品、转换类型、来源类型、价格数量。
  • PromoteIQ 检查每个订单明细项目，以确定购物者是否与产品列表广告 (PLA) 或横幅有一个符合条件的交互， (30 天的发布点击为 PLA，14 天的后视图横幅) 。
  • 如果购买的产品来自与任何点击的 PLA 或已查看横幅的同一品牌，则购买的产品的付费价格归因于 PLA) 的最新点击 (，以及来自该品牌的横幅) 的最新印象 (。 特性化产品不需要是赞助产品。

隐私和 PII

PromoteIQ 不会从通过 PromoteIQ 客户和部署与 PromoteIQ 系统交互的 Internet 用户收集任何个人身份信息 (PII) 。

因此，PromoteIQ 客户传递到 PromoteIQ 转换跟踪机制的任何值不应直接包含任何 PII：

  • Names
  • Addresses
  • 电话号码
  • 电子邮件地址
  • 社交媒体处理 (“屏幕名称”)
  • 社会安全号码
  • 银行信息/记录
  • 信用卡数据
  • 等。

匿名客户标识符 (即“Customer 24234”) ，以及适当加盐和哈希的 PII 字符串是可接受的。

PLA 战役摘要

  • 归因模型：上次单击
  • 单击后属性化？ 是
  • 查看后属性化？ 否
  • 属性窗口：默认) (30 天
  • 属性光环：品牌光环 (默认)
  • 条件：对于点击后购买的任何属于已推广产品的品牌的商品，将销售额归入

PLA 归因机制

在用户单击促销产品后，在默认属性窗口中以同一品牌购买该产品或相关产品后，购买将归因于市场活动。 当实时事务日志发送到 PromoteIQ 时，我们的销售归因科学将查看是否有任何购买符合属性销售条件。

通过引用事务日志中的用户哈希信息来查找特性销售，以查看它是否与过去 30 天内的任何单击相关联。 如果点击和购买来自同一品牌，则购买可以归因于该市场活动。

对于出现在多个市场活动中的产品，PromoteIQ 将购买属性为与该产品关联的最近点击市场活动。

  • 属性模型：上次查看
  • 单击后属性化？ 否
  • 查看后属性化？ 是
  • 属性窗口：默认) (14 天
  • 属性光环：品牌光环 (默认)
  • 条件：对于在查看后购买的任何属于促销产品的品牌的商品，将销售额归入

机制与解放军战役类似。 默认) 有一个为期 14 天的归因窗口 (，我们的归因引擎将搜索事务日志，以查看用户的任何哈希信息是否与过去 14 天内的任何视图相关。

点击后属性优先或胜过查看后归因。

属性 Set-Up

我们的集成团队将致力于：

  • 使用适当的属性字段建立安全的事务日志流。 这可以通过用于客户端集成的结帐页上的前端像素跟踪器完成，也可以将日志发送到安全的 PromoteIQ 终结点进行服务器端集成。
  • 根据需要配置属性规则集 (属性窗口、归因光环) 。

查看属性信息

可以在 PromoteIQ UI 的以下位置找到属性信息：

  1. PromoteIQ 在每个市场活动管理器仪表板中显示 ROI 和销售单位。
  2. 可通过 PromoteIQ 报告模块获取属性数据。 预设和自定义报表包括各种归因指标，如 ROAS、销售单位和总销售额

九。 报告字段

Dimensions 指标名称 说明 数据类型 接受的值
Campaign 访问级别 访问级别：零售商或供应商 Text 零售商、供应商
拍卖位置 促销Q拍卖引擎选择产品的顺序，位置 1 是拍卖选择的第一个促销，通常是购物者最明显的促销 数字 整数
已预订 SOV 市场活动赢得与库存和目标条件匹配的所需展示百分比 (仅可用于赞助位置) number $0-100$
预算金额 市场活动的当前预算金额 数字 任何
预算间隔 为市场活动选择了预算间隔。 可能的值为“每日”、“每周”、“每月”或“生存期” Text 每日、每周、每月、生存期
市场活动计费 ID 媒体市场活动计费 ID，用于媒体规划目的 数字 任何
活动创建者 (电子邮件) 首次创建并保存市场活动的 PromotelQ 用户的电子邮件地址 Text 电子邮件
市场活动创建者 (名称) 最初创建并保存了市场活动的 PromotelQ 用户 Text 任何
市场活动 ID 为每个市场活动分配的 PromotelQ 唯一 ID Text 任何
市场活动上次更新 (电子邮件) 上次更新市场活动的用户的电子邮件地址 Text 任何
市场活动上次更新程序 (名称) 上次更新市场活动的用户的名称 Text 任何
市场活动启动器 (电子邮件) 首次发起市场活动的 PromotelQ 用户的电子邮件地址 Text 电子邮件
市场活动启动器 (名称) 发起市场活动的 PromotelQ 用户 Text 任何
市场活动名称 所选市场活动的名称 Text 任何
市场活动状态 当前市场活动状态。 可能的值为 Draft、Queued、Active、Paused 或已结束 Text 草稿、已排队、活动、已暂停、已结束
创建日期 市场活动首次创建和保存的日期 日期 任何
已交付的目标 ID 已交付目标的目标 ID 数字 任何
已交付的目标分类 已交付目标的完整类别分类 Text 任何
已交付的目标 目标名称针对市场活动的目标组传递的市场活动 Text 任何
End Date 活动的当前结束日期 日期 任何
印象帽 每日 (CPD) 或在活动生存期内提供的最大展示次数 (总预算) 数字 整数
启动日期 市场活动启动日期 日期 任何
Pacing 方法 市场活动的支出节奏配置 Text ASAP 或 Even
放置名称 零售商定义的给定位置的名称 Text 任何
放置类型 指示零售商定义的放置类型。 可能的值为 PLA 或横幅 Text PLA，横幅
槽名称 零售商定义的槽的名称 Text
开始日期 市场活动的当前开始日期 日期 任何
清单 平均底价 跨槽位和位置的平均底价。 数字 任何
放置 ID PromotelQ 为给定放置生成了唯一 ID Text 系统生成
放置名称 零售商定义的放置名称 Text 任何
请求的目标 ID 市场活动请求的目标的 PromotelQ 生成 ID Text 系统生成
请求的目标分类 请求了市场活动的完整网站分类 Text
请求的目标 市场活动请求的目标的名称 Text 任何
零售商目标 ID 零售商可用于在自己的系统中跟踪类别 ID 的引用。 Text 任何
槽 ID PromotelQ 为给定槽生成了唯一 ID Text 系统生成
槽名称 零售商定义的槽的名称 Text
产品 类别分类 基于产品源，与 PromotelQ 中的产品关联的完整网站分类。 例如，目标分类将返回“我的购物车”，而商店分类仍然是杂货 > 碳酸饮料。 Text
促销产品/创意 ID 产品源中的已推广产品 ID Text
促销产品/创意名称 供应商在活动中推广的 SKU 的产品名称 Text
已升级的 SKU 供应商在活动中推广的 SKU 编号。 横幅为空 Text
单价 (交互 SKU) 交互产品的单价 数字
销售 购买的产品) (的平均单价 购物者在销售时支付的平均价格 数字
交互产品/创意 购物者在购买前与之互动的最后一个促销产品或创意的名称 Text
交互的 SKU 购物者在购买前单击的最后一个促销产品的 SKU。 对于没有 SKU 的放置，将为空。 Text
订单日期 购买订单的时间和日期 日期
订单 ID 与链接到购物者的已完成交易关联的零售商的唯一标识符。 Text
Position 促销Q拍卖工程师选择产品的顺序，位置 1 是拍卖选择的第一个促销，通常是购物者最明显的促销 数字 整数
购买的产品名称 购买的产品的名称 Text
购买的 SKU 已购买产品的 SKU Text
总销售额 属于 promotelQ 活动的产品销售的所有销售额的总和 数字
销售单位 由于 PromotelQ 活动而销售的单位计数 数字
供应商名称 PromotelQ 中供应商帐户的名称 Text
用户 用户) (创建日期 用户创建日期 (dd-mm-yyyy) 日期
上次登录 用户帐户的最近登录日期 (dd-mm-yyyy) 日期
权限 (帐户 ID) 用户在生成报表时有权访问的所有帐户 ID 的列表 Text
权限 (帐户名称) 用户在生成报表时有权访问的所有帐户名称的列表 Text
用户电子邮件 与用户帐户关联的电子邮件地址 Text 电子邮件
用户名 名字，与用户帐户关联的姓氏 Text
User Type 生成报表时，PromotelQ 用户的状态为“标准”或“管理员” Text 标准、管理员
供应商 PromoteIQ 供应商 ID 给定供应商的 PromotelQ 分配的唯一 ID Text 系统生成
零售商供应商 ID 零售商用于标识特定供应商的唯一 ID Text 任何
供应商名称 PromotelQ 中供应商帐户的名称 Text 任何
度量标准 指标名称 说明 数据类型
性能 平均订单值 每个订单产生的平均销售额，其中至少有一个销售额归因于 PromotelQ (总销售额/订单计数) 数字
平均单位销售值 每个销售单位的平均值，归因于 PromotelQ (总销售额/销售单位) 数字
点击 在指定时间段内记录的点击总数 数字
注册 会计师 每次购置成本 - 每个销售转换的广告支出量。 也称为转换成本。 (支出/订单计数) 数字
中国共产党 每次单击成本：指定时间段内单击的平均成本 (支出/单击次数) 数字
CPM 每工厂成本 - 指定时间段内每千美元的平均成本 $ ($ 支出/展示次数 * 1000$) $ 数字
点击率 Click-Through 率 - 购物者在指定时间段内点击展示位置的平均速率 (点击次数/展示次数) 百分比
高中标 市场活动的最高出价。 由零售商用来查看市场活动的出价范围。 可用于检测正常出价范围和离群值。 数字
最高付费 CPC 供应商为指定日期范围内的市场活动支付的最高 CPC。 数字
展现量 指定时间段的总展示次数 数字
低中标价 市场活动的最低出价。 由零售商用来查看市场活动的出价范围。 可用于检测正常出价范围和离群值。 数字
最低付费 CPC 供应商为指定日期范围内的市场活动支付的最低 $\mathrm{CPC}$ 。 数字
ROAS 广告支出回报率 - 指定时段内广告支出的平均回报率 (总销售额/支出) 百分比
SKU 转换率 购物者在促销产品上点击导致订单计数/点击数 (归因销售的平均速率) 百分比
SKU 订单计数 具有归因于市场活动转换的唯一 SKU 数的订单计数 数字
花费 指定时间段的总支出 数字
总销售额 属于 promotelQ 活动的产品销售的所有销售额的总和 数字
销售单位 由于 PromotelQ 活动而销售的单位计数 数字
供应 广告呈现率 在页面上成功呈现的 PromotelQ 返回的广告的百分比。 (印象/响应) 百分比
广告响应 赢得拍卖并退回零售商网站进行促销的产品数量 数字
点击 报告期间记录的点击数之和 数字
中国共产党 每次单击成本：平均每次点击成本 (支出/点击次数) 数字
CPM 每千次成本：平均每次点击成本 (支出/展示次数/1000) 数字
点击率 Click-Through 率 - 购物者点击广告的平均速率 百分比
最高中标 (目标) 目标的最高出价。 由零售商用来查看市场活动的出价范围。 可用于检测正常出价范围和离群值。 数字
展现量 网站上成功呈现的广告响应总和 数字
最低中标 (目标) 目标的最低出价。 由零售商用来查看市场活动的出价范围。 可用于检测正常出价范围和离群值。 数字
无产品响应 用于测量填充速率的便利字段。 值是机会与已交付响应之间的差异。 (机会 - 响应) 数字
机会 显示广告的可用机会总数 数字
请求 零售商向 PromotelQ 发出的请求数 数字
ROAS 广告支出 (总销售额/支出) 的平均回报 百分比
花费 供应商的支出总和 数字
总销售额 可归因于 PromotelQ 活动的所有产品的零售价之和 (单价 * 销售单位) 数字
True 填充率 最终填充完全呈现的推广广告 (展示/机会) 的机会百分比 百分比
转换 SKU 订单计数 - RULESETNAME 具有归因于市场活动转换的唯一 SKU 数 数字
销售单位 - RULESETNAME 归于 PromotelQ 市场活动的已排序特性化单位数 数字
总销售额 - RULESETNAME 属于 PromotelQ 市场活动的产品销售的所有销售额的总和 数字
总销售额 (销售价格) - RULESETNAME 由购物者支付的、归于 PromotelQ 活动的总金额之和 数字
按转换源的销售额 - RULESETNAME 属于 PromotelQ 市场活动的产品销售的所有销售额的总和，按转换源细分 数字
点击 在指定时间段内记录的点击总数 数字
展现量 指定时间段的总展示次数 数字
花费 指定时间段的总支出 数字

x. 产品源定义

字段 类型 是否必需？ 说明
name String 必需 SKU 友好名称
partnerRef String 必需 提供产品的品牌或合作伙伴的零售商的内部 ID，如果品牌 ID 不存在，请填充品牌名称
partnerName String 可选 提供产品的品牌或合作伙伴的名称
sku String 必需 零售商的产品内部参考
id String 如果与 SKU 不同 其他零售商产品 ID;如果面向客户的产品 ID 和内部 ID 不同 (仅当不同于 $s k u$ )
parent_sku String 可选 父产品的 SKU
partnerModelRef String 可选 制造 ID
可用 布尔值 必需 SKU 库存状态
imageLarge String 必需 用于呈现促销的产品图像的 URL
imageSmall String 必需 在 PromoteIQUI 中使用的产品图像 URL - 缩略图
说明 String 如果在促销中使用 SKU 说明
priceCurrency String 可选 3 个字符的 ISO 4217 货币代码 (例如“USD”)
firstCost 浮点 可选 产品的第一个成本 (例如合作伙伴对零售商的价格) （如果用于计算 ROI）
priceList 浮点 可选 产品的标价 (例如标准全价)
priceCurrent 浮点 必需 产品的当前价格 (例如，反映任何当前销售或特价)
分类学 Array 必需 SKU 分类层次结构。 如果可能，请同时发送 ID 和友好名称 Ex。 [“服装>>夹克让·夹克“， ”dept_id_1 > category_id_1 > category_id_1“]
itemAttributes Object 可选 任何零售商特定属性和关键非标准信息
color Array 可选 例如， [“red”]
gender Array 可选 例如， [“女性”]
siteEligibility Object 可选 产品源是否支持多个零售商电子商务网站
siteA 布尔值 可选 产品对网站的适用性指示器
attrName Array 可选 (ageGroup 等 ) 的任何其他属性都可以以“attrName”的形式发送：[“attrValue”]
landingPageUrl String 必需 零售商网站上用作点击目标的产品详细信息页面的 URL
位置 Array 可选 SKU 有库存的商店 ID 列表
额定值 浮点 可选 产品评级来自使用反馈 (例如 4.5 星，共 5 )
评论 整数 可选 用户提交的评论/评分数
onSale 布尔值 可选 指示产品是否在销售或进行特别促销的标志 - 如果省略，则自动替换为列表和当前价格的比较
thirdPartySellers Array 可选 销售产品的任何第三方卖家
id
name
priceCurrent
可用
itemAttributes
siteEligibility Object 可选 如果第三方卖家向多个零售商电子商务网站销售
siteA 布尔值 可选 产品对网站的适用性指示器
attrName Array 可选 (ageGroup 等 ) 的任何其他属性都可以以“attrName”的形式发送：[“attrValue”]
childSkus Array 可选 每个 childSku 都表示一个 SKU。 ChildSku 单个对象将类似于基础产品对象