Предыдущий API отчетов Search Ads 360 выведен из эксплуатации. Теперь вы можете создавать отчеты с помощью нового API отчетов Search Ads 360 .

Обратите внимание, что API конверсий Search Ads 360 не будет затронут и будет продолжать поддерживаться.

Эта страница переведена с помощью Cloud Translation API.

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

Вызовите метод 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 используется в основном для офлайн-конверсий. Это рекомендуется, когда стратегии назначения ставок будут использовать данные о конверсиях.

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

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

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

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

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

Привязка конверсии к конкретному посещению

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

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

clickId : идентификатор клика посещения с учетом регистра . Найдите в веб-журналах рекламодателя идентификатор клика или список конверсий и используйте идентификатор клика из другой конверсии. Поисковая реклама 360 свяжет конверсию с ключевым словом, объявлением и другими объектами Поисковой рекламы 360, которые ответственны за посещение.
Подождите не менее 30 минут после того, как Search Ads 360 сгенерирует идентификатор клика для загрузки конверсий. Если вы получили сообщение об ошибке «Идентификатор клика не найден», подождите 4 часа, а затем снова загрузите конверсии. Все конверсии должны быть загружены в течение 90 дней с момента создания идентификатора клика. В противном случае API Search Ads 360 может не распознать это посещение.
conversionId : для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой идентификатор, который им важен. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и отметки времени должна быть уникальной среди всех конверсий внутри рекламодателя. Для онлайн-конверсий Поисковая реклама 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 . (Менеджер кампании также присваивает идентификатор действию Floodlight, но этот идентификатор отличается от идентификатора Search Ads 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, скачайте файл конверсий. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если за период действия отчета хотя бы одна конверсия была связана с действием Floodlight, вы увидите в отчете идентификатор Search Ads 360.
type : тип преобразования, то есть 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"
  }]
}

Чтобы отправить этот запрос, используйте служебный скрипт Search Ads 360.

Чтобы отправить необработанный запрос JSON POST, вы можете использовать сценарий sa360Api.py следующим образом:

Скопируйте пример объекта JSON (все, что находится между двумя фигурными скобками и включая их) в новый текстовый файл с именем request.txt .
Измените идентификатор агентства, указанный в коде JSON, на свой собственный идентификатор агентства.
Удалите все комментарии, например // The date column segments the report by individual days.
Соберите свои учетные данные OAuth 2.0 в одну строку, разделенную запятыми, следующим образом:
client-ID,client-secret,refresh-token
(Это та же строка, которую sa360Api.py выводит при запуске sa360Api.py --login , как описано в разделе «Настройка авторизации» .)
Вызовите sa360Api.py следующим образом:
sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
В приведенной выше команде замените строку CREDENTIALS на строку, которую вы собрали на предыдущем шаге.
Замените имя метода POST в поле ниже на API-method .
Например:
sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/conversion --post < request.txt

Ява

  /**
   * 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 : для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой идентификатор, который им важен. Для каждой конверсии в запросе должен быть указан уникальный идентификатор, а комбинация идентификатора и отметки времени должна быть уникальной среди всех конверсий внутри рекламодателя. Для онлайн-конверсий Поисковая реклама 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 . (Менеджер кампании также присваивает идентификатор действию Floodlight, но этот идентификатор отличается от идентификатора Search Ads 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, скачайте файл конверсий. отчет (либо из пользовательского интерфейса Search Ads 360 , либо из API отчетов ). Если за период действия отчета хотя бы одна конверсия была связана с действием Floodlight, вы увидите в отчете идентификатор Search Ads 360.
type : тип преобразования, то есть 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"
  }]
}

Чтобы отправить этот запрос, используйте служебный скрипт Search Ads 360.

Чтобы отправить необработанный запрос JSON POST, вы можете использовать сценарий sa360Api.py следующим образом:

Скопируйте пример объекта JSON (все, что находится между двумя фигурными скобками и включая их) в новый текстовый файл с именем request.txt .
Измените идентификатор агентства, указанный в коде JSON, на свой собственный идентификатор агентства.
Удалите все комментарии, например // The date column segments the report by individual days.
Соберите свои учетные данные OAuth 2.0 в одну строку, разделенную запятыми, следующим образом:
client-ID,client-secret,refresh-token
(Это та же строка, которую sa360Api.py выводит при запуске sa360Api.py --login , как описано в разделе «Настройка авторизации» .)
Вызовите sa360Api.py следующим образом:
sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
В приведенной выше команде замените строку CREDENTIALS на строку, которую вы собрали на предыдущем шаге.
Замените имя метода POST в поле ниже на API-method .
Например:
sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/conversion --post < request.txt

Ява

  /**
   * 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 и использовать эти данные в отчетах и результатах поиска. Стратегии назначения ставок в Ads 360.

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

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

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

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

clickId : идентификатор клика посещения с учетом регистра . Найдите в веб-журналах рекламодателя идентификатор клика или список конверсий и используйте идентификатор клика из другой конверсии. Поисковая реклама 360 свяжет конверсию с ключевым словом, объявлением и другими объектами Поисковой рекламы 360, которые ответственны за посещение.
Прежде чем загружать конверсию с идентификатором , подождите не менее 30 минут после того, как Search Ads 360 сгенерирует идентификатор клика. В противном случае API Search Ads 360 может не распознать это посещение.
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), рекомендуется переименовать одно из действий .
Альтернативно, если вы знаете, что идентификатор Search Ads 360 присвоил действию Floodlight, вы можете указать идентификатор в segmentationId вместо указания имени в поле segmentationName . (Менеджер кампании также присваивает идентификатор действию Floodlight, но этот идентификатор отличается от идентификатора Search Ads 360, и его нельзя использовать для атрибуции конверсий.) Чтобы просмотреть идентификатор Search Ads 360 для действия Floodlight, скачайте файл конверсий. отчет (либо из пользовательского интерфейса Search Ads 360 , либо через API отчетов ). Если за период действия отчета хотя бы одна конверсия была связана с действием Floodlight, вы увидите в отчете идентификатор Search Ads 360.
type : тип преобразования, то есть 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.

Чтобы отправить необработанный запрос JSON POST, вы можете использовать сценарий sa360Api.py следующим образом:

Скопируйте пример объекта JSON (все, что находится между двумя фигурными скобками и включая их) в новый текстовый файл с именем request.txt .
Измените идентификатор агентства, указанный в коде JSON, на свой собственный идентификатор агентства.
Удалите все комментарии, например // The date column segments the report by individual days.
Соберите свои учетные данные OAuth 2.0 в одну строку, разделенную запятыми, следующим образом:
client-ID,client-secret,refresh-token
(Это та же строка, которую sa360Api.py выводит при запуске sa360Api.py --login , как описано в разделе «Настройка авторизации» .)
Вызовите sa360Api.py следующим образом:
sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
В приведенной выше команде замените строку CREDENTIALS на строку, которую вы собрали на предыдущем шаге.
Замените имя метода POST в поле ниже на API-method .
Например:
sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/conversion --post < request.txt

Обработка ответов Поисковой рекламы 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.

Ответ на ошибку

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

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

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

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

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

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

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

Привязка конверсии к конкретному посещению

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

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

JSON

Чтобы отправить этот запрос, используйте служебный скрипт Search Ads 360.

Ява

Питон

Связать конверсию только с ключевым словом

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

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

JSON

Чтобы отправить этот запрос, используйте служебный скрипт Search Ads 360.

Ява

Питон

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

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

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

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

Пример

Чтобы отправить этот запрос, используйте служебный скрипт Search Ads 360.

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

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

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

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

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

Ответ на ошибку