- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Корректировка конверсии
- GclidDateTimePair
- Тип корректировки конверсии
- ПереформулированиеЗначения
- Результат корректировки конверсии
- Попробуй это!
Обрабатывает заданные корректировки преобразования.
Список выброшенных ошибок: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadConversionAdjustments
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента, выполняющего загрузку. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"conversionAdjustments": [
{
object ( |
Поля | |
---|---|
conversionAdjustments[] | Необходимый. Корректировки конверсий, которые загружаются. |
partialFailure | Необходимый. Если это правда, будут выполнены успешные операции, а недопустимые операции вернут ошибки. Если false, все операции будут выполняться за одну транзакцию тогда и только тогда, когда все они действительны. Для этого параметра всегда должно быть установлено значение true. Дополнительную информацию о частичном сбое см. на странице https://developers.google.com/google-ads/api/docs/best-practices/partial-failures . |
validateOnly | Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты. |
jobId | Необязательный. Дополнительный ввод для установки идентификатора задания. Должно быть неотрицательное число меньше 2^31, если оно указано. Если это поле не указано, API сгенерирует идентификатор задания в диапазоне [2^31, (2^63)-1]. API вернет значение для этого запроса в поле |
Тело ответа
Ответное сообщение для ConversionAdjustmentUploadService.UploadConversionAdjustments
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "partialFailureError": { object ( |
Поля | |
---|---|
partialFailureError | Ошибки, связанные с ошибками корректировки преобразования в режиме частичного отказа. Возвращается, когда в настройках происходят все ошибки. Если возникают какие-либо ошибки вне настроек (например, ошибки аутентификации), мы возвращаем ошибку уровня RPC. Дополнительную информацию о частичном сбое см. на странице https://developers.google.com/google-ads/api/docs/best-practices/partial-failures . |
results[] | Возвращается для успешно обработанных корректировок конверсий. Proto будет пустым для строк, получивших ошибку. Результаты не возвращаются, если validateOnly имеет значение true. |
jobId | Идентификатор задания для пакета загрузки. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
Корректировка конверсии
Корректировка конверсии.
JSON-представление |
---|
{ "gclidDateTimePair": { object ( |
Поля | |
---|---|
gclidDateTimePair | Для корректировок уникально идентифицирует конверсию, о которой сообщалось без указания идентификатора заказа. Если параметр корректировки имеет значение ENHANCEMENT, это значение является необязательным, но может быть установлено в дополнение к orderId. |
adjustmentType | Тип регулировки. |
restatementValue | Информация, необходимая для переоценки ценности конверсии. Требуется для пересчета. Не следует поставлять для ретракций. Если предусмотрен отзыв, будет возвращена ошибка. ПРИМЕЧАНИЕ. Если вы хотите загрузить второй пересчет с другим скорректированным значением, он должен иметь новое, более позднее время возникновения корректировки. В противном случае оно будет рассматриваться как дубликат предыдущего переформулирования и игнорироваться. |
userIdentifiers[] | Идентификаторы пользователей для улучшения исходной конверсии. ConversionAdjustmentUploadService принимает только идентификаторы пользователей в улучшениях. Максимальное количество идентификаторов пользователей для каждого расширения — 5. |
orderId | Идентификатор заказа конверсии, которую необходимо скорректировать. Если о конверсии сообщалось с указанным идентификатором заказа, этот идентификатор необходимо использовать здесь в качестве идентификатора. Идентификатор заказа необходим для улучшений. |
conversionAction | Название ресурса действия-конверсии, связанного с этой корректировкой конверсий. Примечание. Хотя имя этого ресурса состоит из идентификатора клиента и идентификатора действия-конверсии, при проверке идентификатор клиента будет игнорироваться, а идентификатор действия-конверсии будет использоваться в качестве единственного идентификатора действия-конверсии. |
adjustmentDateTime | Дата и время, когда произошла корректировка. Должно быть после конверсииDateTime. Часовой пояс должен быть указан. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00». |
userAgent | Пользовательский агент для улучшения исходного преобразования. Это можно найти в заголовке HTTP-запроса вашего пользователя, когда он совершает конверсию на вашей веб-странице. Пример: «Mozilla/5.0 (iPhone; процессор iPhone OS 12_2, например Mac OS X)». Пользовательский агент можно указать только в расширениях с идентификаторами пользователей. Он должен соответствовать пользовательскому агенту запроса, отправившего исходное преобразование, поэтому преобразование и его улучшение либо атрибутируются как одно и то же устройство, либо оба атрибутируются как перекрестное преобразование. |
GclidDateTimePair
Уникально идентифицирует конверсию, о которой сообщалось без указания идентификатора заказа.
JSON-представление |
---|
{ "gclid": string, "conversionDateTime": string } |
Поля | |
---|---|
gclid | Идентификатор клика Google (gclid), связанный с исходной конверсией для этой корректировки. |
conversionDateTime | Дата и время, когда произошла исходная конверсия для этой корректировки. Часовой пояс должен быть указан. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00». |
Тип корректировки конверсии
Рекламодатели могут предпринять различные действия для корректировки конверсий, о которых они уже сообщили. Отзыв сводит на нет конверсию. Пересчеты меняют ценность конверсии.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Представляет значение, неизвестное в этой версии. |
RETRACTION | Отменяет преобразование, так что его общее значение и количество равны нулю. |
RESTATEMENT | Изменяет ценность конверсии. |
ENHANCEMENT | Дополняет существующую конверсию предоставленными идентификаторами пользователей и пользовательским агентом, которые Google может использовать для увеличения количества конверсий. |
ПереформулированиеЗначения
Содержит информацию, необходимую для переоценки ценности конверсии.
JSON-представление |
---|
{ "adjustedValue": number, "currencyCode": string } |
Поля | |
---|---|
adjustedValue | Пересчитанная ценность конверсии. Это стоимость конверсии после пересчета. Например, чтобы изменить ценность конверсии со 100 на 70, необходимо указать скорректированное значение 70. ПРИМЕЧАНИЕ. Если вы хотите загрузить второй пересчет с другим скорректированным значением, он должен иметь новое, более позднее время возникновения корректировки. В противном случае оно будет рассматриваться как дубликат предыдущего переформулирования и игнорироваться. |
currencyCode | Валюта пересчитанной стоимости. Если она не указана, используется валюта по умолчанию из действия-конверсии, а если она не задана, то используется валюта аккаунта. Это трехзначный код валюты ISO 4217, например, доллар США или евро. |
Результат корректировки конверсии
Информация, идентифицирующая успешно обработанную настройку ConversionAdjustment.
JSON-представление |
---|
{ "gclidDateTimePair": { object ( |
Поля | |
---|---|
gclidDateTimePair | gclid и дата и время преобразования. |
orderId | Идентификатор заказа конверсии, которую необходимо скорректировать. |
adjustmentType | Тип регулировки. |
conversionAction | Название ресурса действия-конверсии, связанного с этой корректировкой конверсий. |
adjustmentDateTime | Дата и время, когда произошла корректировка. Формат: «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00». |