Llama al método Conversion.insert() para agregar una o más conversiones. Para atribuir la conversión de forma correcta, tu solicitud debe especificar el nombre de una actividad de Floodlight que el anunciante usa 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.
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 intentará subir cada conversión en función 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 pueden subir, es posible que otras se suban correctamente de todas formas. 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 a fin de asegurarte de que la carga se realice de forma correcta.
¿Cuándo podré usar los datos subidos?
Si especificas un
conversionTimestamp de hoy o de ayer para una conversión, las métricas de la conversión se mostrarán en la IU de Search Ads 360 en el plazo de una hora a partir de la carga. Si especificas un conversionTimestamp que sea anterior a ayer, las métricas se actualizarán dentro de 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 usar 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, lo cual es una práctica recomendada cuando las estrategias de ofertas usarán los datos de la conversión.
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
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 de cada actividad de Floodlight que uses 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 30 minutos después de la visita para subir la conversión. Es posible que Search Ads 360 no reconozca el ID de clic de la visita si la carga antes de 30 minutos después de esta. En raras ocasiones, es posible que debas esperar hasta 4 horas para que Search Ads 360 pueda reconocer el clickId.
Asegúrate de que cada carga contenga las conversiones más recientes. Dentro de una sola solicitud de carga, no hay problema si las entradas están desordenadas cronológicamente. Sin embargo, es posible que una estrategia de ofertas no pueda 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ía una marca de tiempo de disponibilidad.
La marca de tiempo de disponibilidad debe ser una de las siguientes opciones:
- Si registraste conversiones durante las últimas 24 horas, pero aún no las subiste, la marca de tiempo debe ser la hora en que se produjo la última conversión subida. Esto le indica a Search Ads 360 que las conversiones pueden haber ocurrido durante las últimas 24 horas, pero aún no proporcionaste los datos. Las estrategias de ofertas y otros sistemas automatizados considerarán el historial de rendimiento solo hasta la última conversión que subiste.
- Si no se produjeron conversiones durante las últimas 24 horas, la marca de tiempo debe ser la fecha y hora actuales. Esto le indica a Search Ads 360 que no se generaron conversiones durante las últimas 24 horas. Las estrategias de ofertas y otros sistemas automatizados incluirán las últimas 24 horas (un día completo sin conversiones) como 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 los campos obligatorios y opcionales para cada evento o elemento al que puedes 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 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 de Conversion.insert():
Campos obligatorios
clickId: El ID de clic de la visita que distingue mayúsculas de minúsculas. Busca en los registros web del anunciante el ID de clic o la lista de conversiones y usa el 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 para subir conversiones. Si recibes un mensaje de error que indica que no se encontró el ID de clic, espera 4 horas y, luego, vuelve a subir las conversiones. Todas las conversiones se deben subir en un plazo de 90 días a partir del momento 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: Para las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que sea significativo para ellos. 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 dentro del anunciante. Para 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 hora en la que se generó la conversión. Por ejemplo, si la conversión se realiza el viernes, 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 al que subirás 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 registrar la conversión.Si el anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenecen a grupos de Floodlight diferentes), se recomienda cambiar el nombre de una de las actividades.
Como alternativa, si sabes el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificar el ID en
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 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,ACTIONoTRANSACTION. Una conversión de ACTION no tiene valor monetario, mientras que una conversión de TRANSACTION sí. Algunos ejemplos son los registros en listas de direcciones de correo electrónico (ACTION) y 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 insertará automáticamente un valor de1000.currencyCode: Es la moneda de los ingresos de una transacción. De forma predeterminada, se supone que los ingresos corresponden a la moneda del anunciante. Si especificas una moneda diferente, Search Ads 360 convertirá 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 del producto o incluso la duración de una llamada telefónica. Obtén más información sobre cómo subir datos para 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())
Atribuir una conversión solo a una palabra clave
Si tu preocupación principal 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: Este es el identificador de la palabra clave. Para obtener lacriterionId, agrega la macroTrackerIda las URLs de tu página de destino. Para obtener información sobre cómo obtener IDs de palabras clave, consulta IDs y conversiones de Search Ads 360.conversionId: Para las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que sea significativo para ellos. 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 dentro del anunciante. Para 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 hora en la que se generó la conversión. Por ejemplo, si la conversión se realiza el viernes, 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 al que subirás 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 registrar la conversión.Si el anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenecen a grupos de Floodlight diferentes), se recomienda cambiar el nombre de una de las actividades.
Como alternativa, si sabes el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificar el ID en
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 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,ACTIONoTRANSACTION. Una conversión de ACTION no tiene valor monetario, mientras que una conversión de TRANSACTION sí. Algunos ejemplos son los registros en listas de direcciones de correo electrónico (ACTION) y 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 insertará automáticamente un valor de1000.currencyCode: Es la moneda de los ingresos de una transacción. De forma predeterminada, se supone que los ingresos corresponden a la moneda del anunciante. Si especificas una moneda diferente, Search Ads 360 convertirá 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 del producto o incluso la duración de una llamada telefónica. Obtén más información sobre cómo subir datos para 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())
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 toda la actividad 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 generar la conversión, un modelo de atribución lineal le daría a cada clic el 33% del crédito de conversión.
Aunque Search Ads 360 proporciona modelos de atribución, si usas un servicio de terceros o un servicio 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 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 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 de Conversion.insert():
clickId: El ID de clic de la visita que distingue mayúsculas de minúsculas. Busca en los registros web del anunciante el ID de clic o la lista de conversiones y usa el 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: 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 la cantidad de artículos en una conversión (como la cantidad de artículos en la compra de un carrito de compras).conversionId: Para las conversiones sin conexión, los anunciantes proporcionan este ID. Los anunciantes pueden especificar cualquier ID que sea significativo para ellos. 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 dentro del anunciante. Para 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 hora en la que se generó la conversión. Por ejemplo, si la conversión se realiza el viernes, 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 al que subirás 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 registrar la conversión.Si el anunciante contiene actividades con el mismo nombre (esto puede suceder si las actividades pertenecen a grupos de Floodlight diferentes), se recomienda cambiar el nombre de una de las actividades.
Como alternativa, si sabes el ID que Search Ads 360 asignó a una actividad de Floodlight, puedes especificar el ID en
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 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,ACTIONoTRANSACTION. Una conversión de ACTION no tiene valor monetario, mientras que una conversión de TRANSACTION sí. Algunos ejemplos son los registros en listas de direcciones de correo electrónico (ACTION) y 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 haces un seguimiento de los ingresos de 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 equitativamente los ingresos entre cada punto de contacto) en una ruta de conversión que incluye 3 clics en el anuncio, cada clic se atribuirá a un 33% de la conversión. Si la conversión generó USD 100 en ingresos, asegúrate de que tu modelo distribuya USD 33 de ingresos por 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 insertará automáticamente un valor de1000.currencyCode: Es la moneda de los ingresos de una transacción. De forma predeterminada, se supone que los ingresos corresponden a la moneda del anunciante. Si especificas una moneda diferente, Search Ads 360 convertirá 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 del producto o incluso la duración de una llamada telefónica. Obtén más información sobre cómo subir datos para 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 incluye la representación interna completa de Search Ads 360 para cada conversión subida, como el ID de campaña, el ID del grupo de anuncios y el ID de 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 carga de conversiones con errores. La respuesta no contiene mensajes sobre las conversiones que se subieron 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 mensaje de error detallado. El campo del 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 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 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 mostrar para 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 informará errores requestValidation para todas las conversiones que ya se subieron, pero intentará subir las conversiones restantes.
Si sigues viendo errores después de volver a enviar el formulario, consulta la sección de solución de problemas para obtener información sobre cómo proceder.