Objeto de datos SearchQueryPerformanceReportRequest: informes

Artículo
12/21/2023

Define una solicitud de informe de rendimiento de consultas de búsqueda. Usa este informe para ver lo que busca tu audiencia cuando se muestran tus anuncios. Puede usar esta información para realizar adiciones informadas, eliminaciones o modificaciones en las listas de palabras clave y palabras clave negativas.

Puedes solicitar impresiones, clics, tasa de clics y posición media de los términos de búsqueda que han desencadenado tus anuncios. Por ejemplo, si usted es un prestamista hipotecario que está ejecutando una campaña con las siguientes palabras clave: hipoteca, hipoteca de vivienda y préstamos de capital de la vivienda; y el informe muestra que la consulta de búsqueda "tasas hipotecarias" da como resultado muchas impresiones del anuncio, probablemente agregaría "tasas" a la lista de palabras clave. Sin embargo, si no proporciona hipotecas inversas y el informe muestra que la consulta de búsqueda "hipoteca inversa" da como resultado muchas impresiones, probablemente agregaría "hipoteca inversa" a la lista de palabras clave negativas.

El informe incluirá solo términos de búsqueda que dieron lugar a un número significativo de clics en los últimos 30 días.

Dado que estos datos pueden cambiar con el tiempo, use KeywordPerformanceReportRequest para obtener las métricas de rendimiento de las palabras clave.

Para solicitar un informe de este tipo, pase este objeto a la operación SubmitGenerateReport .

Sintaxis

<xs:complexType name="SearchQueryPerformanceReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Aggregation" type="tns:ReportAggregation" />
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfSearchQueryPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:SearchQueryPerformanceReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAdGroupReportScope" />
        <xs:element name="Time" nillable="true" type="tns:ReportTime" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto SearchQueryPerformanceReportRequest tiene los siguientes elementos: Aggregation, Columns, Filter, Scope, Time.

Elemento	Descripción	Tipo de datos
Agregación	Tipo de agregación que se va a usar para agregar los datos del informe. Por ejemplo, puede agregar los datos del informe por día o semana, o solicitar un informe de resumen. La agregación predeterminada es Resumen. Es importante tener en cuenta que si no incluye TimePeriod en la lista de columnas, la agregación que eligió se omitirá y la agregación de resumen se usará independientemente.	ReportAggregation
Columnas	Lista de atributos y estadísticas de rendimiento que se incluirán en el informe. El informe incluirá las columnas en el orden en que las especifique.	Matriz SearchQueryPerformanceReportColumn
Filtro	Información de filtro que se va a usar para filtrar los datos del informe.	SearchQueryPerformanceReportFilter
Ámbito	Ámbito de entidad del informe. Use este elemento para limitar los datos del informe a cuentas, grupos de anuncios o campañas específicos.	AccountThroughAdGroupReportScope
Hora	Período de tiempo que se va a usar para el informe. Puede especificar un intervalo de fechas personalizado o seleccionar un intervalo de fechas predefinido, por ejemplo, Today o ThisWeek. Para obtener una lista de los períodos de tiempo que puede especificar para cada tipo de agregación, consulte Agregación y tiempo. Puede establecer la zona horaria dentro del objeto ReportTime , lo que le ayuda a limitar con precisión los datos del período de tiempo solicitado. Si no elige una zona horaria, el servicio de informes usa PacificTimeUSCanadaTijuana de forma predeterminada.	ReportTime

El objeto SearchQueryPerformanceReportRequest tiene elementos heredados.

Elementos heredados

Elementos heredados de ReportRequest

El objeto SearchQueryPerformanceReportRequest deriva del objeto ReportRequest y hereda los siguientes elementos: ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData. Las descripciones siguientes son específicas de SearchQueryPerformanceReportRequest y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto ReportRequest .

Elemento	Descripción	Tipo de datos
ExcludeColumnHeaders	Determina si el informe descargado debe contener descripciones de encabezado para cada columna. El encabezado de columna del informe coincide con el nombre de columna solicitado, por ejemplo , Impresiones y Clics. Establezca esta propiedad en true si desea que los encabezados de columna de informe se excluyan del informe descargado. El valor predeterminado es False.	boolean
ExcludeReportFooter	Determina si el informe descargado debe contener o no metadatos de pie de página, como los derechos de autor de Microsoft (@2020 Microsoft Corporation. Todos los derechos reservados). Establezca esta propiedad en true si desea que los metadatos del pie de página del informe se excluyan del informe descargado. El valor predeterminado es False.	boolean
ExcludeReportHeader	Determina si el informe descargado debe contener o no metadatos de encabezado, como el nombre del informe, el intervalo de fechas y la agregación. Establezca esta propiedad en true si desea que los metadatos del encabezado del informe se excluyan del informe descargado. El valor predeterminado es False.	boolean
Formato	Formato de los datos del informe. Por ejemplo, puede solicitar los datos en formato de valores separados por comas (Csv) o en formato de valores separados por tabulaciones (Tsv). El valor predeterminado es Csv. Todos los archivos descargados están comprimidos con ZIP.	ReportFormat
FormatVersion	Determina el formato de determinados campos del archivo de informe descargado. El formato de datos de determinados campos se puede actualizar dentro de la versión actual de la API sin interrumpir las aplicaciones cliente existentes. Para obtener el formato de datos más reciente, establezca este campo de solicitud opcional en 2.0. Si no establece este campo, el servicio tiene como valor predeterminado la versión 1.0. Para obtener más información sobre los cambios entre las versiones de formato, consulte Versión de formato de informe.	string
ReportName	Nombre del informe. El nombre se incluye en el encabezado del informe. Si no especifica un nombre de informe, el sistema genera un nombre en el formulario ReportType-ReportDateTime. La longitud máxima del nombre del informe es 200.	string
ReturnOnlyCompleteData	Determina si el servicio debe asegurarse de que todos los datos se han procesado y están disponibles. Si se establece en true y si el sistema no ha terminado de procesar todos los datos en función de la agregación , ámbito y hora solicitadas, el servicio devuelve el código de error NoCompleteDataAvaliable (2004). De lo contrario, la solicitud puede realizarse correctamente de forma predeterminada, no hay ninguna indicación de si los datos están completos y el informe solo contendrá los datos que el sistema haya terminado de procesar en el momento de la solicitud. Tenga en cuenta que, dado que hoy en día todavía está en curso y los datos no están completos, no puede establecer este elemento en true si el período de tiempo (ya sea una fecha personalizada o predefinida) incluye la fecha de hoy. Para obtener más información, vea Zonas horarias en Informes.	boolean

Requisitos

Servicio: ReportingService.svc v13
Nombres: https://bingads.microsoft.com/Reporting/v13

Compartir a través de