通过

通用事件跟踪

  • 项目

UET 是一个功能强大的Microsoft广告工具。 只需创建一个 UET 标记，然后将其添加到您的网站一次。 此标记记录客户在你的网站上执行的操作，然后Microsoft广告开始收集该数据，以便跟踪转化 (，例如购买或潜在顾客) 或使用再营销列表的目标受众。 UET 是付费搜索中转换跟踪和再营销的先决条件。

通用事件跟踪

可通过几个步骤进行此设置。 你将需要执行以下操作：

有关详细信息，请参阅以下 API 概述部分：

通用事件跟踪 API

在使用再营销列表跟踪转换或目标受众之前，需要在 Microsoft Advertising (Web 应用程序或 API) 中创建 UET 标记，然后将 UET 标记跟踪代码添加到网站的每个页面。 本部分介绍如何使用必应广告 API 设置 UET 标记。 有关使用 Microsoft Advertising Web 应用程序设置 UET 标记的信息，请参阅如何实现创建 UET 标记？和常见问题解答：通用事件跟踪。

注意

对于本部分所述的每个操作，必须在 CustomerId 标头元素中指定客户标识符。

  1. 首先，应调用 GetUetTagsByIds 操作来检查是否已创建标记。 可以将 TagIds 元素保留为 null 或为空，以请求客户可用的所有 UET 标记。
  2. 可以将一个 UET 标记用于所有转换目标和再营销列表。 创建多个 UET 标记之前，请参阅 创建多个 UET 标记的原因。 如果还没有可以使用的 UET 标记，或者如果需要另一个 UET 标记，请调用 AddUetTags 服务操作以创建新的 UET 标记。 如果调用成功，则应添加到网站的跟踪脚本包含在响应消息中的相应 UetTag 中。 稍后，可以根据需要使用 UpdateUetTags 操作更新 UetTag 的名称和说明。

从 AddUetTags 或 GetUetTagsByIds 操作检索跟踪脚本后，下一步是将 UET 标记跟踪代码添加到网站。 建议你或网站管理员将其添加到整个网站的头部或正文部分。 如果网站具有网站范围的布局页面，则这是添加它的最佳位置，因为添加一次，并且它包含在所有页面上。 有关详细信息，请参阅如何实现将 UET 标记添加到我的网站？

根据你想要执行的操作，设置 转换跟踪 或 访问群体。

转换目标 API

UET 最大的价值主张之一是，它允许你在网站上安装一个标记来跟踪多种类型的转换。 将 UET 标记跟踪代码添加到您的网站后，Microsoft广告可以记录页面访问和任何自定义事件，例如订阅新闻稿或下载文档。

但是，并非所有操作的创建都相同。 你可能有一部分操作，你认为这些操作对于成功的广告活动更重要。 这些可能包括进行购买、填写潜在客户表单或观看视频。 这是转换目标可以提供帮助的地方。 转换目标允许指定 UET (记录哪些操作) 计为转换。 有关转换Goals的详细信息，请参阅什么是转换目标和目标类型？。

转换目标市场活动管理 API

有五种类型的转换目标。 ConversionGoal 是派生所有目标的基类。

以下操作可用于管理转换目标。

访问群体 API

通过针对特定受众优化市场活动来提高投资回报，这些受众是与你的市场活动有共同点的人组。

访问群体类型

Microsoft广告支持多种受众类型。

组合列表

组合列表是从多个现有访问群体的组合中创建的受众。

可以组合自定义受众、客户列表、产品访问群体、类似受众和再营销列表。 不能在组合列表中包括其他组合列表或市场受众。

每个广告帐户最多可以创建 1,000 个组合列表，每个客户最多可以创建 5,000 个列表。 每个列表最多可以包含 100 个组合规则或逻辑条件集，每个组合规则最多可以包含 100 个访问群体 ID。

