Llama al método Conversion.insert()
para agregar una o más conversiones. Para atribuir correctamente la conversión, tu solicitud debe especificar el nombre de una actividad de Floodlight que el anunciante utiliza para informar las conversiones sin conexión, junto con el ID de la palabra clave, el anuncio y, posiblemente, el clic que generó la conversión. Para obtener información sobre cómo obtener los IDs de Search Ads 360, consulta IDs y conversiones de Search Ads 360.
En el Centro de ayuda de Search Ads 360, puedes encontrar información sobre las restricciones para subir conversiones históricas.
Si tu solicitud de Conversion.insert()
especifica varias conversiones, Search Ads 360 intenta subir cada conversión según el criterio del mejor esfuerzo en lugar de subir todo el lote como una transacción de todo o nada. Si algunas conversiones de un lote no se suben, es posible que otras se suban correctamente. Las cargas de conversiones pueden fallar debido a una solicitud no válida o a fallas transitorias del sistema o de la red. Por lo tanto, te recomendamos que leas la respuesta de cada conversión insertada para asegurarte de que la carga se realice correctamente.
¿En cuánto tiempo están disponibles los datos subidos?
Si especificas un
conversionTimestamp
de hoy o ayer para una conversión, las métricas de la conversión aparecerán en la IU de Search Ads 360 en un plazo de una hora a partir de la carga. Si especificas un conversionTimestamp
anterior a ayer, las métricas se actualizarán en varias horas.
Convierte todas las marcas de tiempo de las conversiones a hora de época (también conocida como hora de Unix).
¿Puedo crear actividades de Floodlight desde la API?
Si el anunciante aún no creó una actividad de Floodlight para hacer un seguimiento de las conversiones sin conexión, puedes usar la API de Campaign Manager para crear una. No puedes usar la API para especificar que una actividad de Floodlight se utiliza principalmente para las conversiones sin conexión, lo cual es una práctica recomendada cuando las estrategias de ofertas usarán datos de la conversión.
Te recomendamos que después de usar la API para crear una actividad de Floodlight, un usuario de Search Ads 360 acceda a la plataforma y cambie la configuración de la actividad para indicar que la fuente principal de conversiones es la actividad sin conexión.
Prácticas recomendadas para agregar conversiones
Te recomendamos que sigas las siguientes prácticas recomendadas para agregar conversiones:
Pídele a un usuario de Search Ads 360 que acceda a la plataforma y cambie la configuración de cada actividad de Floodlight que utilices para registrar las conversiones sin conexión. La configuración debe indicar que la fuente principal de conversiones es la actividad sin conexión. Consulta el Centro de ayuda de Search Ads 360 para obtener instrucciones.
Sube las conversiones en cuanto estén disponibles. Si attribues conversiones a visitas específicas, espera al menos 6 horas después de la visita antes de subir la conversión. Es posible que Search Ads 360 no reconozca el clickID de la visita si lo subes antes de 6 horas después de la visita. En casos excepcionales, es posible que debas esperar hasta 24 horas para que Search Ads 360 reconozca el clickId.
Asegúrate de que cada carga contenga las conversiones más recientes. Dentro de una sola solicitud de carga, está bien si las entradas no están en orden cronológico. Sin embargo, es posible que una estrategia de ofertas no pueda considerar las conversiones anteriores que subas más adelante en una solicitud diferente.
Cómo enviar una solicitud de inserción
Puedes enviar una solicitud Conversion.insert()
para realizar cualquiera de las siguientes acciones:
- Cómo atribuir una conversión a una visita específica
- Cómo atribuir una conversión solo a una palabra clave
Los campos que son obligatorios en una solicitud Conversion.insert()
dependen del
evento o elemento al que atribuyes la conversión. En las siguientes secciones, se indican los campos obligatorios y opcionales para cada evento o elemento al que puedes atribuir una conversión.
Cómo atribuir una conversión a una visita específica
Cuando un cliente hace clic en uno o más anuncios y llega al sitio de un anunciante, Search Ads 360 considera que la sesión del usuario en el sitio del anunciante es una visita.
Para atribuir una conversión a una visita, especifica lo siguiente en tu solicitud Conversion.insert()
:
Campos obligatorios
clickId
: El ID de clic de la visita que distingue mayúsculas de minúsculas. Busca el ID de clic en los registros web del anunciante o en las conversiones de lista y usa un ID de clic de otra conversión. Search Ads 360 atribuirá la conversión a la palabra clave, el anuncio y otros objetos de Search Ads 360 que fueron responsables de generar la visita.
Espera al menos 6 horas después de que Search Ads 360 genere un ID de clic para subir las conversiones. Si recibes un error que indica que no se encontró el ID de clic, espera 24 horas y, luego, vuelve a subir las conversiones. Todas las conversiones deben subirse dentro de los 90 días posteriores a la generación del ID de clic. De lo contrario, es posible que la API de Search Ads 360 no reconozca la visita.conversionId
: En el caso de las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que consideren pertinente. Cada conversión en una solicitud debe especificar un ID único, y la combinación de ID y marca de tiempo debe ser única entre todas las conversiones del anunciante. En el caso de las conversiones en línea, Search Ads 360 copiadsConversionId
ofloodlightOrderId
en esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp
: Indica la fecha y la hora en las que se generó la conversión. Por ejemplo, si la conversión ocurre el viernes 5 de agosto de 2016 a las 11:53:22 a.m. (hora de verano del este [GMT -4:00]), especifica la marca de tiempo en milisegundos de época:1470412402000
.segmentationType
: Especifica el tipo de sistema de conversiones al que subes la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que este campo siempre es obligatorio para especificarFLOODLIGHT
.segmentationName
: Es el nombre de la actividad de Floodlight que el anunciante usa para informar la conversión.Si tu anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenecen a diferentes grupos de Floodlight), la acción recomendada es cambiar el nombre de una de las actividades.
Como alternativa, si conoces el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificarlo en
segmentationId
en lugar de especificar el nombre en el camposegmentationName
. (Campaign Manager también asigna un ID a la actividad de Floodlight, pero el ID de Campaign Manager es diferente del ID de Search Ads 360 y no se puede usar para atribuir conversiones). Para ver el ID de Search Ads 360 de una actividad de Floodlight, descarga un informe de conversiones (desde la IU de Search Ads 360 o la API de informes). Si se atribuyó al menos una conversión a la actividad de Floodlight durante el período del informe, verás el ID de Search Ads 360 en el informe.type
: Es el tipo de conversión, es decir,ACTION
oTRANSACTION
. Una conversión de ACTION no tiene valor monetario, mientras que una conversión de TRANSACTION sí lo tiene. Algunos ejemplos son los registros en listas de correo electrónico (ACTION) en comparación con las compras de comercio electrónico (TRANSACTION).Si especificas
TRANSACTION
, también debes especificar el siguiente campo:revenueMicros
: Es el valor monetario de la conversión.
Campos opcionales
quantityMillis
: Es la cantidad de elementos de esta conversión. Por ejemplo, la cantidad de personas que se registraron para recibir un boletín informativo por correo electrónico o la cantidad total de artículos vendidos. Si no especificas este campo para las conversiones de ACTION, Search Ads 360 inserta automáticamente un valor de1000
.currencyCode
: Es la moneda de los ingresos de una transacción. De forma predeterminada, se supone que los ingresos están en la moneda del anunciante. Si especificas una moneda diferente, Search Ads 360 convierte el importe de ingresos especificado a la moneda del anunciante. Más información
Usa el formato alfabético ISO 4217 (3 caracteres) para especificar la moneda.
Solo se aplica a las conversiones de TRANSACCIÓN.customMetric
ycustomDimension
: Suben datos adicionales sobre una conversión, como el país al que se envía un artículo comprado, los IDs de producto o incluso la duración de una llamada telefónica. Obtén más información para subir datos de las variables personalizadas de Floodlight.deviceType
: Especifica el tipo de dispositivo en el que se generó la conversión. Consulta la lista de valores aceptados para este campo.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue "currencyCode": "USD" }] }
Java
/** * Instantiate the Doubleclicksearch service, create conversions, and upload them. */ public static void main(String[] args) throws Exception { Doubleclicksearch service = getService(); // See Set Up Your Application. // Set up a List to keep track of each conversion you create. List<Conversion> conversions = new Vector<Conversion>(); // Add a conversion to the List. addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L); // Upload the List and handle the response. uploadConversions(conversions, service); } /** * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes * the segmentation name and currency. You probably wouldn't want your production code to be so brittle. */ private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions, String clickId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion().setClickId(clickId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; } /** * Convert the List of conversions to a DS ConversionList, send an insert request to DS, * and output the response to a file. */ private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service) throws IOException { FileOutputStream outputStream = new FileOutputStream(new File("./", "InsertConversionsResponse.txt")); final PrintStream printStream = new PrintStream(outputStream); try { // Convert the List to a ConversionList. ConversionList conversionList = new ConversionList().setConversion(conversions); // Insert an upload request and download the response to a file. service.conversion().insert(conversionList).executeAndDownloadTo(printStream); printStream.close(); } catch (GoogleJsonResponseException e) { System.err.println("Get request was rejected."); for (ErrorInfo error : e.getDetails().getErrors()) { System.err.println(error.getMessage()); } System.exit(e.getStatusCode()); } }
Python
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a visit. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site 'conversionId': 'test_20140206_00', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
Cómo atribuir una conversión solo a una palabra clave
Si tu principal preocupación es atribuir conversiones a palabras clave y no te preocupa atribuirlas a los anuncios, puedes omitir la mayoría de los identificadores de Search Ads 360 y solo especificar el identificador de la palabra clave junto con algunos otros campos:
Campos obligatorios
criterionId
: Es el identificador de palabras clave. Para obtener elcriterionId
, agrega la macroTrackerId
a las URLs de tu página de destino. Si deseas obtener información para obtener los IDs de palabra clave, consulta IDs y conversiones de Search Ads 360.conversionId
: En el caso de las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que consideren pertinente. Cada conversión en una solicitud debe especificar un ID único, y la combinación de ID y marca de tiempo debe ser única entre todas las conversiones del anunciante. En el caso de las conversiones en línea, Search Ads 360 copiadsConversionId
ofloodlightOrderId
en esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp
: Indica la fecha y la hora en las que se generó la conversión. Por ejemplo, si la conversión ocurre el viernes 5 de agosto de 2016 a las 11:53:22 a.m. (hora de verano del este [GMT -4:00]), especifica la marca de tiempo en milisegundos de época:1470412402000
.segmentationType
: Especifica el tipo de sistema de conversiones al que subes la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que este campo siempre es obligatorio para especificarFLOODLIGHT
.segmentationName
: Es el nombre de la actividad de Floodlight que el anunciante usa para informar la conversión.Si tu anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenecen a diferentes grupos de Floodlight), la acción recomendada es cambiar el nombre de una de las actividades.
Como alternativa, si conoces el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificarlo en
segmentationId
en lugar de especificar el nombre en el camposegmentationName
. (Campaign Manager también asigna un ID a la actividad de Floodlight, pero el ID de Campaign Manager es diferente del ID de Search Ads 360 y no se puede usar para atribuir conversiones). Para ver el ID de Search Ads 360 de una actividad de Floodlight, descarga un informe de conversiones (desde la IU de Search Ads 360 o la API de informes). Si se atribuyó al menos una conversión a la actividad de Floodlight durante el período del informe, verás el ID de Search Ads 360 en el informe.type
: Es el tipo de conversión, es decir,ACTION
oTRANSACTION
. Una conversión de ACTION no tiene valor monetario, mientras que una conversión de TRANSACTION sí lo tiene. Algunos ejemplos son los registros en listas de correo electrónico (ACTION) en comparación con las compras de comercio electrónico (TRANSACTION).Si especificas
TRANSACTION
, también debes especificar el siguiente campo:revenueMicros
: Es el valor monetario de la conversión.
Campos opcionales
quantityMillis
: Es la cantidad de elementos de esta conversión. Por ejemplo, la cantidad de personas que se registraron para recibir un boletín informativo por correo electrónico o la cantidad total de artículos vendidos. Si no especificas este campo para las conversiones de ACTION, Search Ads 360 inserta automáticamente un valor de1000
.currencyCode
: Es la moneda de los ingresos de una transacción. De forma predeterminada, se supone que los ingresos están en la moneda del anunciante. Si especificas una moneda diferente, Search Ads 360 convierte el importe de ingresos especificado a la moneda del anunciante. Más información
Usa el formato alfabético ISO 4217 (3 caracteres) para especificar la moneda.
Solo se aplica a las conversiones de TRANSACCIÓN.customMetric
ycustomDimension
: Suben datos adicionales sobre una conversión, como el país al que se envía un artículo comprado, los IDs de producto o incluso la duración de una llamada telefónica. Obtén más información para subir datos de las variables personalizadas de Floodlight.deviceType
: Especifica el tipo de dispositivo en el que se generó la conversión. Consulta la lista de valores aceptados para este campo.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "criterionId": "43700003491981017", // Replace with your ID "conversionId": "customerTransaction73126", "conversionTimestamp": "1351196386000", "segmentationType": "FLOODLIGHT", "segmentationName": "Offline Purchase", "type": "TRANSACTION", "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue "currencyCode": "USD" }] }
Java
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Python
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a keyword only. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'criterionId': '43700004289911004', // Replace with your ID 'conversionId': 'test_1378710000000', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
Sube datos de un modelo de atribución de terceros
Un modelo de atribución distribuye el crédito de una conversión entre toda la actividad en una ruta de conversión. Por ejemplo, si un consumidor hace clic en un anuncio de búsqueda pagada, un anuncio gráfico y otro anuncio de búsqueda pagada antes de generar una conversión, un modelo de atribución lineal le otorgaría a cada clic el 33% del crédito de conversión.
Si bien Search Ads 360 proporciona modelos de atribución, si usas un servicio de terceros o uno que desarrollaste para distribuir el crédito a los clics, puedes subir los datos de atribución de terceros a Search Ads 360 y usarlos en los informes y las estrategias de ofertas de Search Ads 360.
Antes de comenzar
En Campaign Manager, crea un modelo de atribución personalizado y, luego, impórtalo a Search Ads 360. Asegúrate de asignarle el nombre Modelo de atribución externa. Esto permite que las funciones de Search Ads 360 reconozcan que se aplicó un modelo de atribución a los datos de conversiones que subes. Más información
Campos obligatorios
Para aplicar un modelo de atribución de terceros a una conversión, especifica lo siguiente en tu solicitud Conversion.insert()
:
clickId
: El ID de clic de la visita que distingue mayúsculas de minúsculas. Busca el ID de clic en los registros web del anunciante o en las conversiones de lista y usa un ID de clic de otra conversión. Search Ads 360 atribuirá la conversión a la palabra clave, el anuncio y otros objetos de Search Ads 360 que fueron responsables de generar la visita.
Espera al menos 30 minutos después de que Search Ads 360 genere un ID de clic antes de subir una conversión con el ID. De lo contrario, es posible que la API de Search Ads 360 no reconozca la visita.attributionModel
: Establece la opción Modelo de atribución externo. Más informacióncountMillis
: Es la cantidad de crédito de conversión que se distribuirá a este clic. Solo se aplica si la solicitud también incluye el campoattributionModel
.No lo confundas con
quantityMillis
, un campo opcional que especifica la cantidad de elementos de una conversión (como la cantidad de artículos en una compra del carrito de compras).conversionId
: En el caso de las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que consideren pertinente. Cada conversión en una solicitud debe especificar un ID único, y la combinación de ID y marca de tiempo debe ser única entre todas las conversiones del anunciante. En el caso de las conversiones en línea, Search Ads 360 copiadsConversionId
ofloodlightOrderId
en esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp
: Indica la fecha y la hora en las que se generó la conversión. Por ejemplo, si la conversión ocurre el viernes 5 de agosto de 2016 a las 11:53:22 a.m. (hora de verano del este [GMT -4:00]), especifica la marca de tiempo en milisegundos de época:1470412402000
.segmentationType
: Especifica el tipo de sistema de conversiones al que subes la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que este campo siempre es obligatorio para especificarFLOODLIGHT
.segmentationName
: Es el nombre de la actividad de Floodlight que el anunciante usa para informar la conversión.Si tu anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenecen a diferentes grupos de Floodlight), la acción recomendada es cambiar el nombre de una de las actividades.
Como alternativa, si conoces el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificarlo en
segmentationId
en lugar de especificar el nombre en el camposegmentationName
. (Campaign Manager también asigna un ID a la actividad de Floodlight, pero el ID de Campaign Manager es diferente del ID de Search Ads 360 y no se puede usar para atribuir conversiones). Para ver el ID de Search Ads 360 de una actividad de Floodlight, descarga un informe de conversiones (desde la IU de Search Ads 360 o la API de informes). Si se atribuyó al menos una conversión a la actividad de Floodlight durante el período del informe, verás el ID de Search Ads 360 en el informe.type
: Es el tipo de conversión, es decir,ACTION
oTRANSACTION
. Una conversión de ACTION no tiene valor monetario, mientras que una conversión de TRANSACTION sí lo tiene. Algunos ejemplos son los registros en listas de correo electrónico (ACTION) en comparación con las compras de comercio electrónico (TRANSACTION).Si especificas
TRANSACTION
, también debes especificar el siguiente campo:revenueMicros
: Es el valor monetario de la conversión.
Si realizas un seguimiento de los ingresos por conversiones, asegúrate de que tu modelo distribuya los ingresos entre cada punto de contacto de una ruta de conversión. Por ejemplo, si tu modelo usa un enfoque lineal (distribuye los ingresos de manera equitativa entre cada punto de contacto), en una ruta de conversión que incluye 3 clics en el anuncio, cada clic se atribuirá con el 33% de la conversión. Si la conversión obtuvo USD 100 en ingresos, asegúrate de que tu modelo distribuya USD 33 de ingresos a cada clic y de que revenueMicros especifique solo USD 33 de ingresos por cada clic.
Campos opcionales
quantityMillis
: Es la cantidad de elementos de esta conversión. Por ejemplo, la cantidad de personas que se registraron para recibir un boletín informativo por correo electrónico o la cantidad total de artículos vendidos. Si no especificas este campo para las conversiones de ACTION, Search Ads 360 inserta automáticamente un valor de1000
.currencyCode
: Es la moneda de los ingresos de una transacción. De forma predeterminada, se supone que los ingresos están en la moneda del anunciante. Si especificas una moneda diferente, Search Ads 360 convierte el importe de ingresos especificado a la moneda del anunciante. Más información
Usa el formato alfabético ISO 4217 (3 caracteres) para especificar la moneda.
Solo se aplica a las conversiones de TRANSACCIÓN.customMetric
ycustomDimension
: Suben datos adicionales sobre una conversión, como el país al que se envía un artículo comprado, los IDs de producto o incluso la duración de una llamada telefónica. Obtén más información para subir datos de las variables personalizadas de Floodlight.deviceType
: Especifica el tipo de dispositivo en el que se generó la conversión. Consulta la lista de valores aceptados para este campo.
Ejemplo
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "attributionModel": "External Attribution Model", "countMillis": "330", "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue "currencyCode": "USD" }] }
Controla las respuestas de Search Ads 360
La respuesta de Search Ads 360 indica que se realizó correctamente solo si todas las conversiones de la solicitud se validaron y subieron correctamente.
Si la solicitud se realiza correctamente
Si la solicitud se realiza correctamente, la respuesta incluirá la representación interna completa de Search Ads 360 para cada conversión subida, como el ID de la campaña, el ID del grupo de anuncios y el ID de la palabra clave (criterio).
{ "kind": "doubleclicksearch#conversionList", "conversion": [ { "agencyId": "12300000000000456", "advertiserId": "45600000000010291", "engineAccountId": "700000000042441", "campaignId": "71700000002044839", "adGroupId": "58700000032026064", "criterionId": "43700004289911004", "adId": "0", "dsConversionId": "48719131694768384", "conversionId": "test_1383157331951", "state": "ACTIVE", "type": "TRANSACTION", "revenueMicros": "20000000", "currencyCode": "USD", "segmentationType": "FLOODLIGHT", "segmentationId": "25700000001464141", "segmentationName": "Test", "conversionTimestamp": "1378710000000", "conversionModifiedTimestamp": "1383157332368" }, ... ] }
Si la solicitud no se realiza correctamente
Si una o más conversiones no se validan o no se suben, la respuesta incluirá mensajes para cada carga de conversión que no se haya realizado correctamente. La respuesta no contiene mensajes sobre las conversiones que se subieron correctamente.
Este es un ejemplo de respuesta a una solicitud que no se realiza correctamente:
{ "error": { "errors": [ { "reason": "requestValidation", "message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..." }, { "reason": "requestValidation", "message": "The request was not valid. Details: [0x00000101: Click ID ..." } ] } }
Cada mensaje de error contiene dos campos importantes: un motivo y un mensaje de error detallado. El campo de motivo puede contener requestValidation, internalError, transactionFailed o lateStageRequestError.
Errores de requestValidation
Los errores de requestValidation indican problemas de datos en la solicitud de carga de conversiones (p.ej., la conversión ya se subió o no se encuentra el clickId). En este tipo de error, los detalles del mensaje contienen dos elementos:
- Es un código hexadecimal que identifica el tipo de error. Puedes usar el código en tus propias secuencias de comandos para identificar los errores.
- Una descripción del error de validación.
Para obtener más información, consulta la lista de códigos y descripciones que Search Ads 360 puede mostrar para los errores de carga de conversiones.
Otros tipos de errores
Todos los demás tipos de errores (internalError, transactionFailed o lateStageRequestError) indican que hay un problema interno en Search Ads 360.
Cómo responder a un error
Si la solicitud falla, intenta volver a enviar toda la llamada de solicitud más tarde. Search Ads 360 informará errores de requestValidation para las conversiones que ya se subieron, pero intentará subir las conversiones restantes.
Si sigues viendo errores después de volver a enviar el contenido, consulta la sección de solución de problemas para obtener información sobre cómo proceder.