Добавить новые конверсии

Вызовите метод Conversion.insert(), чтобы добавить одну или несколько конверсий. Чтобы правильно атрибутировать конверсию, в запросе необходимо указать название действия Floodlight, которое рекламодатель использует для регистрации офлайн-конверсий, а также идентификатор клика, связанного с посещением, или идентификаторы ключевого слова, которое привело к конверсии. Информацию о том, как получить идентификаторы Поисковой рекламы 360, вы найдете в статье Идентификаторы и конверсии Поисковой рекламы 360.

Информацию об ограничениях на загрузку данных о прошлых конверсиях можно найти в Справочном центре Поисковой рекламы 360.

Если в запросе Conversion.insert() указано несколько конверсий, Поисковая реклама 360 пытается загрузить каждую из них по отдельности, а не весь пакет сразу. Если некоторые конверсии в пакете не загружаются, другие все равно могут быть загружены. Загрузка конверсий может завершиться ошибкой из-за недопустимого запроса или временных сбоев в сети или системе. Поэтому мы рекомендуем проверять ответ для каждой добавленной конверсии, чтобы убедиться, что загрузка прошла успешно.

Как скоро я смогу использовать загруженные данные?

Если в качестве conversionTimestamp конверсии указать сегодняшний или вчерашний день, показатели конверсии появятся в интерфейсе Поисковой рекламы 360 в течение часа с момента загрузки, Если указать conversionTimestampболее раннюю дату, то показатели обновятся в течение нескольких часов.

Преобразуйте все временные метки конверсий в Unix-время.

Можно ли создавать действия Floodlight с помощью API?

Если рекламодатель ещё не создал действие Floodlight для отслеживания офлайн-конверсий, вы можете сделать это с помощью Campaign Manager API. С помощью API нельзя указать, что действие Floodlight используется в основном для офлайн-конверсий. Это рекомендуется делать, если стратегии назначения ставок будут использовать данные о конверсиях.

Рекомендуем после создания действия Floodlight с помощью API войти в Поисковую рекламу 360 и изменить настройки действия, чтобы указать, что основным источником конверсий является офлайн-активность.

Рекомендации по добавлению конверсий

При добавлении конверсий рекомендуем следовать приведенным ниже советам.

  1. Попросите пользователя Поисковой рекламы 360 войти в аккаунт и изменить настройки для каждого действия Floodlight, которое вы используете для регистрации офлайн-конверсий. В настройках должно быть указано, что основным источником конверсий являются офлайн-действия. Инструкции можно найти в Справочном центре Поисковой рекламы 360.

  2. Загружайте данные о конверсиях, как только они становятся доступны. Если вы атрибутируете конверсии определенным посещениям, подождите не менее шести часов после посещения, прежде чем загружать конверсию. Если вы загрузите данные раньше, чем через шесть часов после посещения, Поисковая реклама 360 может не распознать идентификатор клика. В редких случаях может потребоваться подождать до 24 часов, прежде чем Поисковая реклама 360 распознает clickId.

    Убедитесь, что каждая загрузка содержит самые последние конверсии. В рамках одного запроса на загрузку записи могут быть расположены не в хронологическом порядке. Однако стратегия назначения ставок может не учитывать более ранние конверсии, которые вы загружаете позже в другом запросе.

Отправка запроса на вставку

Вы можете отправить запрос Conversion.insert(), чтобы выполнить любое из следующих действий:

  • Как соотнести конверсию с определенным посещением
  • Присвоить конверсию только ключевому слову

Поля, которые должны быть в запросе Conversion.insert(), зависят от события или объекта, с которым вы связываете конверсию. В разделах ниже перечислены обязательные и необязательные поля для каждого события или объекта, с которым можно связать конверсию.

Как соотнести конверсию с определенным посещением

Когда клиент нажимает на одно или несколько объявлений и переходит на сайт рекламодателя, Поисковая реклама 360 считает сеанс пользователя на сайте рекламодателя посещением. Чтобы связать конверсию с посещением, укажите в запросе Conversion.insert() следующее:

