ConversionGoal Data Object - Campaign Management

Artículo
12/21/2023

Define el objeto base de un objetivo de conversión.

No intente crear una instancia de ConversionGoal. Puede crear uno o varios de los siguientes objetos que se derivan de él.

Sintaxis

<xs:complexType name="ConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AttributionModelType" nillable="true" type="tns:AttributionModelType">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ConversionWindowInMinutes" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="CountType" nillable="true" type="tns:ConversionGoalCountType" />
    <xs:element minOccurs="0" name="ExcludeFromBidding" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="GoalCategory" nillable="true" type="tns:ConversionGoalCategory">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsEnhancedConversionsEnabled" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Revenue" nillable="true" type="tns:ConversionGoalRevenue" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ConversionGoalStatus" />
    <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:ConversionGoalTrackingStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalType" />
    <xs:element minOccurs="0" name="ViewThroughConversionWindowInMinutes" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elementos

El objeto ConversionGoal tiene los siguientes elementos: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes.

Elemento	Descripción	Tipo de datos
AttributionModelType	Determina qué modelo de atribución, LastTouch o LastClick, se usa con un objetivo de conversión. Este elemento no se devuelve de forma predeterminada. Para obtener este elemento, incluya el valor AttributionModelType en el elemento ReturnAdditionalFields cuando llame a las operaciones de servicio GetConversionGoalsByIds y GetConversionGoalsByTagIds . Este elemento no es aplicable a AppInstallGoal, InStoreTransactionGoal y OfflineConversionGoal.	AttributionModelType
ConversiónWindowInMinutes	La ventana de conversión es el período de tiempo en minutos después de un clic en el que desea realizar un seguimiento de las conversiones. Si establece este valor en 43200 minutos (30 días), se realiza el seguimiento de las conversiones que se producen dentro de los 30 días posteriores a un clic. Las conversiones anteriores no se ven afectadas. El valor mínimo admitido es de 1 minuto, aunque tenga en cuenta que una ventana de conversión más corta reducirá el número de conversiones que registra su cuenta. El valor máximo admitido es 129600 minutos (90 días).	int
CountType	Esto determina cómo se registran las conversiones en la ventana de conversión elegida. Hay dos opciones y, si no establece un valor, el valor predeterminado es All: - Todo: se contarán todas las conversiones que se producen después de un clic en un anuncio. Esta es una opción común para las ventas. - Único: solo se contará una conversión que se produzca después de hacer clic en un anuncio. Esta es una opción común para los clientes potenciales. Por ejemplo: realiza un seguimiento de dos conversiones: clientes potenciales y ventas. Seleccione Único para clientes potenciales y Todo para ventas. Cuando un clic en un anuncio se convierte en dos clientes potenciales y dos ventas, se cuenta como tres conversiones: una para el cliente potencial único y dos para todas las ventas. Este elemento no es aplicable a AppInstallGoal.	ConversionGoalCountType
ExcludeFromBidding	Determina si se excluyen o no los datos relacionados con este objetivo de conversión de un subconjunto de columnas de informe de rendimiento. Este elemento solo está disponible para los clientes que están habilitados para la característica Incluir en conversiones (GetCustomerPilotFeatures devuelve 574). Si este elemento se establece en true, los datos relacionados con este objetivo de conversión se excluirán de las `Conversions`columnas de informe , `ConversionRate`, `CostPerConversion`, `ReturnOnAdSpend`, `RevenuePerConversion`y `Revenue` . Además, si usa una estrategia de puja automatizada, establecer esta propiedad true dará lugar a que las conversiones del objetivo ya no se factoricen en cálculos de puja automatizados. Establecer esta propiedad "true" es efectivamente lo mismo que desactivar "Incluir en conversiones" en la aplicación web de Microsoft Advertising. Independientemente de este valor de elemento, las `AllConversions`columnas de informe , `AllConversionRate`, `AllCostPerConversion`, `AllReturnOnAdSpend`, `AllRevenuePerConversion`y `AllRevenue` incluirán datos para todos los objetivos de conversión. De forma predeterminada, este elemento es false y los datos relacionados con este objetivo de conversión se incluyen en todas las columnas de informe. Para obtener más información, vea Atributos de informe y estadísticas de rendimiento y el artículo de ayuda Objetivos de conversión: "Conversiones" frente a "Todas las conversiones".	boolean
GoalCategory	Categoría usada para segmentar el objetivo de conversión. Sin embargo, clasificar los objetivos de conversión tiene sentido para su empresa. Las categorías de objetivos no afectan al rendimiento: están aquí para ayudarle a segmentar sus objetivos y sus métricas de rendimiento. Los valores de categoría admitidos varían según el tipo de objetivo de conversión, por lo que consulte la página de referencia correspondiente para conocer los requisitos detallados.	ConversionGoalCategory
Id	Identificador único de Microsoft Advertising para el objetivo de conversión.	Largo
IsEnhancedConversionsEnabled	Determina si las conversiones mejoradas están habilitadas para un objetivo de conversión. Nota: Para crear un objetivo de conversión mejorado y establecer `isEnhancedConversionsEnabled=true`, debe crear un objetivo de conversión para la cuenta a través de la interfaz de usuario de Microsoft Advertising con la configuración de conversión mejorada seleccionada y la casilla asociada activada.	boolean
Nombre	Nombre del objetivo de conversión. La longitud máxima del nombre es 100 y el nombre debe ser único entre todos los objetivos de conversión que pertenecen al mismo cliente.	string
Ingresos	Determina cuánto vale cada conversión para su empresa. Al agregar un objetivo de conversión si no especifica ninguna preferencia de seguimiento de ingresos, cada ConversionGoalRevenue se establecerá en sus respectivos valores predeterminados. Al actualizar un objetivo de conversión, si el elemento Revenue es nulo o vacío, no se actualizará ninguna de las propiedades anidadas. Sin embargo, si este elemento no está vacío o nulo, se reemplazan eficazmente las propiedades de ingresos existentes. La opción VariableValue no está disponible para AppInstallGoal, DurationGoal o PagesViewedPerVisitGoal.	ConversionGoalRevenue
Ámbito	Determina si el objetivo se aplica a todas las cuentas o solo a la cuenta especificada en el elemento de encabezado CustomerAccountId necesario. Si tiene varias cuentas de Microsoft Advertising, puede realizar un seguimiento de las conversiones en todas esas cuentas. Si asocia un objetivo a una cuenta, solo se realizará un seguimiento de las conversiones para esa cuenta. Los valores posibles son Account y Customer. Una vez que haya establecido el ámbito, no podrá cambiarlo. Si desea cambiar el ámbito, debe crear un nuevo objetivo de conversión y pausar el anterior. Solo se admite el ámbito Cliente para AppInstallGoal.	EntityScope
Estado	Define los posibles valores de estado determinados por el usuario de un objetivo de conversión. Estos son los valores de estado que un usuario puede decidir establecer, por ejemplo, un objetivo se puede establecer en Pausado si ya no desea realizar un seguimiento de las conversiones para ese objetivo. Para ver los valores de estado que puede establecer el sistema, por ejemplo, si se comprueba la etiqueta UET, consulte el elemento TrackingStatus .	ConversionGoalStatus
TagId	Identificador único de Microsoft Advertising de la etiqueta UET que agregó a su sitio web para permitir que Microsoft Advertising recopile acciones que los usuarios realizan en su sitio web. Antes de tomar una dependencia del identificador de etiqueta, tenga en cuenta que la etiqueta de UET se puede compartir con o desde otro cliente. Las etiquetas y audiencias de UET compartidas solo están disponibles para los clientes piloto. Para obtener información general sobre cómo compartir audiencias y etiquetas de UET en una jerarquía de clientes, consulte la guía técnica Compartir audiencias y etiquetas de UET . Este elemento no es aplicable a AppInstallGoal, InStoreTransactionGoal y OfflineConversionGoal.	Largo
TrackingStatus	Define los posibles valores de estado determinados por el sistema de un objetivo de conversión. Estos son los valores de estado que puede establecer el sistema, por ejemplo, el sistema establece el estado en TagUnverified si la etiqueta UET aún no se ha comprobado. Para ver los valores de estado que un usuario puede decidir establecer, por ejemplo, establecer el estado en Pausado si ya no desea realizar un seguimiento de las conversiones para ese objetivo, vea el elemento Status . Solo los estados NoRecentConversions y RecordingConversions son aplicables a AppInstallGoal y OfflineConversionGoal.	ConversionGoalTrackingStatus
Tipo	Tipo del objetivo de conversión. Para obtener más información sobre los tipos de objetivo de conversión, vea los comentarios.	ConversionGoalType
ViewThroughConversionWindowInMinutes	La ventana de conversión de vista a través es el período de tiempo en minutos después de un clic en el que desea realizar un seguimiento de las conversiones de visualización. Si establece este valor en 43200 minutos (30 días), se realiza el seguimiento de las conversiones de visualización que se producen dentro de los 30 días posteriores a un clic. Las conversiones anteriores no se ven afectadas. El valor mínimo admitido es de 1 minuto, aunque tenga en cuenta que una ventana de conversión más corta reducirá el número de conversiones que registra su cuenta. El valor máximo admitido es 43200 minutos (30 días). La propiedad de cuenta IncludeViewThroughConversions también debe establecerse en true para realizar un seguimiento de las conversiones de vista a través. Este elemento no se devuelve de forma predeterminada. Para obtener este elemento, incluya el valor ViewThroughConversionWindowInMinutes en el elemento ReturnAdditionalFields cuando llame a las operaciones de servicio GetConversionGoalsByIds y GetConversionGoalsByTagIds . Este elemento no es aplicable a AppInstallGoal, InStoreTransactionGoal y OfflineConversionGoal.	int

