Llama a Conversion.insert().
método 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 utilice para generar informes
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
sobre cómo obtener IDs de Search Ads 360, consulta IDs de Search Ads 360 y
Conversiones
Puede 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 en función del mejor esfuerzo en lugar de
y sube todo el lote como una transacción de todo o nada. Si algunas conversiones en una
un lote no se puede subir, es posible que otros sigan subiendo el archivo correctamente. Es posible que se produzcan errores en las cargas de conversiones
debido a una solicitud no válida
o a fallas transitorias de la red o a fallas del sistema. Por lo tanto,
se recomienda que lea la respuesta de cada conversión que se inserte a
asegúrate de que la carga se realice correctamente.
¿Cuándo podré usar los datos subidos?
Si especificas un
conversionTimestamp de hoy o ayer para una conversión; métricas para la
la conversión aparecerá en la IU de Search Ads 360 en el plazo de una hora desde la carga. Si
especificar una conversionTimestamp que sea anterior a ayer, las métricas se actualizarán en
varias horas.
Convierte todas las marcas de tiempo de las conversiones al tiempo de época (también conocido como tiempo 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 usa la API de Campaign Manager para crear una. No puedes usar la API para especificar que una actividad de Floodlight se usa principalmente para las conversiones sin conexión, que es una mejor cuando las estrategias de ofertas usarán datos de la conversión.
Recomendamos que después de usar la API para crear una cuenta la actividad, un usuario de Search Ads 360 accede a ella y cambia el parámetro de configuración indicar que la fuente principal de conversiones es la actividad sin conexión.
Prácticas recomendadas para agregar conversiones
A continuación, se incluyen las 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 por cada actividad de Floodlight que uses para registrar las conversiones sin conexión. La configuración debe indican que la fuente principal de conversiones es la actividad sin conexión. Consulta la Centro de ayuda de Search Ads 360 para obtener instrucciones.
Sube las conversiones en cuanto estén disponibles. Si es atribuir conversiones a visitas específicas, esperar, al menos, 30 minutos después la visita antes de subir la conversión. Es posible que Search Ads 360 no reconozca el ID de clic de la visita en los siguientes casos: subir un video antes de los 30 minutos posteriores a la visita. En casos excepcionales, es posible que debas Espera hasta 4 horas para que Search Ads 360 reconozca el clickId.
Asegúrate de que cada carga contenga las conversiones más recientes. En un solo solicitud de carga, no hay problema si las entradas están desordenadas en orden cronológico. Pero una estrategia de ofertas No podrás considerar las conversiones anteriores que subas más tarde en una solicitud diferente.
Si esperas más de 24 horas antes de subir las conversiones de una actividad de Floodlight, envían un marca de tiempo de disponibilidad.
La marca de tiempo de disponibilidad debe ser una de las siguientes opciones:
- Si registró conversiones durante las últimas 24 horas, pero no las subió Sin embargo, la marca de tiempo debería ser la hora a la que se subió la última conversión . Esto le indica a Search Ads 360 que es posible que se hayan generado conversiones. durante las últimas 24 horas, pero aún no has proporcionado los datos. estrategias de ofertas y Otros sistemas automatizados consideran el historial de rendimiento solo hasta el último conversión que subiste.
- Si no se han producido conversiones durante las últimas 24 horas, la marca de tiempo debe ser la fecha y la hora actuales. Esto le indica a Search Ads 360 que conversiones en las últimas 24 horas. estrategias de ofertas y otras ofertas incluyen las últimas 24 horas (un día completo sin conversiones) parte del historial de rendimiento.
Envía una solicitud de inserción
Puedes enviar una solicitud Conversion.insert() para realizar cualquiera de las siguientes acciones:
- Atribuir una conversión a una visita específica
- Atribuir una conversión solo a una palabra clave
Los campos obligatorios de una solicitud Conversion.insert() dependen del
evento o elemento al que le atribuyes la conversión. En las siguientes secciones, se enumeran
y opcionales para cada evento o artículo al que puedas atribuir una conversión.
Atribuir una conversión a una visita específica
Cuando un cliente hace clic en uno o más anuncios
y llega al sitio del anunciante
Search Ads 360 considera que la sesión de usuario en el sitio del anunciante es una visita.
Para atribuir una conversión a una visita, especifica lo siguiente en tu Conversion.insert()
solicitud:
Campos obligatorios
clickId: El ID de clic de la visita que distingue mayúsculas de minúsculas. Consulta la los registros web del anunciante para el ID de clic o las conversiones de la lista y utiliza un 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 responsables de generando la visita.
Espera al menos 30 minutos. Search Ads 360 genera un ID de clic para subir conversiones. Si aparece el mensaje "No se encontró el ID de clic", haz lo siguiente: espera 4 horas y, luego, sube el archivo conversiones de nuevo. Todas las conversiones se deben subir en un plazo de 90 días a partir del momento en que se genera la se genera el ID de clic. De lo contrario, es posible que la API de Search Ads 360 no reconozca la visita.conversionId: Para las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que sea significativo para ellas. 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 copia losdsConversionIdofloodlightOrderId. en esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp: indica la fecha y hora en las que se conversión. Por ejemplo, si el conversión se produce el vie, 5 de agosto de 2016 a las 11:53:22 a.m., horario 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 que estás subiendo la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que este campo siempre se requiere especificarFLOODLIGHT.segmentationName: Es el nombre de la actividad de Floodlight en la que está el anunciante. usar para registrar la conversión.Si tu anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenezcan a grupos diferentes de Floodlight), la acción recomendada es cambiarle el nombre a una de las actividades
Como alternativa, si conoces el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificar el ID en el
segmentationIden 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 conversions.) Para ver el ID de Search Ads 360 de una actividad de Floodlight, descarga una informe de conversiones (ya sea desde el IU de Search Ads 360 o los informes API). 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 él.type: El tipo de conversión, es decir,ACTIONoTRANSACTION. Una conversión ACTION no tiene valor monetario, mientras que una TRANSACTION lo hace. Algunos ejemplos son los registros en listas de direcciones 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, el la cantidad de personas que se suscribieron a un boletín informativo por correo electrónico o la cantidad total de artículos vendidos. Si no especifica este campo para las conversiones ACTION, Search Ads 360 insertará automáticamente un valor de1000.currencyCode: Es la moneda de los ingresos de una transacción. De forma predeterminada, los ingresos son se supone que 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). format para especificar la moneda.
Solo se aplica a las conversiones de TRANSACCIÓN.customMetricycustomDimension: Sube datos adicionales sobre un conversiones, como el país al que se envía un artículo comprado, los IDs del producto o, incluso, la duración de una llamada telefónica. Obtén más información sobre para cargar datos Variables de FloodlightdeviceType: Especifica el tipo de dispositivo en el que se generó la conversión. Consulta la lista de valores aceptados para este .
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())
Atribuir una conversión solo a una palabra clave
Si su preocupación principal es atribuir conversiones a palabras clave y no le preocupa la atribución a los anuncios, puede omitir la mayoría de las secciones de Search Ads 360 y solo especifican el identificador de la palabra clave junto con algunos otros campos:
Campos obligatorios
criterionId: Este es el identificador de la palabra clave. Para obtener lacriterionId, agregaTrackerId. a las URLs de tu página de destino. Para obtener información sobre cómo obtener IDs de palabras clave, consulta los IDs de Search Ads 360 y Conversiones.conversionId: Para las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que sea significativo para ellas. 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. Para las conversiones en línea, Search Ads 360 copiadsConversionIdofloodlightOrderId. en esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp: indica la fecha y hora en las que se conversión. Por ejemplo, si el conversión se produce el vie, 5 de agosto de 2016 a las 11:53:22 a.m., horario 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 que estás subiendo la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que este campo siempre se requiere especificarFLOODLIGHT.segmentationName: Es el nombre de la actividad de Floodlight en la que está el anunciante. usar para registrar la conversión.Si tu anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenezcan a grupos diferentes de Floodlight), la acción recomendada es cambiarle el nombre a una de las actividades
Como alternativa, si conoces el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificar el ID en el
segmentationIden 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 conversions.) Para ver el ID de Search Ads 360 de una actividad de Floodlight, descarga una informe de conversiones (ya sea desde el IU de Search Ads 360 o los informes API). 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 él.type: El tipo de conversión, es decir,ACTIONoTRANSACTION. Una conversión ACTION no tiene valor monetario, mientras que una TRANSACTION lo hace. Algunos ejemplos son los registros en listas de direcciones 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, el la cantidad de personas que se suscribieron a un boletín informativo por correo electrónico o la cantidad total de artículos vendidos. Si no especifica este campo para las conversiones ACTION, Search Ads 360 insertará automáticamente un valor de1000.currencyCode: Es la moneda de los ingresos de una transacción. De forma predeterminada, los ingresos son se supone que 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). format para especificar la moneda.
Solo se aplica a las conversiones de TRANSACCIÓN.customMetricycustomDimension: Sube datos adicionales sobre un conversiones, como el país al que se envía un artículo comprado, los IDs del producto o, incluso, la duración de una llamada telefónica. Obtén más información sobre para cargar datos Variables de FloodlightdeviceType: Especifica el tipo de dispositivo en el que se generó la conversión. Consulta la lista de valores aceptados para este .
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())
Cómo subir datos desde un modelo de atribución de terceros
Un modelo de atribución distribuye el crédito de una conversión en todos los 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 asignar a cada clic el 33% del crédito de conversión.
Mientras que Search Ads 360 proporciona modelos de atribución, si usa un servicio de terceros o un servicio que para distribuir el crédito entre los clics, puedes subir los datos de atribución de terceros en Search Ads 360 y usar los datos 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 Search Ads 360. Asegúrate de asignar el nombre Modelo de atribución externa al modelo. Esto permite que las funciones de Search Ads 360 reconozcan que se aplicó un modelo de atribución al los datos de conversiones que subas. Aprendizaje más
Campos obligatorios
Para aplicar un modelo de atribución de terceros a una conversión, especifica lo siguiente en
tu solicitud de Conversion.insert():
clickId: El ID de clic de la visita que distingue mayúsculas de minúsculas. Consulta la los registros web del anunciante para el ID de clic o las conversiones de la lista y utiliza un 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 responsables de generando la visita.
Espera al menos 30 minutos. Search Ads 360 genera 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: Se establece como Modelo de atribución externo. Más informacióncountMillis: Es la cantidad de crédito de conversión que se puede atribuir a este clic. Solo se aplica si la solicitud también incluye el campoattributionModel.No confundas esto con
quantityMillis, un campo opcional que especifica Cantidad de artículos incluidos en una conversión (como la cantidad de artículos en un carrito de compras) compra).conversionId: Para las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que sea significativo para ellas. 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 copia losdsConversionIdofloodlightOrderId. en esta propiedad según las instrucciones de Floodlight del anunciante.conversionTimestamp: indica la fecha y hora en las que se conversión. Por ejemplo, si el conversión se produce el vie, 5 de agosto de 2016 a las 11:53:22 a.m., horario 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 que estás subiendo la conversión. Actualmente, solo se admiten las conversiones de Floodlight, por lo que este campo siempre se requiere especificarFLOODLIGHT.segmentationName: Es el nombre de la actividad de Floodlight en la que está el anunciante. usar para registrar la conversión.Si tu anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenezcan a grupos diferentes de Floodlight), la acción recomendada es cambiarle el nombre a una de las actividades
Como alternativa, si conoces el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificar el ID en el
segmentationIden 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 conversions.) Para ver el ID de Search Ads 360 de una actividad de Floodlight, descarga una informe de conversiones (ya sea desde el IU de Search Ads 360 o los informes API). 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 él.type: El tipo de conversión, es decir,ACTIONoTRANSACTION. Una conversión ACTION no tiene valor monetario, mientras que una TRANSACTION lo hace. Algunos ejemplos son los registros en listas de direcciones 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 realiza un seguimiento de los ingresos de conversiones, asegúrese de que su modelo distribuya los ingresos entre punto de contacto en una ruta de conversión.Por ejemplo, si tu modelo usa un enfoque lineal (distribución equitativa de los ingresos entre cada punto de contacto), en una ruta de conversión que incluya 3 clics en el anuncio, a cada clic se le atribuirá el 33% de la conversión. Si la conversión de ingresos de USD 100, asegúrese de que su modelo distribuya USD 33 de ingresos a cada clic y asegurarse 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, el la cantidad de personas que se suscribieron a un boletín informativo por correo electrónico o la cantidad total de artículos vendidos. Si no especifica este campo para las conversiones ACTION, Search Ads 360 insertará automáticamente un valor de1000.currencyCode: Es la moneda de los ingresos de una transacción. De forma predeterminada, los ingresos son que se supone que 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). format para especificar la moneda.
Solo se aplica a las conversiones de TRANSACCIÓN.customMetricycustomDimension: Sube datos adicionales sobre un conversiones, como el país al que se envía un artículo comprado, los IDs del producto o, incluso, la duración de una llamada telefónica. Obtén más información sobre para cargar datos Variables de FloodlightdeviceType: Especifica el tipo de dispositivo en el que se generó la conversión. Consulta la lista de valores aceptados para este .
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 el éxito solo si todas las conversiones de que la solicitud se haya validado y cargado correctamente.
Si la solicitud se realiza correctamente
Si la solicitud se realiza correctamente, la respuesta incluirá toda la información interna de Search Ads 360. representación de cada conversión subida, como el ID de la campaña, el ID del grupo de anuncios y 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 tiene éxito
Si no se validan o no se suben una o más conversiones, la respuesta incluirá mensajes para cada una de las conversiones con errores. La respuesta no contiene mensajes sobre las conversiones que se subió correctamente.
A continuación, se muestra un ejemplo de respuesta a una solicitud que no se realiza de forma correcta:
{
"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 error detallado. mensaje. El campo del motivo puede contener requestValidation, internalError, transactionFailed o lateStageRequestError.
Errores de requestValidation
Los errores de requestValidation indican problemas de datos en la carga de conversiones. solicitud (p.ej., la conversión ya se subió o no se encontró el clickId). En este tipo de error, el mensaje details contiene dos elementos:
- Un código hexadecimal que identifica el tipo de error. Puedes usar el código en tu propio 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 descripciones que Search Ads 360 puede mostrar en caso de 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.
Responder a un error
Si la solicitud falla, vuelve a enviar más tarde toda la llamada. Search Ads 360 mostrará errores requestValidation para las conversiones que se hayan ya se subió, pero intentará subir las conversiones restantes.
Si sigues viendo errores después de volver a enviar el formulario, consulta la solución de problemas para obtener información sobre cómo proceder.