Обязательные поля

  • clickId – идентификатор клика, в котором учитывается регистр. Найдите идентификатор клика в веб-журналах рекламодателя или получите conversion.click_id другой конверсии с помощью нового Search Ads 360 Reporting API. Поисковая реклама 360 свяжет конверсию с ключевым словом, объявлением и другими объектами, которые привели к посещению.
    Подождите не менее шести часов после того, как Поисковая реклама 360 сгенерирует идентификатор клика, чтобы загрузить конверсии. Если вы получили сообщение об ошибке "Идентификатор клика не найден", подождите 24 часа и повторите загрузку конверсий. Все конверсии должны быть загружены в течение 90 дней с момента создания идентификатора клика. В противном случае Search Ads 360 API может не распознать посещение.
  • conversionId – для офлайн-конверсий этот идентификатор предоставляют рекламодатели. Рекламодатели могут указывать любые идентификаторы, которые им подходят. Каждая конверсия в запросе должна иметь уникальный идентификатор, а сочетание идентификатора и временной метки должно быть уникальным для всех конверсий рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копирует в это свойство значение dsConversionId или floodlightOrderId в зависимости от инструкций Floodlight рекламодателя.
  • conversionTimestamp – дата и время совершения конверсии. Например, если конверсия произошла в пятницу, 5 августа 2016 г., в 11:53:22 по североамериканскому восточному летнему времени (GMT -4:00), укажите временную метку в миллисекундах с начала эпохи: 1470412402000.
  • segmentationType – тип системы конверсий, в которую вы загружаете конверсию. В настоящее время поддерживаются только конверсии Floodlight, поэтому в этом поле всегда необходимо указывать FLOODLIGHT.
  • segmentationName. Название действия Floodlight, которое рекламодатель использует для регистрации конверсии.

    Если у рекламодателя есть действия с одинаковыми названиями (это может произойти, если действия относятся к разным группам Floodlight), рекомендуется переименовать одно из действий.

    Вместо названия действия Floodlight в поле segmentationName можно указать его идентификатор в поле segmentationId. Используйте идентификатор, который Менеджер кампаний назначил действию Floodlight. Этот идентификатор можно получить с помощью поля conversion_action.floodlight_settings.activity_id в новой версии Поисковой рекламы 360 Reporting API. Также принимается значение segmentationId, которое Поисковая реклама 360 возвращает в ответе на запрос конверсии.

  • type – тип конверсии, то есть ACTION или TRANSACTION. Конверсия ACTION не имеет денежной ценности, а конверсия TRANSACTION – имеет. Примеры: подписка на рассылку (действие) и покупка в интернет-магазине (транзакция).

    Если вы указываете TRANSACTION, вам также нужно указать следующее поле:

    • revenueMicros – денежная ценность конверсии.

Необязательные поля

  • quantityMillis – количество товаров в этой конверсии. Например, это может быть количество пользователей, подписавшихся на рассылку, или общее число проданных товаров. Если вы не заполните это поле для конверсий типа ACTION, Поисковая реклама 360 автоматически подставит значение 1000.
  • currencyCode: валюта дохода от транзакции. По умолчанию доход указывается в валюте рекламодателя. Если вы укажете другую валюту, Поисковая реклама 360 конвертирует указанную сумму дохода в валюту рекламодателя. Подробнее…
    Укажите код валюты в трехзначном буквенном формате ISO 4217.
    Применимо только для конверсий типа TRANSACTION.
  • customMetric и customDimension. Загружают дополнительные данные о конверсии, например страну, в которую отправлен купленный товар, идентификаторы товаров или даже продолжительность телефонного звонка. Подробнее о загрузке данных для пользовательских переменных Floodlight…
  • deviceType – тип устройства, на котором была совершена конверсия. Ознакомьтесь со списком допустимых значений для этого поля.

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

Присвоить конверсию только ключевому слову