对于下面所述的一些限制，可以使用以下逻辑运算符组合访问群体：

  • 或者：这将包括这些访问群体列表中的客户。
  • AND：这将仅包括每个访问群体列表中的客户。
  • 不：这将排除这些访问群体列表中的客户。

对逻辑表达式的求值确定谁将添加到组合列表中。 多个组合始终与 AND 函数结合使用。 这意味着客户必须满足每个组合的所有条件才能出现在此自定义组合访问群体列表中。

组合列表必须至少包含一个使用 OR 或 AND 运算符的受众。 组合列表不能仅使用 NOT 运算符。 在这种情况下，应改用受众排除项。

自定义访问群体和客户列表不能与其他访问群体类型结合使用。

无法通过 AND 或 NOT 运算符合并类似的受众。 类似的访问群体只能在单个 OR 条件中使用。 换句话说，只能有一个访问群体集包含类似的访问群体，并且该集必须使用 OR 运算符。

允许重复访问群体，但无法通过 AND 和 NOT 运算符合并相同的访问群体 ID。

自定义访问群体

通过使用自己的客户数据创建更丰富的用户细分，可以生成自定义受众。 可以将自定义受众与再营销列表结合使用，通常通过数据管理提供程序 (DMP) 。 当 DMP 连接到我们的自定义受众功能时，你可以将自定义受众导入Microsoft广告中，以便进行搜索再营销。 可以独立于再营销使用自定义受众，无需 UET。 仅第一方受众数据 (你从自己的网站或应用收集的客户数据，例如，) 允许在Microsoft广告网络上进行定位。 有关详细信息，请参阅 关于自定义访问群体。

注意

可以使用必应广告 API 删除但不能添加自定义受众。 话虽如此，可以添加和删除自定义受众关联和排除项。

概览：

  • 使用数据。 自定义访问群体允许你使用已有的受众数据。
  • 创建更丰富的受众。 使用更多客户数据创建更丰富的受众细分。
  • 工作方式类似于再营销。 自定义受众可以作为目标和出价、仅出价或排除来关联到市场活动和广告组。

若要开始使用自定义受众，DMP 必须：

  • 将自定义受众 API 集成到其平台中。
  • 同意我们的数据共享和隐私策略。

根据提供商的不同，他们将在其软件中有自己的启用步骤。 有关如何启用此功能的详细信息，请务必联系 DMP。

集成完成后，自定义访问群体将显示在Microsoft广告 Web 应用程序中共享库的“受众”部分。 还可以通过批量和市场活动管理 API 下载自定义受众，如下所述。

客户列表

客户列表是你为启用客户匹配而编译的一组客户联系信息。

注意

客户列表可通过 批量 API 获取，但尚未通过 市场活动管理 API 提供。

重要

必须先创建一个客户列表受众，并接受Microsoft广告 UI 中的条款和条件，然后才能通过批量 API 上传客户列表数据。 初始客户列表不需要包含任何客户数据，但必须选择“我接受”。

选择“我接受”即表示你 (1) 同意你能够合法披露受众详细信息（即个人数据），以Microsoft和 (2) 接受客户匹配条款、Microsoft广告协议和Microsoft广告政策。 Microsoft将根据 客户匹配条款使用上传的数据。

每个列表可以包含多个Email项。

可以在 同一批量 上传文件中添加或更新没有任何 客户列表项 记录的客户列表记录;但是，如果没有随附 的父客户列表 记录，则无法上传任何 客户列表 项记录。

48 小时后，检查“受众大小”字段，例如“受众搜索大小”，查看我们在必应网络上匹配的客户数量。 此时，你的广告可以开始为这一新受众显示。

In-Market 访问群体

市场内受众是在特定类别中显示购买意向信号的客户特选列表，包括必应搜索和点击以及Microsoft服务的页面视图。 Microsoft广告提供潜在客户的特选列表，这与付费搜索中的再营销不同，广告客户在付费搜索中创建列表。 可以通过将市场受众列表关联到广告组或市场活动来定位和修改这些受众的出价，这与再营销列表的操作类似。 有关详细信息，请参阅 市场内受众：覆盖准备购买的用户。

