Method: customers.uploadCallConversions

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

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

HTTP-запрос

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

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

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

Параметры
customerId

string

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

Тело запроса

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

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

object ( CallConversion )

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

partialFailure

boolean

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

validateOnly

boolean

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

Тело ответа

Ответное сообщение для ConversionUploadService.UploadCallConversions .

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

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

object ( Status )

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

results[]

object ( CallConversionResult )

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

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

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

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

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

CallConversion

Конверсия звонка.

JSON-представление
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Поля
customVariables[]

object ( CustomVariable )

Пользовательские переменные, связанные с этим преобразованием.

consent

object ( Consent )

Настройка согласия для события.

callerId

string

Идентификатор вызывающего абонента, от которого был совершен этот звонок. Ожидается, что идентификатор вызывающего абонента будет в формате E.164 со знаком «+», например «+16502531234».

callStartDateTime

string

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

conversionAction

string

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

conversionDateTime

string

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

conversionValue

number

Ценность конверсии для рекламодателя.

currencyCode

string

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

CallConversionResult

Идентифицирующая информация для успешно обработанного CallConversionUpload.

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

string

Идентификатор вызывающего абонента, от которого был совершен этот звонок. Ожидается, что идентификатор вызывающего абонента будет в формате E.164 с предшествующим знаком «+».

callStartDateTime

string

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

conversionAction

string

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

conversionDateTime

string

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