Если у вас нет идентификатора клика, вы можете связать конверсию непосредственно с ключевым словом. В новом интерфейсе Поисковой рекламы 360 идентификаторы ключевых слов уникальны только в пределах группы объявлений, поэтому вам нужно указать полный набор идентификаторов нового интерфейса Поисковой рекламы 360, которые определяют ключевое слово, а также несколько других полей:

Обязательные поля

  • customerId – идентификатор клиентского аккаунта, в котором содержится ключевое слово, например 123-456-7890.
  • campaignId – идентификатор кампании, в которой содержится ключевое слово.
  • adGroupId – идентификатор группы объявлений, содержащей ключевое слово.
  • criterionId – идентификатор ключевого слова.

    Если в конверсии указано значение criterionId, но не указаны customerId, campaignId или adGroupId, произойдет ошибка с кодом ошибки 0x0000012E. Информацию о том, как получить эти идентификаторы, вы найдете в статье Идентификаторы и конверсии Поисковой рекламы 360.

  • conversionId – для офлайн-конверсий этот идентификатор предоставляют рекламодатели. Рекламодатели могут указывать любые идентификаторы, которые им подходят. Каждая конверсия в запросе должна иметь уникальный идентификатор, а сочетание идентификатора и временной метки должно быть уникальным для всех конверсий рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копирует в это свойство значение dsConversionId или floodlightOrderId в зависимости от инструкций Floodlight рекламодателя.
  • conversionTimestamp – дата и время совершения конверсии. Например, если конверсия произошла в пятницу, 5 августа 2016 г., в 11:53:22 по североамериканскому восточному летнему времени (GMT -4:00), укажите временную метку в миллисекундах с начала эпохи: 1470412402000.
  • segmentationType – тип системы конверсий, в которую вы загружаете конверсию. В настоящее время поддерживаются только конверсии Floodlight, поэтому в этом поле всегда необходимо указывать FLOODLIGHT.
  • segmentationName. Название действия Floodlight, которое рекламодатель использует для регистрации конверсии.

    Если у рекламодателя есть действия с одинаковыми названиями (это возможно, если действия относятся к разным группам Floodlight), рекомендуется переименовать одно из действий.

    Вместо названия действия Floodlight в поле segmentationName можно указать его идентификатор в поле segmentationId. Используйте идентификатор, который Менеджер кампаний назначил действию Floodlight. Этот идентификатор можно получить с помощью поля conversion_action.floodlight_settings.activity_id в новой версии Поисковой рекламы 360 Reporting API. Также принимается значение segmentationId, которое Поисковая реклама 360 возвращает в ответе на запрос конверсии.

  • type – тип конверсии, то есть ACTION или TRANSACTION. Конверсия ACTION не имеет денежной ценности, а конверсия TRANSACTION – имеет. Примеры: подписка на рассылку (действие) и покупка в интернет-магазине (транзакция).

    Если вы указываете TRANSACTION, вам также нужно указать следующее поле:

    • revenueMicros – денежная ценность конверсии.

Необязательные поля

  • quantityMillis – количество товаров в этой конверсии. Например, это может быть количество пользователей, подписавшихся на рассылку, или общее число проданных товаров. Если вы не заполните это поле для конверсий типа ACTION, Поисковая реклама 360 автоматически подставит значение 1000.
  • currencyCode: валюта дохода от транзакции. По умолчанию доход указывается в валюте рекламодателя. Если вы укажете другую валюту, Поисковая реклама 360 конвертирует указанную сумму дохода в валюту рекламодателя. Подробнее…
    Укажите код валюты в трехзначном буквенном формате ISO 4217.
    Применимо только для конверсий типа TRANSACTION.
  • customMetric и customDimension. Загружают дополнительные данные о конверсии, например страну, в которую отправлен купленный товар, идентификаторы товаров или даже продолжительность телефонного звонка. Подробнее о загрузке данных для пользовательских переменных Floodlight…
  • deviceType – тип устройства, на котором была совершена конверсия. Ознакомьтесь со списком допустимых значений для этого поля.

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

Как загрузить данные из сторонней модели атрибуции