注意

不能使用必应广告 API 添加、更新或删除市场内受众。 话虽如此，你可以添加和删除市场内受众关联和排除项。

注意

此功能在澳大利亚、加拿大、法国、德国、英国和美国可用。

产品受众

动态再营销列表根据客户在您的网站上查看、考虑或已购买的内容，将客户与特定产品配对。 可以在搜索市场和受众市场活动中使用动态再营销列表， (并非每个人都) 受众市场活动。

注意

动态再营销列表以前称为Microsoft广告中的产品受众。 你将在Microsoft广告 UI 中看到“动态再营销列表”，但为了避免中断性变更，API objet 仍被命名为“产品受众”。

有关详细信息，请参阅 动态再营销列表：产品的再营销。

再营销列表

通过付费搜索中的再营销，你可以通过针对特定受众（即以前访问过您的网站的用户）优化市场活动来提高投资回报。 创建再营销列表时，可以指定网站上的哪些用户操作将他们限定为再营销列表的一部分。

当用户执行符合条件的操作时，它们将在几分钟内添加到再营销列表。 如果再营销列表最小大小为 1,000 (最小 cookie 池) ，并且你已将再营销列表与市场活动或广告组相关联并设置了特定的出价金额，则广告传送引擎将开始向Microsoft广告网络上的这些用户提供再营销广告。 有关付费搜索中的再营销的详细信息，请参阅 接触受众 和 常见问题解答：再营销。

设置 通用事件跟踪 (UET) 后，可以使用必应广告 API 创建再营销列表，并将其与市场活动或广告组相关联。

类似的再营销Lists

如果你是试点参与者，Microsoft广告将自动为再营销列表生成类似的受众。 不能为再营销列表创建或编辑类似的受众。 话虽如此，可以添加和删除类似的再营销列表关联和排除项。 如果删除源再营销列表，也会删除类似的受众。 如果类似的受众与市场活动或广告组相关联，则无法删除源再营销列表。

注意

必须至少有一个与至少 1,000 名用户有活动关联的再营销列表，Microsoft广告才能生成类似的受众。

类似的受众需要在搜索网络或Microsoft受众网络上至少有 300 个用户，然后才能将其与活动市场活动或广告组相关联。

类似的受众最多需要 24 小时才能生成，目标受众在该时间点之前不会生效。

受众批量 API

使用批量服务，可以使用以下记录类型来下载和上传访问群体：

注意

对于自定义访问群体，仅支持更新“名称”和“说明”。 可以使用必应广告 API 删除但不能添加自定义受众。 话虽如此，可以添加和删除自定义受众关联和排除项。

不能使用必应广告 API 添加、更新或删除市场内受众。 话虽如此，你可以添加和删除市场内受众关联和排除项。

如果你是试点参与者，Microsoft广告将自动为再营销列表生成类似的受众。 不能为再营销列表创建或编辑类似的受众。 话虽如此，可以添加和删除类似的再营销列表关联和排除项。 如果删除源再营销列表，也会删除类似的受众。 如果类似的受众与市场活动或广告组相关联，则无法删除源再营销列表。

使用批量服务，可以使用以下记录类型来下载和上传受众关联：

注意

受众目标不能同时设置市场活动级别和广告组级别。 如果设置了任何可出价市场活动级别受众标准，则不能设置任何可出价广告组受众级别访问群体条件。 受众排除可以在市场活动级别和广告组级别设置。 Microsoft广告应用市场活动与广告组级别排除项的联合。

