- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- CallConversion
- CallConversionResult
- Попробуй это!
Обрабатывает данные конверсии вызовов.
Список выброшенных ошибок: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента, выполняющего загрузку. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"conversions": [
{
object ( |
Поля | |
---|---|
conversions[] | Необходимый. Конверсии, которые загружаются. |
partialFailure | Необходимый. Если это правда, будут выполнены успешные операции, а недопустимые операции вернут ошибки. Если false, все операции будут выполняться за одну транзакцию тогда и только тогда, когда все они действительны. Для этого параметра всегда должно быть установлено значение true. Дополнительную информацию о частичном сбое см. на странице https://developers.google.com/google-ads/api/docs/best-practices/partial-failures . |
validateOnly | Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты. |
Тело ответа
Ответное сообщение для ConversionUploadService.UploadCallConversions
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "partialFailureError": { object ( |
Поля | |
---|---|
partialFailureError | Ошибки, связанные со сбоями преобразования в режиме частичного сбоя. Возвращается, когда внутри преобразований возникают все ошибки. Если возникают какие-либо ошибки вне преобразований (например, ошибки аутентификации), мы возвращаем ошибку уровня RPC. Дополнительную информацию о частичном сбое см. на странице https://developers.google.com/google-ads/api/docs/best-practices/partial-failures . |
results[] | Возвращается для успешно обработанных конверсий. Proto будет пустым для строк, получивших ошибку. Результаты не возвращаются, если validateOnly имеет значение true. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
CallConversion
Конверсия звонка.
JSON-представление |
---|
{ "customVariables": [ { object ( |
Поля | |
---|---|
customVariables[] | Пользовательские переменные, связанные с этим преобразованием. |
consent | Настройка согласия для события. |
callerId | Идентификатор вызывающего абонента, от которого был совершен этот звонок. Ожидается, что идентификатор вызывающего абонента будет в формате E.164 со знаком «+», например «+16502531234». |
callStartDateTime | Дата и время, когда произошел звонок. Часовой пояс должен быть указан. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00». |
conversionAction | Название ресурса действия-конверсии, связанного с этой конверсией. Примечание. Хотя имя этого ресурса состоит из идентификатора клиента и идентификатора действия-конверсии, при проверке идентификатор клиента будет игнорироваться, а идентификатор действия-конверсии будет использоваться в качестве единственного идентификатора действия-конверсии. |
conversionDateTime | Дата и время, когда произошло преобразование. Должно быть, после времени звонка. Часовой пояс должен быть указан. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00». |
conversionValue | Ценность конверсии для рекламодателя. |
currencyCode | Валюта, связанная со стоимостью конверсии. Это трехзначный код валюты ISO 4217. Например: доллар США, евро. |
CallConversionResult
Идентифицирующая информация для успешно обработанного CallConversionUpload.
JSON-представление |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
Поля | |
---|---|
callerId | Идентификатор вызывающего абонента, от которого был совершен этот звонок. Ожидается, что идентификатор вызывающего абонента будет в формате E.164 с предшествующим знаком «+». |
callStartDateTime | Дата и время, когда произошел звонок. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00». |
conversionAction | Название ресурса действия-конверсии, связанного с этой конверсией. |
conversionDateTime | Дата и время, когда произошло преобразование. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00». |