Модель атрибуции распределяет ценность конверсии между всеми действиями на пути к ней. Например, если перед конверсией пользователь нажал на поисковое объявление, медийное объявление и ещё одно поисковое объявление, то линейная модель атрибуции присвоит каждому клику 33 % ценности конверсии.

В Поисковой рекламе 360 есть модели атрибуции, но если вы используете сторонний сервис или сервис собственной разработки для распределения ценности кликов, то можете загрузить данные атрибуции из этого сервиса в Поисковую рекламу 360 и использовать их в отчетах и стратегиях назначения ставок.

Подготовка

Создайте специальную модель атрибуции в Менеджере кампаний и импортируйте ее в Поисковую рекламу 360. Укажите название модели: Сторонняя модель атрибуции. Это позволит функциям Поисковой рекламы 360 распознавать, что к загруженным вами данным о конверсиях была применена модель атрибуции. Подробнее…

Обязательные поля

Чтобы применить стороннюю модель атрибуции к конверсии, укажите в запросе Conversion.insert() все перечисленные ниже параметры.

  • clickId – идентификатор клика, в котором учитывается регистр. Найдите идентификатор клика в веб-журналах рекламодателя или получите conversion.click_id другой конверсии с помощью нового Search Ads 360 Reporting API. Поисковая реклама 360 свяжет конверсию с ключевым словом, объявлением и другими объектами, которые привели к посещению.
    Подождите не менее 30 минут после того, как Поисковая реклама 360 сгенерирует идентификатор клика, прежде чем загружать конверсию с этим идентификатором. В противном случае Search Ads 360 API может не распознать посещение.
  • attributionModel: выберите Сторонняя модель атрибуции. Подробнее…
  • countMillis – доля ценности конверсии, которая будет присвоена этому клику. Применимо, только если запрос также содержит поле attributionModel.

    Не путайте его с необязательным полем quantityMillis, в котором указывается количество объектов в конверсии (например, количество товаров в корзине).

  • conversionId – для офлайн-конверсий этот идентификатор предоставляют рекламодатели. Рекламодатели могут указывать любые идентификаторы, которые им подходят. Каждая конверсия в запросе должна иметь уникальный идентификатор, а сочетание идентификатора и временной метки должно быть уникальным для всех конверсий рекламодателя. Для онлайн-конверсий Поисковая реклама 360 копирует в это свойство значение dsConversionId или floodlightOrderId в зависимости от инструкций Floodlight рекламодателя.
  • conversionTimestamp – дата и время совершения конверсии. Например, если конверсия произошла в пятницу, 5 августа 2016 г., в 11:53:22 по североамериканскому восточному летнему времени (GMT -4:00), укажите временную метку в миллисекундах с начала эпохи: 1470412402000.
  • segmentationType – тип системы конверсий, в которую вы загружаете конверсию. В настоящее время поддерживаются только конверсии Floodlight, поэтому в этом поле всегда необходимо указывать FLOODLIGHT.
  • segmentationName. Название действия Floodlight, которое рекламодатель использует для регистрации конверсии.

    Если у рекламодателя есть действия с одинаковыми названиями (это возможно, если действия относятся к разным группам Floodlight), рекомендуется переименовать одно из действий.

    Вместо названия действия Floodlight в поле segmentationName можно указать его идентификатор в поле segmentationId. Используйте идентификатор, который Менеджер кампаний назначил действию Floodlight. Этот идентификатор можно получить с помощью поля conversion_action.floodlight_settings.activity_id в новой версии Поисковой рекламы 360 Reporting API. Также принимается значение segmentationId, которое Поисковая реклама 360 возвращает в ответе на запрос конверсии.

  • type – тип конверсии, то есть ACTION или TRANSACTION. Конверсия ACTION не имеет денежной ценности, а конверсия TRANSACTION – имеет. Примеры: подписка на рассылку (действие) и покупка в интернет-магазине (транзакция).

    Если вы указываете TRANSACTION, вам также нужно указать следующее поле:

    • revenueMicros – денежная ценность конверсии.