默认情况下，市场活动和广告组中的广告可以向所有人显示，但出价调整将应用于受众中包含的人员。 如果只希望向受众中包含的人员展示广告，则需要设置“目标并出价”目标设置。 可以使用市场活动或广告组记录中的“目标设置”字段来确定适用于所有受众 (的目标设置，即与市场活动或广告组关联的再营销列表、自定义受众、市场内受众、产品受众、再营销列表以及再营销列表) 的类似受众。 每个受众都可以与多个市场活动和广告组相关联，并且每个目标设置都单独应用于投放。

受众市场活动管理 API

CombinedList、CustomAudience、InMarketAudience、ProductAudience、RemarketingList 和 SimilarRemarketingList 对象都派生自 Audience 基类。 如果使用市场活动管理服务，可以使用相应的 AddAudiences、GetAudiencesByIds、UpdateAudiences 和 DeleteAudiences 操作添加、获取、更新或删除受众。

注意

对于自定义访问群体，仅支持更新“名称”和“说明”。 可以使用必应广告 API 删除但不能添加自定义受众。 话虽如此，可以添加和删除自定义受众关联和排除项。

不能使用必应广告 API 添加、更新或删除市场内受众。 话虽如此，你可以添加和删除市场内受众关联和排除项。

若要添加、获取、更新或删除受众与市场活动之间的关联，请使用 BiddableCampaignCriterion 对象以及相应的 AddCampaignCriterions、 GetCampaignCriterionsByIds、 UpdateCampaignCriterions 和 DeleteCampaignCriterions 操作。 可以使用相同的操作使用 NegativeCampaignCriterion 对象来设置访问群体排除。

若要添加、获取、更新或删除受众和广告组之间的关联，请使用 BiddableAdGroupCriterion 对象以及相应的 AddAdGroupCriterions、 GetAdGroupCriterionsByIds、 UpdateAdGroupCriterions 和 DeleteAdGroupCriterions 操作。 可以使用具有相同操作的 NegativeAdGroupCriterion 对象来设置访问群体排除。

注意

受众目标不能同时设置市场活动级别和广告组级别。 如果设置了任何可出价市场活动级别受众标准，则不能设置任何可出价广告组受众级别访问群体条件。 受众排除可以在市场活动级别和广告组级别设置。 Microsoft广告应用市场活动与广告组级别排除项的联合。

默认情况下，市场活动和广告组中的广告可以向所有人显示，但出价调整将应用于受众中包含的人员。 如果只希望向受众中包含的人员展示广告，则需要设置“目标并出价”目标设置。 可以使用市场活动或 AdGroup 对象的 Settings 元素来确定适用于所有受众 (的目标设置，即组合列表、自定义受众、市场内受众、产品受众、再营销列表，以及与市场活动或广告组关联的再营销列表) 的类似受众。 每个受众都可以与多个市场活动和广告组相关联，并且每个目标设置都单独应用于投放。

共享访问群体和 UET 标记

启用客户 层次结构 和共享 UET 标记和受众功能后，可以与其他客户共享 UET 标记和再营销列表。

共享 UET 标记和访问群体只能通过市场活动管理 API 进行管理。 虽然可以使用批量 API 添加、获取、更新和删除访问群体，但不能使用批量 API 管理客户层次结构中共享访问群体的任何方面。