Observaciones

Para Java y los lenguajes .NET, no establezca el elemento Type porque el valor viene determinado por el tipo de objetivo de conversión en el que se crean instancias.

Si genera soap manualmente, use el atributo type del <ConversionGoal> nodo, como se muestra en el ejemplo siguiente, para especificar el tipo del objetivo de conversión.

<ConversionGoals i:nil="false">
  <ConversionGoal i:type="UrlGoal">
    <ConversionWindowInMinutes i:nil="false"></ConversionWindowInMinutes>
    <CountType i:nil="false">Unique</CountType>
    <Id i:nil="true" />
    <Name i:nil="false">My Url Conversion Goal</Name>
    <Revenue i:nil="false">
      <CurrencyCode i:nil="false">USDollar</CurrencyCode>
      <Type i:nil="false">FixedValue</Type>
      <Value i:nil="false">10.00</Value>
    </Revenue>
    <Scope i:nil="false">Customer</Scope>
    <Status i:nil="true" />
    <TagId i:nil="false"></TagId>
    <TrackingStatus i:nil="true" />
    <UrlExpression i:nil="false">contoso</UrlExpression>
    <UrlOperator i:nil="false">Contains</UrlOperator>
  </ConversionGoal>
</ConversionGoals>

Requisitos

Servicio: CampaignManagementService.svc v13
Nombres: https://bingads.microsoft.com/CampaignManagement/v13

Usado por

AddConversionGoals
GetConversionGoalsByIds
GetConversionGoalsByTagIds
UpdateConversionGoals

Compartir a través de