BiddableAdGroupCriterion Data Object - Campaign Management

Artículo
11/13/2024

Define un criterio biddable que quieres aplicar al grupo de anuncios especificado.

Sintaxis

XML
JSON

<xs:complexType name="BiddableAdGroupCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdGroupCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdGroupCriterionEditorialStatus" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q82="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q82:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q83="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q83:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
        <xs:element minOccurs="0" name="CriterionCashback" nillable="true" type="tns:CriterionCashback">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AdGroupId": "LongValueHere",
  "Criterion": {
    "Type": "AgeCriterion",
    "AgeRange": "ValueHere"
  },
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "Type": "BiddableAdGroupCriterion",
  "CriterionBid": {
    "Type": "BidMultiplier",
    "Multiplier": DoubleValueHere
  },
  "CriterionCashback": {
    "Type": "CashbackAdjustment",
    "CashbackPercent": DoubleValueHere
  },
  "DestinationUrl": "ValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  }
}

Elementos

El objeto BiddableAdGroupCriterion tiene los siguientes elementos: CriterionBid, CriterionCashback, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descripción	Tipo de datos
CriterionBid	La oferta que se va a usar en la subasta. Si el criterio heredado es un criterio de página web , debe usar un FixedBid. Si el criterio heredado es productpartition, debe usar un FixedBid a menos que bidOption de productos patrocinados esté establecido en BidBoost (para obtener más información, consulte ProductPartition Usage below). Para todos los demás criterios de grupo de anuncios que se pueden pujar, use bidMultiplier. Si no usa el tipo de objeto correcto, se omitirá la oferta solicitada: Si se requiere la oferta, se producirá un error en la operación; Si la oferta es opcional, se usará la oferta predeterminada. Agregar: Los requisitos varían en función del tipo de criterio heredado. La oferta es opcional y se establecerá en el valor predeterminado de 0 si no se incluye para los criterios AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion, RadiusCriterion, AudienceCriterion y Webpage . La puja no es aplicable a LocationIntentCriterion (el servicio no devolverá ningún error y la puja se omitirá incluso si la incluye). Al agregar una productpartition con la operación ApplyProductPartitionActions , la puja es necesaria a menos que el tipo de partición del producto sea Subdivision, en cuyo caso no se permite la puja. Actualizar: Los requisitos varían en función del tipo de criterio heredado. La oferta es necesaria para AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion y RadiusCriterion. La puja no es aplicable a LocationIntentCriterion (el servicio no devolverá ningún error y la puja se omitirá incluso si la incluye). Para los criterios AudienceCriterion y Webpage , la oferta es opcional y, si no se establece ningún valor para la actualización, esta configuración no cambia. Al actualizar un ProductPartition con la operación ApplyProductPartitionActions , la puja es opcional y, si no se establece ningún valor para la actualización, esta configuración no cambia.	CriterionBid
CriterionCashback	Define el objeto de datos CriterionCashback.	CriterionCashback
DestinationUrl	Dirección URL de la página web a la que se lleva al usuario al hacer clic en el anuncio. Este elemento solo se usa si el criterio heredado es un criterio ProductPartition . Para obtener más información, vea ProductPartition Usage (Uso de ProductPartition ) a continuación.	string
EditorialStatus	Para uso futuro.	AdGroupCriterionEditorialStatus
FinalAppUrls	Para uso futuro.	Matriz AppUrl
FinalMobileUrls	Para uso futuro.	matriz de cadenas
FinalUrls	Para uso futuro.	matriz de cadenas
FinalUrlSuffix	El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas. Este elemento solo se usa si el criterio heredado es un criterio ProductPartition o Webpage . Para obtener más información, consulte Uso de ProductPartition y Uso de páginas web a continuación.	string
TrackingUrlTemplate	Las plantillas de seguimiento son donde puede especificar parámetros de seguimiento de direcciones URL que se usan junto con la dirección URL final o la página de aterrizaje. Se recomienda agregar la plantilla de seguimiento en el nivel de cuenta y, a continuación, se aplicará a todas las direcciones URL de entidades de nivel inferior, como campañas, grupos de anuncios y anuncios. Para más información, consulte los artículos de ayuda de Microsoft Advertising Seguimiento de direcciones URL con direcciones URL actualizadas. Este elemento solo se usa si el criterio heredado es un criterio ProductPartition o Webpage . Para obtener más información, consulte Uso de ProductPartition y Uso de páginas web a continuación.	string
UrlCustomParameters	Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL. Este elemento solo se usa si el criterio heredado es un criterio ProductPartition o Webpage . Para obtener más información, consulte Uso de ProductPartition y Uso de páginas web a continuación.	CustomParameters

El objeto BiddableAdGroupCriterion tiene elementos heredados.

Elementos heredados

Elementos heredados de AdGroupCriterion

El objeto BiddableAdGroupCriterion deriva del objeto AdGroupCriterion y hereda los siguientes elementos: AdGroupId, Criterion, Id, Status, Type. Las descripciones siguientes son específicas de BiddableAdGroupCriterion y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto AdGroupCriterion .

Elemento	Descripción	Tipo de datos
AdGroupId	Identificador del grupo de anuncios al que se va a aplicar el criterio. Agregar: Obligatorio Actualizar: Obligatorio	largo
Criterio	Criterio que se va a aplicar al grupo de anuncios. El criterio ayuda a determinar si se ofrecen anuncios en el grupo de anuncios. Para obtener una lista de los tipos de criterio disponibles, consulte AdGroupCriterionType. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Criterio
Identificación	Identificador único de Microsoft Advertising para el criterio del grupo de anuncios. Agregar: Solo lectura Actualizar: Obligatorio	largo
Estado	Valor de estado que determina si el criterio se aplica al grupo de anuncios. Para la mayoría de los criterios de grupo de anuncios que se pueden pujar, el único valor de estado admitido es Activo. Para conocer las excepciones, consulte Uso de páginas web a continuación. Agregar: Solo lectura Actualizar: Solo lectura	AdGroupCriterionStatus
Tipo	Tipo del criterio del grupo de anuncios. Este valor es BiddableAdGroupCriterion cuando se recupera un criterio de grupo de anuncios pujable. Para obtener más información sobre los tipos de criterio de grupo de anuncios, consulte comentarios sobre los objetos de datos AdGroupCriterion. Agregar: Solo lectura Actualizar: Solo lectura	string

