Method: customers.uploadConversionAdjustments

Обрабатывает заданные корректировки преобразования.

Список выброшенных ошибок: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

HTTP-запрос

POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadConversionAdjustments

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Необходимый. Идентификатор клиента, выполняющего загрузку.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
Поля
conversionAdjustments[]

object ( ConversionAdjustment )

Необходимый. Корректировки конверсий, которые загружаются.

partialFailure

boolean

Необходимый. Если это правда, будут выполнены успешные операции, а недопустимые операции вернут ошибки. Если false, все операции будут выполняться за одну транзакцию тогда и только тогда, когда все они действительны. Для этого параметра всегда должно быть установлено значение true. Дополнительную информацию о частичном сбое см. на странице https://developers.google.com/google-ads/api/docs/best-practices/partial-failures .

validateOnly

boolean

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

jobId

integer

Необязательный. Дополнительный ввод для установки идентификатора задания. Должно быть неотрицательное число меньше 2^31, если оно указано. Если это поле не указано, API сгенерирует идентификатор задания в диапазоне [2^31, (2^63)-1]. API вернет значение для этого запроса в поле jobId в UploadConversionAdjustmentsResponse .

Тело ответа

Ответное сообщение для ConversionAdjustmentUploadService.UploadConversionAdjustments .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
Поля
partialFailureError

object ( Status )

Ошибки, связанные с ошибками корректировки преобразования в режиме частичного отказа. Возвращается, когда в настройках происходят все ошибки. Если возникают какие-либо ошибки вне настроек (например, ошибки аутентификации), мы возвращаем ошибку уровня RPC. Дополнительную информацию о частичном сбое см. на странице https://developers.google.com/google-ads/api/docs/best-practices/partial-failures .

results[]

object ( ConversionAdjustmentResult )

Возвращается для успешно обработанных корректировок конверсий. Proto будет пустым для строк, получивших ошибку. Результаты не возвращаются, если validateOnly имеет значение true.

jobId

string ( int64 format)

Идентификатор задания для пакета загрузки.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/adwords

Дополнительную информацию см. в обзоре OAuth 2.0 .

Корректировка конверсии

Корректировка конверсии.

JSON-представление
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
Поля
gclidDateTimePair

object ( GclidDateTimePair )

Для корректировок уникально идентифицирует конверсию, о которой сообщалось без указания идентификатора заказа. Если параметр корректировки имеет значение ENHANCEMENT, это значение является необязательным, но может быть установлено в дополнение к orderId.

adjustmentType

enum ( ConversionAdjustmentType )

Тип регулировки.

restatementValue

object ( RestatementValue )

Информация, необходимая для переоценки ценности конверсии. Требуется для пересчета. Не следует поставлять для ретракций. Если предусмотрен отзыв, будет возвращена ошибка. ПРИМЕЧАНИЕ. Если вы хотите загрузить второй пересчет с другим скорректированным значением, он должен иметь новое, более позднее время возникновения корректировки. В противном случае оно будет рассматриваться как дубликат предыдущего переформулирования и игнорироваться.

userIdentifiers[]

object ( UserIdentifier )

Идентификаторы пользователей для улучшения исходной конверсии. ConversionAdjustmentUploadService принимает только идентификаторы пользователей в улучшениях. Максимальное количество идентификаторов пользователей для каждого расширения — 5.

orderId

string

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

conversionAction

string

Название ресурса действия-конверсии, связанного с этой корректировкой конверсий. Примечание. Хотя имя этого ресурса состоит из идентификатора клиента и идентификатора действия-конверсии, при проверке идентификатор клиента будет игнорироваться, а идентификатор действия-конверсии будет использоваться в качестве единственного идентификатора действия-конверсии.

adjustmentDateTime

string

Дата и время, когда произошла корректировка. Должно быть после конверсииDateTime. Часовой пояс должен быть указан. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00».

userAgent

string

Пользовательский агент для улучшения исходного преобразования. Это можно найти в заголовке HTTP-запроса вашего пользователя, когда он совершает конверсию на вашей веб-странице. Пример: «Mozilla/5.0 (iPhone; процессор iPhone OS 12_2, например Mac OS X)». Пользовательский агент можно указать только в расширениях с идентификаторами пользователей. Он должен соответствовать пользовательскому агенту запроса, отправившего исходное преобразование, поэтому преобразование и его улучшение либо атрибутируются как одно и то же устройство, либо оба атрибутируются как перекрестное преобразование.

GclidDateTimePair

Уникально идентифицирует конверсию, о которой сообщалось без указания идентификатора заказа.

JSON-представление
{
  "gclid": string,
  "conversionDateTime": string
}
Поля
gclid

string

Идентификатор клика Google (gclid), связанный с исходной конверсией для этой корректировки.

conversionDateTime

string

Дата и время, когда произошла исходная конверсия для этой корректировки. Часовой пояс должен быть указан. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00».

Тип корректировки конверсии

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Представляет значение, неизвестное в этой версии.
RETRACTION Отменяет преобразование, так что его общее значение и количество равны нулю.
RESTATEMENT Изменяет ценность конверсии.
ENHANCEMENT Дополняет существующую конверсию предоставленными идентификаторами пользователей и пользовательским агентом, которые Google может использовать для увеличения количества конверсий.

ПереформулированиеЗначения

Содержит информацию, необходимую для переоценки ценности конверсии.

JSON-представление
{
  "adjustedValue": number,
  "currencyCode": string
}
Поля
adjustedValue

number

Пересчитанная ценность конверсии. Это стоимость конверсии после пересчета. Например, чтобы изменить ценность конверсии со 100 на 70, необходимо указать скорректированное значение 70. ПРИМЕЧАНИЕ. Если вы хотите загрузить второй пересчет с другим скорректированным значением, он должен иметь новое, более позднее время возникновения корректировки. В противном случае оно будет рассматриваться как дубликат предыдущего переформулирования и игнорироваться.

currencyCode

string

Валюта пересчитанной стоимости. Если она не указана, используется валюта по умолчанию из действия-конверсии, а если она не задана, то используется валюта аккаунта. Это трехзначный код валюты ISO 4217, например, доллар США или евро.

Результат корректировки конверсии

Информация, идентифицирующая успешно обработанную настройку ConversionAdjustment.

JSON-представление
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Поля
gclidDateTimePair

object ( GclidDateTimePair )

gclid и дата и время преобразования.

orderId

string

Идентификатор заказа конверсии, которую необходимо скорректировать.

adjustmentType

enum ( ConversionAdjustmentType )

Тип регулировки.

conversionAction

string

Название ресурса действия-конверсии, связанного с этой корректировкой конверсий.

adjustmentDateTime

string

Дата и время, когда произошла корректировка. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00».