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 use para registrar las conversiones sin conexión, junto con el ID de clic de la visita o los IDs de la palabra clave que generó la conversión. Para
obtener información sobre cómo obtener IDs de Search Ads 360, consulta IDs y
conversiones de Search Ads 360.
Puedes encontrar información sobre las restricciones para subir conversiones históricas en el Centro de ayuda de Search Ads 360.
Si tu solicitud Conversion.insert() especifica varias conversiones, Search Ads 360 intenta subir cada conversión de la mejor manera posible, 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 sí se suban correctamente. Las cargas de conversiones pueden fallar
debido a una solicitud no válida o a fallas transitorias de la red o del sistema. Por lo tanto, te recomendamos que leas la respuesta de cada conversión insertada para asegurarte de que la carga se haya realizado 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 al día de ayer, las métricas se actualizarán en
varias horas.
Convierte todas las marcas de tiempo de las conversiones al tiempo Unix (también conocido como tiempo de ciclo).
¿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 use principalmente para las conversiones sin conexión, lo que es una práctica recomendada cuando las estrategias de ofertas utilizan 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 Search Ads 360 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 estas prácticas recomendadas para agregar conversiones:
Pídele a un usuario de Search Ads 360 que acceda a Search Ads 360 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 atribuyes 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 ID de clic de la visita si lo subes antes de que transcurran 6 horas desde la visita. En raras ocasiones, es posible que debas esperar hasta 24 horas antes de que Search Ads 360 pueda reconocer el ID de clic.
Asegúrate de que cada carga contenga las conversiones más recientes. En una sola solicitud de carga, no hay problema si las entradas no están en orden cronológico. Sin embargo, es posible que una estrategia de ofertas no pueda considerar las conversiones más antiguas que subas más adelante en una solicitud diferente.
Envía 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 obligatorios en una solicitud de Conversion.insert() dependen del evento o elemento al que atribuyas la conversión. En las siguientes secciones, se enumeran los campos obligatorios y opcionales para cada evento o artículo 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: Es 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 recupera elconversion.click_idde otra conversión con la API de Search Ads 360 Reporting de la nueva experiencia de Search Ads 360. Search Ads 360 atribuirá la conversión a la palabra clave, el anuncio y otros objetos de Search Ads 360 que generaron 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 se deben subir en un plazo de 90 días a partir de la fecha en que se genera el 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 de 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 copia eldsConversionIdo elfloodlightOrderIden esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp: Indica la fecha y la hora en que se generó la conversión. Por ejemplo, si la conversión se produce 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 conversión al que subirás la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que siempre se requiere este campo 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, puedes especificar el ID de la actividad de Floodlight en el campo
segmentationIden lugar de especificar el nombre en el camposegmentationName. Usa el ID que Campaign Manager asignó a la actividad de Floodlight. Puedes recuperar este ID con el campoconversion_action.floodlight_settings.activity_idde la API de informes de la nueva experiencia de Search Ads 360 . También se acepta elsegmentationIdque Search Ads 360 devuelve en la respuesta a una solicitud de conversión.type: Es el tipo de conversión, es decir,ACTIONoTRANSACTION. Una conversión de ACCIÓN no tiene valor monetario, mientras que una conversión de TRANSACCIÓN sí lo tiene. Por ejemplo, los registros en listas de correo electrónico (ACCIÓN) en comparación con las compras de comercio electrónico (TRANSACCIÓN).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 ACCIÓN, 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.customMetricycustomDimension: Sube 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 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 no tienes un ID de clic, puedes atribuir una conversión directamente a una palabra clave. En la nueva experiencia de Search Ads 360, los IDs de palabras clave son únicos solo dentro de un grupo de anuncios, por lo que debes especificar el conjunto completo de IDs de la nueva experiencia de Search Ads 360 que identifica la palabra clave, junto con algunos otros campos:
Campos obligatorios
customerId: Es el ID de cliente de la cuenta de cliente que contiene la palabra clave, por ejemplo,123-456-7890.campaignId: Es el ID de la campaña que contiene la palabra clave.adGroupId: Es el ID del grupo de anuncios que contiene la palabra clave.criterionId: Es el ID de la palabra clave.Si una conversión especifica
criterionIdsincustomerId,campaignIdoadGroupId, falla con el código de error0x0000012E. Para obtener información sobre cómo obtener estos IDs, 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 de 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 copia eldsConversionIdo elfloodlightOrderIden esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp: Indica la fecha y la hora en que se generó la conversión. Por ejemplo, si la conversión se produce 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 conversión al que subirás la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que siempre se requiere este campo 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, puedes especificar el ID de la actividad de Floodlight en el campo
segmentationIden lugar de especificar el nombre en el camposegmentationName. Usa el ID que Campaign Manager asignó a la actividad de Floodlight. Puedes recuperar este ID con el campoconversion_action.floodlight_settings.activity_idde la API de informes de la nueva experiencia de Search Ads 360 . También se acepta elsegmentationIdque Search Ads 360 devuelve en la respuesta a una solicitud de conversión.type: Es el tipo de conversión, es decir,ACTIONoTRANSACTION. Una conversión de ACCIÓN no tiene valor monetario, mientras que una conversión de TRANSACCIÓN sí lo tiene. Por ejemplo, los registros en listas de correo electrónico (ACCIÓN) en comparación con las compras de comercio electrónico (TRANSACCIÓN).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 ACCIÓN, 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.customMetricycustomDimension: Sube 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 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" : [{ "customerId": "123-456-7890", // Replace with your ID "campaignId": "14660344555", // Replace with your ID "adGroupId": "105138634255", // Replace with your ID "criterionId": "948710340465", // 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, String customerId, Long campaignId, Long adGroupId, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCustomerId(customerId) .setCampaignId(campaignId) .setAdGroupId(adGroupId) .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': [{ 'customerId': '123-456-7890', // Replace with your ID 'campaignId': '14660344555', // Replace with your ID 'adGroupId': '105138634255', // Replace with your ID 'criterionId': '948710340465', // 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 los distintos eventos de 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 realizar una conversión, un modelo de atribución lineal asignaría a cada clic el 33% del crédito de conversión.
Si bien Search Ads 360 proporciona modelos de atribución, si utilizas un servicio de terceros o un servicio desarrollado por ti para distribuir el crédito a los clics, puedes subir los datos de atribución de terceros a Search Ads 360 y utilizarlos 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 asignar el nombre External Attribution Model al modelo de atribución. 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 todo lo siguiente en
tu solicitud Conversion.insert():
clickId: Es 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 recupera elconversion.click_idde otra conversión con la API de Search Ads 360 Reporting de la nueva experiencia de Search Ads 360. Search Ads 360 atribuirá la conversión a la palabra clave, el anuncio y otros objetos de Search Ads 360 que generaron 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: Configúralo como 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 confundas este parámetro con
quantityMillis, un campo opcional que especifica la cantidad de artículos de una conversión (como la cantidad de artículos de una compra en un 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 de 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 copia eldsConversionIdo elfloodlightOrderIden esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp: Indica la fecha y la hora en que se generó la conversión. Por ejemplo, si la conversión se produce 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 conversión al que subirás la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que siempre se requiere este campo 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, puedes especificar el ID de la actividad de Floodlight en el campo
segmentationIden lugar de especificar el nombre en el camposegmentationName. Usa el ID que Campaign Manager asignó a la actividad de Floodlight. Puedes recuperar este ID con el campoconversion_action.floodlight_settings.activity_idde la API de informes de la nueva experiencia de Search Ads 360 . También se acepta elsegmentationIdque Search Ads 360 devuelve en la respuesta a una solicitud de conversión.type: Es el tipo de conversión, es decir,ACTIONoTRANSACTION. Una conversión de ACCIÓN no tiene valor monetario, mientras que una conversión de TRANSACCIÓN sí lo tiene. Por ejemplo, los registros en listas de correo electrónico (ACCIÓN) en comparación con las compras de comercio electrónico (TRANSACCIÓN).Si especificas
TRANSACTION, también debes especificar el siguiente campo:revenueMicros: Es el valor monetario de la conversión.
Si haces un seguimiento de los ingresos por conversiones, asegúrate de que tu modelo distribuya los ingresos entre todos los puntos de contacto de la ruta de conversión. Por ejemplo, si tu modelo utiliza un enfoque lineal (es decir, que distribuye los ingresos de manera equitativa entre todos los puntos de contacto), en una ruta de conversión que incluye 3 clics en el anuncio, a cada clic se le atribuirá el 33% de la conversión. Si la conversión generó USD 100 en ingresos, asegúrate de que tu modelo asigne USD 33 de ingresos a cada clic y procura 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 ACCIÓN, 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.customMetricycustomDimension: Sube 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 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" }] }
Cómo controlar las respuestas de Search Ads 360
La respuesta de Search Ads 360 indica que la operación se realizó correctamente solo si todas las conversiones de la solicitud se validaron y subieron de forma correcta.
Si la solicitud se realiza correctamente,
Si la solicitud se completa correctamente, la respuesta incluirá la representación interna completa de Search Ads 360 para cada conversión subida. La representación usa IDs de la nueva experiencia de Search Ads 360: el ID de cliente de la cuenta de cliente, el ID de campaña, el ID de grupo de anuncios, el ID de palabra clave (criterio) y el ID de anuncio al que se atribuye la conversión.
Este es un ejemplo de respuesta para una conversión que se atribuye a una visita:
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"customerId": "123-456-7890",
"campaignId": "14660344555",
"adGroupId": "105138634255",
"criterionId": "948710340465",
"adId": "562719339005",
"clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
"conversionId": "test_20130906_04",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "10000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368",
"floodlightOrderId": "test_20130906_04",
"countMillis": "1000",
"deviceType": "DESKTOP"
},
...
]
}
La respuesta incluye solo los IDs que se aplican a la conversión. Por ejemplo, la respuesta para una conversión que se atribuye solo a una palabra clave no incluye clickId ni adId.
Si la solicitud no se completa correctamente,
Si una o más conversiones no se validan o no se suben, la respuesta incluye mensajes para cada carga de conversión fallida. La respuesta no contiene mensajes sobre las conversiones que se subieron correctamente.
Este es un ejemplo de respuesta a una solicitud que no se completa 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.
- Es 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 devolver 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 feed, consulta la sección de solución de problemas para obtener información sobre cómo proceder.