下面是一些依赖于 UET 标记的受众关联规则。

  • 只能共享 UET 标记和再营销列表，但产品受众也可以使用共享的 UET 标记。 依赖于 UET 的转换目标也可以使用共享 UET 标记。 客户列表可以共享，但你不必将它们与 UET 标记相关联。
  • UET 标记只能在客户级别共享，也称为经理帐户级别。 不能与任何特定广告客户帐户共享 UET 标记。
  • 可以将范围从帐户更新为客户，但在设置客户级别范围后，不能将受众范围限制为单个帐户。 例如，在Microsoft广告 Web 应用程序中，如果选择“与选定的经理帐户和广告客户帐户共享”，则“仅由广告帐户 Foo (栏) 使用”选项将不再可用。
  • 你可以与层次结构的子集共享 UET 标记和访问群体。 例如，假设你有一个从上到下从经理帐户 L1 到经理帐户 L2 到经理帐户 L3 的层次结构。 可以选择仅使用经理帐户 L1 共享由经理帐户 L1 拥有的 UET 标记和受众，并且无需与中间经理帐户 L2 共享。 稍后，如果将经理帐户 L4 添加到经理帐户 L3 下的层次结构中，则不会自动共享 UET 标记和受众。 如果这是你的目标，则需要与经理帐户 L4 显式共享 UET 标记和受众。
  • 受众只能由已共享关联的 UET 标记的同一组帐户共享。 例如，如果访问群体使用仅由经理帐户 L1、经理帐户 L2 和经理帐户 L3 共享的 UET 标记，则不能与经理帐户 L4 或它包含的任何广告客户帐户共享访问群体。
  • 只有拥有受众的客户中的超级管理员用户可以将其删除。
  • 拥有访问群体或 UET 标记的客户中的超级管理员用户可以更新访问群体或 UET 标记的客户帐户共享范围。 层次结构父客户中的超级管理员用户也可以更新范围。 例如，如果再营销列表由经理帐户 L2 拥有，则经理帐户 L1 和经理帐户 L2 上的任何超级管理员用户都可以更新范围。
  • (范围) （如说明和名称）以外的其他访问群体或 UET 标记属性只能由拥有受众或 UET 标记的客户中的超级管理员用户更新。 层次结构父客户中的超级管理员用户无法更新这些详细信息。 例如，如果再营销列表由经理帐户 L2 拥有，则只有经理帐户 L2 上的超级管理员用户可以更新名称和说明。
  • 当访问群体或 UET 标记未在层次结构中共享时，拥有访问群体或 UET 标记的客户中的Standard用户可以更新受众或 UET 标记属性 (范围) ，例如说明和名称。 共享访问群体或 UET 标记时，Standard用户无法更新这些属性。

客户共享示例

让我们看一下通过 GetUetTagsByIds 和 GetAudiencesByIds 检索 UET 标记和再营销列表时返回 的几个示例 SOAP 对象。 让我们基于帐户层次结构指南中的层次结构示例进行 构建 。

例如，假设在经理帐户 L1 下设置了代理层次结构， (客户 ID 111) 同时包含客户和广告客户帐户客户链接：

  • 在设置层次结构之前，已预配了四个单独的经理帐户。 经理帐户 L1 包含广告帐户 1A 和广告帐户 1B。 经理帐户 L2 包含广告帐户 2A 和广告帐户 2B。 经理帐户 L3 包含 Ad 帐户 3A 和 Ad 帐户 3B。 经理帐户 L4 包含 Ad 帐户 4A 和 Ad 帐户 4B。
  • 经理帐户 L1 (客户 ID 111) 链接到经理帐户 L2 (客户 ID 222) 以及管理链接。
  • 经理帐户 L2 (客户 ID 222) 链接到经理帐户 L3 (具有Standard链接的客户 ID 333) 。
  • 经理帐户 L3 (客户 ID 333) 链接到 Ad 帐户 4A (帐户 ID 444111) 帐户级别链接。 Ad 帐户 4A (帐户 ID 444111) 直接位于经理帐户 L4 (客户 ID 444) 下，该 ID 本身未包含在客户级别层次结构中。 在此示例中，可以通过经理帐户 L3 (客户 ID 333 444111) 访问 Ad Account 4A (帐户 ID) 即，调用需要客户标识符的服务操作时，必须使用经理帐户 L3 (客户 ID 333) 来访问帐户444111。

请注意，如果未为客户启用共享 UET 标记和访问群体，或者无法共享访问群体类型（例如 SimilarRemarketingList），则获取 UET 标记或访问群体时， CustomerShare 对象将为零。

<CustomerShare i:nil="true"/>

