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

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

Информацию об ограничениях на загрузку исторических конверсий можно найти в справочном центре Search Ads 360 .

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

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

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

Конвертируйте все временные метки для преобразования в эпоху (также известную как Unix-время).

Могу ли я создавать действия Floodlight из API?

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

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

Лучшие практики по добавлению конверсий

Мы рекомендуем следующие рекомендации по добавлению конверсий:

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

  2. Загружайте данные о конверсиях, как только они станут доступны. Если вы приписываете конверсии конкретным посещениям , подождите не менее 6 часов после посещения, прежде чем загружать данные о конверсии. Search Ads 360 может не распознать clickID посещения, если вы загрузите данные ранее, чем через 6 часов после него. В редких случаях может потребоваться до 24 часов, прежде чем Search Ads 360 сможет распознать clickID.

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

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

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

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

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

Припишите конверсию к конкретному посещению

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

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

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

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

    Кроме того, если вам известен идентификатор, назначенный Search Ads 360 действию Floodlight, вы можете указать его в поле segmentationId вместо указания имени в поле segmentationName . (Campaign Manager также назначает идентификатор действию Floodlight, но идентификатор Campaign Manager отличается от идентификатора Search Ads 360 и не может использоваться для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, загрузите отчет о конверсиях ( из пользовательского интерфейса Search Ads 360 или API отчетности ). Если в течение отчетного периода действию Floodlight была присвоена хотя бы одна конверсия, вы увидите идентификатор Search Ads 360 в отчете.

  • type : тип конверсии, то есть ACTION или TRANSACTION (TRANSACTION). Конверсия ДЕЙСТВИЯ (ACTION) не имеет денежного выражения, в отличие от конверсии ТРАНЗАКЦИИ (TRANSACTION). Примерами служат подписка на рассылку (ACTION) и покупка в интернете (TRANSACTION).

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

    • revenueMicros : Денежная стоимость конверсии.

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

  • quantityMillis : Количество товаров в этой конверсии. Например, количество людей, подписавшихся на рассылку по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Search Ads 360 автоматически подставит значение 1000 .
  • currencyCode : Валюта дохода от транзакции. По умолчанию предполагается, что доход выражен в валюте рекламодателя. Если вы укажете другую валюту, Search Ads 360 конвертирует указанную сумму дохода в валюту рекламодателя. Подробнее
    Для указания валюты используйте алфавитный (3-символьный) формат ISO 4217 .
    Применимо только для конвертаций ТРАНЗАКЦИЙ.
  • 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"
  }]
}

