Agregar conversiones nuevas

¿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:

1. 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.

2. 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.

3. 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 los dsConversionId o floodlightOrderId. 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 especificar FLOODLIGHT.
• 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 segmentationId en lugar de especificar el nombre en el campo segmentationName. (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, ACTION o TRANSACTION. 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 de 1000.
• 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.
• customMetric y customDimension: 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 Floodlight
• deviceType: Especifica el tipo de dispositivo en el que se generó la conversión. Consulta la lista de valores aceptados para este .

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"
  }]
}
          

  /**
   * 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());
    }
  }
            

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 la criterionId, agrega TrackerId. 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 copia dsConversionId o floodlightOrderId. 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 especificar FLOODLIGHT.
• 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 segmentationId en lugar de especificar el nombre en el campo segmentationName. (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, ACTION o TRANSACTION. 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 de 1000.
• 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.
• customMetric y customDimension: 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 Floodlight
• deviceType: Especifica el tipo de dispositivo en el que se generó la conversión. Consulta la lista de valores aceptados para este .

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"
  }]
}

  /**
   * 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;
  }        

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())

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"
  }]
}
          

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.