Если вы отслеживаете доход от конверсий, убедитесь, что ваша модель распределяет доход между всеми точками взаимодействия на пути конверсии. Например, если в вашей модели используется линейный подход (доход равномерно распределяется между всеми точками взаимодействия), то в пути конверсии, включающей три клика по объявлению, каждому клику будет приписано 33 % конверсии. Если конверсия принесла 1000 рублей дохода, убедитесь, что ваша модель распределяет по 330 рублей дохода на каждый клик, и при загрузке данных указывайте только 330 рублей дохода для каждого клика.revenueMicros

Необязательные поля

  • quantityMillis – количество товаров в этой конверсии. Например, это может быть количество пользователей, подписавшихся на рассылку, или общее число проданных товаров. Если вы не заполните это поле для конверсий типа ACTION, Поисковая реклама 360 автоматически подставит значение 1000.
  • currencyCode: валюта дохода от транзакции. По умолчанию доход указывается в валюте рекламодателя. Если вы укажете другую валюту, Поисковая реклама 360 конвертирует указанную сумму дохода в валюту рекламодателя. Подробнее…
    Укажите код валюты в трехзначном буквенном формате ISO 4217.
    Применимо только для конверсий типа TRANSACTION.
  • customMetric и customDimension. Загружают дополнительные данные о конверсии, например страну, в которую отправлен купленный товар, идентификаторы товаров или даже продолжительность телефонного звонка. Подробнее о загрузке данных для пользовательских переменных Floodlight…
  • deviceType – тип устройства, на котором была совершена конверсия. Ознакомьтесь со списком допустимых значений для этого поля.

Пример

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

Как обрабатывать ответы Поисковой рекламы 360

Ответ от Поисковой рекламы 360 будет положительным, только если все конверсии в запросе были успешно проверены и загружены.

Если запрос выполнен успешно

Если запрос выполнен успешно, ответ содержит полное внутреннее представление Поисковой рекламы 360 для каждой загруженной конверсии. В представлении используются новые идентификаторы Поисковой рекламы 360: идентификатор клиента для клиентского аккаунта, а также идентификаторы кампании, группы объявлений, ключевого слова (критерия) и объявления, с которыми связана конверсия.

Ниже приведен пример ответа для конверсии, связанной с посещением.

{
 "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"
  },
  ...
 ]
}

В ответе будут только идентификаторы, относящиеся к конверсии. Например, в ответе для конверсии, связанной только с ключевым словом, не будет полей clickId и adId.

Если запрос не будет выполнен

Если не удается проверить или загрузить одну или несколько конверсий, ответ будет содержать сообщения для каждой неудачной загрузки. В ответе не будет сообщений об успешно загруженных конверсиях.

Ниже приведен пример ответа на запрос, который не был выполнен полностью.

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

Каждое сообщение об ошибке содержит два важных поля: причину и подробное сообщение об ошибке. Поле reason может содержать значения requestValidation, internalError, transactionFailed или lateStageRequestError.

Ошибки requestValidation

Ошибки requestValidation указывают на проблемы с данными в запросе на загрузку конверсий (например, конверсия уже загружена или не найден идентификатор клика). В этом случае подробности сообщения содержат два элемента:

  • Шестнадцатеричный код, который указывает на тип ошибки. Вы можете использовать этот код в своих скриптах для выявления ошибок.
  • Описание ошибки проверки.

Дополнительную информацию вы найдете в списке кодов и описаний, которые Поисковая реклама 360 может возвращать при ошибках загрузки конверсий.

Другие типы ошибок

Все остальные типы ошибок (internalError, transactionFailed или lateStageRequestError) указывают на внутреннюю проблему в Поисковой рекламе 360.

Как реагировать на ошибки

Если запрос не удался, попробуйте повторно отправить весь вызов запроса позже. Поисковая реклама 360 сообщит об ошибках requestValidation для всех уже загруженных конверсий, но попытается загрузить остальные.

Если после повторной отправки ошибки не исчезли, ознакомьтесь с разделом Устранение неполадок.