Ява 

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

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

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

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

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

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

    Кроме того, если вам известен идентификатор, назначенный Search Ads 360 действию Floodlight, вы можете указать его в поле segmentationId вместо указания имени в поле segmentationName . (Campaign Manager также назначает идентификатор действию Floodlight, но идентификатор Campaign Manager отличается от идентификатора Search Ads 360 и не может использоваться для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, загрузите отчет о конверсиях ( из пользовательского интерфейса Search Ads 360 или API отчетности ). Если в течение отчетного периода действию Floodlight была присвоена хотя бы одна конверсия, вы увидите идентификатор Search Ads 360 в отчете.

  • type : тип конверсии, то есть ACTION или TRANSACTION (TRANSACTION). Конверсия ДЕЙСТВИЯ (ACTION) не имеет денежного выражения, в отличие от конверсии ТРАНЗАКЦИИ (TRANSACTION). Примерами служат подписка на рассылку (ACTION) и покупка в интернете (TRANSACTION).

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

    • revenueMicros : Денежная стоимость конверсии.

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

  • quantityMillis : Количество товаров в этой конверсии. Например, количество людей, подписавшихся на рассылку по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Search Ads 360 автоматически подставит значение 1000 .
  • currencyCode : Валюта дохода от транзакции. По умолчанию предполагается, что доход выражен в валюте рекламодателя. Если вы укажете другую валюту, Search Ads 360 конвертирует указанную сумму дохода в валюту рекламодателя. Подробнее
    Для указания валюты используйте алфавитный (3-символьный) формат ISO 4217 .
    Применимо только для конвертаций ТРАНЗАКЦИЙ.
  • 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" : [{
    "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())

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

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

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

Прежде чем начать

В Менеджере кампаний создайте пользовательскую модель атрибуции и импортируйте её в Search Ads 360. Назовите модель «Внешняя модель атрибуции» . Это позволит функциям Search Ads 360 распознавать, что к загружаемым вами данным о конверсиях применена модель атрибуции. Подробнее

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

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

  • clickId : идентификатор клика посещения (с учётом регистра). Найдите идентификатор клика в веб-журналах рекламодателя или перечислите конверсии и используйте идентификатор клика из другой конверсии. Search Ads 360 привяжет конверсию к ключевому слову, объявлению и другим объектам Search Ads 360, которые сгенерировали посещение.
    Подождите не менее 30 минут после того, как Search Ads 360 сгенерирует идентификатор клика, прежде чем загружать конверсию с этим идентификатором. В противном случае API Search Ads 360 может не распознать посещение.
  • attributionModel : выберите «Внешняя модель атрибуции» . Подробнее
  • countMillis : размер кредита конверсии, распределяемого по этому клику. Применимо только в том случае, если запрос также включает поле attributionModel .

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

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

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

    Кроме того, если вам известен идентификатор, назначенный Search Ads 360 действию Floodlight, вы можете указать его в поле segmentationId вместо указания имени в поле segmentationName . (Campaign Manager также назначает идентификатор действию Floodlight, но идентификатор Campaign Manager отличается от идентификатора Search Ads 360 и не может использоваться для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, загрузите отчет о конверсиях ( из пользовательского интерфейса Search Ads 360 или API отчетности ). Если в течение отчетного периода действию Floodlight была присвоена хотя бы одна конверсия, вы увидите идентификатор Search Ads 360 в отчете.

  • type : тип конверсии, то есть ACTION или TRANSACTION (TRANSACTION). Конверсия ДЕЙСТВИЯ (ACTION) не имеет денежного выражения, в отличие от конверсии ТРАНЗАКЦИИ (TRANSACTION). Примерами служат подписка на рассылку (ACTION) и покупка в интернете (TRANSACTION).

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

    • revenueMicros : Денежная стоимость конверсии.

Если вы отслеживаете доход от конверсий, убедитесь, что ваша модель распределяет доход по каждой точке контакта на пути конверсии. Например, если ваша модель использует линейный подход (равномерное распределение дохода по каждой точке контакта), то в пути конверсии, включающем 3 клика по рекламе, на каждый клик будет приходиться 33% конверсии. Если конверсия принесла доход в размере 100 долларов США, убедитесь, что ваша модель распределяет 33 доллара США дохода по каждому клику, а в RevenueMicros указано только 33 доллара США дохода за каждый клик.

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

  • quantityMillis : Количество товаров в этой конверсии. Например, количество людей, подписавшихся на рассылку по электронной почте, или общее количество проданных товаров. Если вы не укажете это поле для конверсий ACTION, Search Ads 360 автоматически подставит значение 1000 .
  • currencyCode : Валюта дохода от транзакции. По умолчанию предполагается, что доход выражен в валюте рекламодателя. Если вы укажете другую валюту, Search Ads 360 конвертирует указанную сумму дохода в валюту рекламодателя. Подробнее
    Для указания валюты используйте алфавитный (3-символьный) формат ISO 4217 .
    Применимо только для конвертаций ТРАНЗАКЦИЙ.
  • 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"
  }]
}

Обработка ответов Search Ads 360

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

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

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

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

Если запрос не удался

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

Вот пример ответа на запрос, который не был полностью выполнен:

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

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

Ошибки проверки запроса

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

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

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

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

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

Реакция на ошибку

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

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