Comentarios

Uso de ProductPartition

Si el criterio heredado es un criterio ProductPartition , tenga en cuenta el siguiente uso de las propiedades BiddableAdGroupCriterion .

CriterionBid

De forma predeterminada, la subasta usará un FixedBid para los grupos de productos. Debe usar fixedBid a menos que bidOption de productos patrocinados esté establecido en BidBoost. Si la opción BidOption de productos patrocinados se establece en BidBoost, el bidMultiplier representa el porcentaje (mayor que cero) que se usa para amplificar la oferta de su asociado.

Por ejemplo, supongamos que su asociado puja 5 USD en su grupo de productos (FixedBid a través de CriterionBid). Si el ajuste de la oferta (BidMultiplier a través de CriterionBid) se establece en 20 (porcentaje) y el Valor BidMaxValue del grupo de anuncios es de 0,50 (50 céntimos), el porcentaje sería de 50 céntimos y no de 1 USD.

DestinationUrl

Si actualmente usa direcciones URL de destino, finalmente debe reemplazarlas por Plantillas de seguimiento. Para obtener más información, consulte Seguimiento de direcciones URL con direcciones URL actualizadas.

La dirección URL puede contener parámetros dinámicos como {MatchType}. Para obtener una lista de los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?.

La dirección URL puede contener un máximo de 1024 caracteres. Si la dirección URL no especifica un protocolo, el sistema usa el protocolo HTTP cuando un usuario hace clic en el anuncio. Si la dirección URL especifica el protocolo HTTP al agregar un anuncio, el servicio quitará la cadena de protocolo http:// (la cadena de protocolo HTTP no cuenta con el límite de 1024 caracteres); sin embargo, el servicio no quitará una cadena de protocolo HTTPS (https://) de la dirección URL.

La dirección URL de destino se usa si se especifica; De lo contrario, la dirección URL de destino viene determinada por el valor correspondiente del "Vínculo" que especificó para la oferta de producto en el catálogo de Microsoft Merchant Center.

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.

FinalUrlSuffix

El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas.

TrackingUrlTemplate

Las plantillas de seguimiento se pueden usar junto con la dirección URL especificada en el campo "Link" para la oferta de producto que envió a través de Content API. Al combinar la dirección URL de la fuente con la plantilla de seguimiento, la dirección URL de la página de aterrizaje se ensambla donde se dirige a un usuario después de hacer clic en el anuncio. Cuando se usa el elemento TrackingUrlTemplate para actualizar los parámetros de dirección URL en lugar de actualizarlos en la dirección URL de la fuente, la dirección URL de la fuente no tiene que pasar por la revisión editorial y los anuncios seguirán funcionando sin interrupciones. Por ejemplo, si la dirección URL de la oferta de producto en la fuente de catálogo es https://contoso.com/, podría especificar la siguiente plantilla de seguimiento: {lpurl}?matchtype={matchtype}&device={device}.

Las siguientes reglas de validación se aplican a las plantillas de seguimiento. Para obtener más información sobre las plantillas y los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?

Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad.
La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.
La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}.
Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma.

UrlCustomParameters

Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL.

Microsoft Advertising aceptará los 8 primeros objetos CustomParameter que incluya en el objeto CustomParameters y, si incluye más de 8 parámetros personalizados, se devolverá un error. Cada CustomParameter incluye elementos Key y Value .

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Establezca el elemento UrlCustomParameters en null o vacío para conservar los parámetros personalizados existentes. Para quitar todos los parámetros personalizados, establezca el elemento Parameters del objeto CustomParameters en null o vacío. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar en el elemento Parameters del objeto CustomParameters .

Uso de páginas web

Si el criterio heredado es un criterio de página web , tenga en cuenta el siguiente uso de las propiedades BiddableAdGroupCriterion .

FinalUrlSuffix

Estado

Valor de estado que determina si el criterio se aplica al grupo de anuncios.

Puede establecer el estado en Activo o En pausa. No se puede establecer el estado en Eliminado.

Agregar: Opcional.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.

TrackingUrlTemplate

Para el criterio de página web , las plantillas de seguimiento se pueden usar junto con la dirección URL de la página de aterrizaje que se genera dinámicamente desde el dominio que especificó para la campaña de Anuncios de búsqueda dinámica. Al combinar el dominio con la plantilla de seguimiento, se ensambla la dirección URL de la página de aterrizaje donde se dirige a un usuario después de hacer clic en el anuncio. Esta es una plantilla de seguimiento de ejemplo: {lpurl}?matchtype={matchtype}&device={device}.

Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad.
La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.
La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}.
Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma.

UrlCustomParameters

Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL.

Requisitos

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

Compartir a través de

BiddableAdGroupCriterion Data Object - Campaign Management

Sintaxis

Elementos

Elementos heredados

Elementos heredados de AdGroupCriterion

Comentarios

Uso de ProductPartition

CriterionBid

DestinationUrl

FinalUrlSuffix

TrackingUrlTemplate

UrlCustomParameters

Uso de páginas web

FinalUrlSuffix

Estado

TrackingUrlTemplate

UrlCustomParameters

Requisitos

Comentarios

Recursos adicionales