在此示例方案中，为共享 UET 标记和访问群体启用层次结构中的所有客户。 假设经理帐户 L1 (客户 ID 111) 刚刚创建了一个 UET 标记和一个再营销列表， (该列表依赖于同一 UET 标记) ，并且尚未与层次结构中的任何客户共享它们。 检索 UetTag 和 RemarketingList 对象时，只会在 CustomerShare 对象中设置 OwnerCustomerId，即创建 UET 标记或再营销列表的客户。

<CustomerShare>
    <CustomerAccountShares/>
    <OwnerCustomerId>111</OwnerCustomerId>
</CustomerShare>

接下来，假设经理帐户 L1 (客户 ID 111) 仅与经理帐户 L2 共享 UET 标记 (客户 ID 222) 经理帐户 L3 (客户 ID 333) 。 再营销列表使用共享的 UET 标记，但本身尚未共享。

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v13">d79e5bc6-2b90-440b-9fd0-4b2b39d6f79e</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetUetTagsByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
         <UetTags xmlns:i="http://www.w3.org/2001/XMLSchema-instance">            
            <UetTag>
               <CustomerShare>
                    <CustomerAccountShares>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations/>
                            <CustomerId>333</CustomerId>
                        </CustomerAccountShare>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations/>
                            <CustomerId>222</CustomerId>
                        </CustomerAccountShare>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations>
                                <CustomerAccountShareAssociation>
                                    <AssociationCount>1</AssociationCount>
                                    <UsageType>UETTagAssociateToRemarketingList</UsageType>
                                </CustomerAccountShareAssociation>
                            </Associations>
                            <CustomerId>111</CustomerId>
                        </CustomerAccountShare>
                    </CustomerAccountShares>
                    <OwnerCustomerId>111</OwnerCustomerId>
                </CustomerShare>
               <!--Removed some elements for brevity-->
            </UetTag>
         </UetTags>
         <PartialErrors xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </GetUetTagsByIdsResponse>
   </s:Body>
</s:Envelope>

最后，假设经理帐户 L1 (客户 ID 111) 将再营销列表与经理帐户 L3 (客户 ID 333) 和广告帐户 2A (帐户 ID 222111) 共享。 如上述方案介绍中所述，Ad 帐户 2A (帐户 ID 222111) 直接位于经理帐户 L2 (客户 ID 222) 下。 在此示例中，我们还假设再营销列表与 Ad Account 2A 下的一个广告组相关联， (帐户 ID 222111) 。

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v13">d0751178-2049-4afa-8171-435c55effdf3</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetAudiencesByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
         <Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">            
            <Audience i:type="RemarketingList">
               <!--Removed some elements for brevity-->
               <CustomerShare>
                  <CustomerAccountShares>
                     <CustomerAccountShare>
                        <AccountId>222111</AccountId>
                        <Associations/>
                        <CustomerId i:nil="true"/>
                     </CustomerAccountShare>
                     <CustomerAccountShare>
                        <AccountId i:nil="true"/>
                        <Associations>
                           <CustomerAccountShareAssociation>
                              <AssociationCount>1</AssociationCount>
                              <UsageType>RemarketingListAssociateToAdGroup</UsageType>
                           </CustomerAccountShareAssociation>
                        </Associations>
                        <CustomerId>333</CustomerId>
                     </CustomerAccountShare>
                     <CustomerAccountShare>
                        <AccountId i:nil="true"/>
                        <Associations/>
                        <CustomerId>111</CustomerId>
                     </CustomerAccountShare>
                  </CustomerAccountShares>
                  <OwnerCustomerId>111</OwnerCustomerId>
               </CustomerShare>
               <!--Removed some elements for brevity-->
            </Audience>
         </Audiences>
         <PartialErrors xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </GetAudiencesByIdsResponse>
   </s:Body>
</s:Envelope>

另请参阅

必应广告 API Web 服务地址
常见问题解答：通用事件跟踪
常见问题解答：再营销