Con la unificación de los informes y las consultas, ya no necesitas definir un informe. Puedes consultar recursos de forma directa mediante un SearchGoogleAdsStreamRequest o un SearchGoogleAdsRequest.
Para comenzar la planificación de migración de informes, consulta las tablas de asignación de campos adecuadas. Estas tablas muestran el nombre del campo de la API de AdWords y su equivalente en la API de Google Ads.
Ejemplo
Los informes de rendimiento de los grupos de anuncios y de campaña son dos de los más utilizados en la API de AdWords. Proporcionamos para comparar las consultas equivalentes en el Lenguaje de consultas de AdWords (AWQL) y el Lenguaje de consultas de Google Ads (GAQL):
| Informe de rendimiento de grupos de anuncios |
|---|
# AWQL
SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost
FROM ADGROUP_PERFORMANCE_REPORT
DURING LAST_7_DAYS
# Google Ads Query Language
SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks,
metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
|
| Informe de rendimiento de campañas |
# AWQL
SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks,
Ctr, AverageCpc, Cost
FROM CAMPAIGN_PERFORMANCE_REPORT
DURING LAST_30_DAYS
# Google Ads Query Language
SELECT campaign.name, campaign.status, segments.device, metrics.impressions,
metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
|
Informes de atribución únicos y múltiples
Durante la migración, es posible que ciertos informes específicos de la API de AdWords requieran una consideración especial, como el Informe de rendimiento de palabras clave o el Informe de rendimiento por rango de edad. Existen dos tipos de informes:
Informes de atribución única, como el Informe de rendimiento de criterios o el Informe de rendimiento de palabras clave, en los que solo se registra uno de los criterios de activación (como la posición, la edad, las palabras clave, etc.) en una impresión determinada: Una impresión puede activarse mediante varios criterios, pero en un informe de atribución único, la impresión y todas sus estadísticas se atribuyen a un solo criterio.
Informes de atribución múltiple, como el Informe de rendimiento por género o el Informe de rendimiento por posición, en los que hasta un criterio de cada dimensión que activó la impresión tiene registrada la impresión: Se puede considerar que varios informes de atribución son informes específicos del tipo de criterio. A diferencia de la atribución única, en la que una fila puede contener diferentes tipos de criterios, cada informe de atribución múltiple contiene criterios para solo un tipo de criterio.
En la API de Google Ads, no hay informes de atribución únicos. Todos los informes a nivel de la API de Google Ads son multiatribución en el sentido de que cada informe es específico de un grupo de tipos de criterios y resume las estadísticas según los criterios de ese tipo. No agregues estadísticas juntas de diferentes recursos criteria_view, ya que eso haría que se registraran dos veces y los totales incorrectos.
Encabezado HTTP de includeZeroImpressions
API de AdWords
En la API de AdWords, puedes usar el
encabezado includeZeroImpressions
para controlar si las filas del informe en las que todos los campos de métricas especificados en la consulta tienen cero valores
Establece el encabezado en true; el resultado del informe incluye esas filas; para false, no es así.
Aunque el nombre del encabezado menciona "Impressions" una fila del informe debe tener cero en todos los campos de métricas especificados en la solicitud (no solo impresiones) para que se los excluya cuando el encabezado se establece en false.
API de Google Ads
No existe ese encabezado en la API de Google Ads, por lo que no puedes asignar las consultas a la API de AdWords directamente con aquellas en la API de Google Ads.
Como aproximación, puedes especificar el predicado metrics.impressions > 0 en tu consulta para excluir las filas de informes cuyas impresiones sean cero. En la mayoría de los casos, esto produce resultados equivalentes como configurar el encabezado includeZeroImpressions de la API de AdWords en false, ya que cuando las impresiones no son cero, otros valores de métricas también suelen ser cero.
Sin embargo, ten en cuenta que, en los casos en que metrics.impressions sea cero, pero otros valores de métricas (como el metrics.search_impression_share basado en predicciones) no lo sean, es posible que se muestre una fila de informe.