Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Tạo hoặc cập nhật CustomerSkAdNetworkConversionValueSchema.

Danh sách các lỗi đã gửi: AuthenticationError AuthorizationError FieldError InternalError MutateError

Yêu cầu HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
customerId

string

Mã của khách hàng có các nhóm chia sẻ đang được sửa đổi.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean,
  "enableWarnings": boolean
}
Trường
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Thao tác thực hiện.
validateOnly

boolean

Nếu đúng, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ trả về lỗi, không trả về kết quả.
enableWarnings

boolean

Không bắt buộc. Nếu giá trị này là true, thì hệ thống sẽ cho phép trả lại cảnh báo. Cảnh báo trả về thông báo lỗi và mã lỗi mà không chặn việc thực thi thao tác thay đổi.

Nội dung phản hồi

Thông báo phản hồi cho customerSkAdNetworkConversionValueSchemas.mutate.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
Trường
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Tất cả kết quả cho trường hợp thay đổi.
warning

object (Status)

Lỗi không chặn cung cấp thông tin chi tiết về lỗi xác thực giản đồ. Chỉ được trả về khi enableWarnings = true.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Một thao tác cập nhật cho CustomerSkAdNetworkConversionValueSchema.

Biểu diễn dưới dạng JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Trường
update

object (CustomerSkAdNetworkConversionValueSchema)

Thao tác cập nhật: Giản đồ dự kiến sẽ có tên tài nguyên hợp lệ.

CustomerSkAdNetworkConversionValueSchema

Giản đồ CustomerSkAdNetworkConversionValue.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của giản đồ. Tên tài nguyên CustomerSkAdNetworkConversionValueSchema có dạng: khách hàng/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

Chỉ có đầu ra. Giản đồ cho tài nguyên được chỉ định.

SkAdNetworkConversionValueSchema

Giản đồ SkAdNetworkChuyển đổi giá trị chuyển đổi cụ thể của CustomerLink.

Biểu diễn dưới dạng JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
Trường
appId

string

Bắt buộc. Chỉ có đầu ra. Mã ứng dụng trên App Store của Apple.
measurementWindowHours

integer

Chỉ có đầu ra. Một khoảng thời gian (được tính bằng giờ) sau khi cài đặt, sau đó Đối tác phân bổ ứng dụng hoặc nhà quảng cáo ngừng gọi updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Chỉ có đầu ra. Liên kết chi tiết giá trị lượt chuyển đổi. Đối với phiên bản SkAdNetwork >= 4.0 có hỗ trợ nhiều khoảng thời gian chuyển đổi, mối liên kết chi tiết về giá trị lượt chuyển đổi chỉ áp dụng cho hệ thống đăng lại đầu tiên.
postbackMappings[]

object (PostbackMapping)

Chỉ có đầu ra. Liên kết giá trị lượt chuyển đổi trên mỗi lượt đăng lại cho hệ thống đăng lại trong nhiều khoảng thời gian chuyển đổi. Chỉ áp dụng cho phiên bản SkAdNetwork >= 4.0.

FineGrainedConversionValueMappings

Thông tin liên kết cho giá trị lượt chuyển đổi chi tiết.

Biểu diễn dưới dạng JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Trường
fineGrainedConversionValue

integer

Chỉ có đầu ra. Giá trị chuyển đổi chi tiết. Các giá trị hợp lệ nằm trong khoảng [0,63].
conversionValueMapping

object (ConversionValueMapping)

Chỉ có đầu ra. Sự kiện chuyển đổi được liên kết với giá trị chuyển đổi chi tiết.

ConversionValueMapping

Thể hiện mối liên kết từ một giá trị lượt chuyển đổi đến một hoặc nhiều sự kiện chuyển đổi.

Biểu diễn dưới dạng JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Trường
minTimePostInstallHours

string (int64 format)

Chỉ có đầu ra. Khoảng thời gian tối thiểu mà người dùng hoạt động lần gần đây nhất trong khoảng thời gian đo lường.
maxTimePostInstallHours

string (int64 format)

Chỉ có đầu ra. Khoảng thời gian tối đa mà người dùng hoạt động lần gần đây nhất trong khoảng thời gian đo lường.
mappedEvents[]

object (Event)

Chỉ có đầu ra. Giá trị lượt chuyển đổi có thể được liên kết với nhiều sự kiện có nhiều thuộc tính.

Sự kiện

Xác định một sự kiện chuyển đổi trên Google liên kết với giá trị lượt chuyển đổi.

Biểu diễn dưới dạng JSON 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
Trường
mappedEventName

string

Chỉ có đầu ra. Tên sự kiện của Google được thể hiện bằng giá trị lượt chuyển đổi này.
currencyCode

string

Chỉ có đầu ra. Đơn vị tiền tệ được báo cáo cho event_revenue. Mã đơn vị tiền tệ gồm ba chữ cái theo ISO 4217, ví dụ: "USD"
Trường hợp revenue_rate. Phạm vi hoặc giá trị cụ thể cho doanh thu từ sự kiện. revenue_rate chỉ có thể là một trong những trạng thái sau:
eventRevenueRange

object (RevenueRange)

Chỉ có đầu ra. Phạm vi doanh thu từ sự kiện.
eventRevenueValue

number

Chỉ có đầu ra. Giá trị doanh thu cụ thể từ sự kiện.
Trường hợp event_rate. Dải ô hoặc giá trị cụ thể cho bộ đếm sự kiện. event_rate chỉ có thể là một trong những trạng thái sau:
eventOccurrenceRange

object (EventOccurrenceRange)

Chỉ có đầu ra. Phạm vi bộ đếm sự kiện.
eventCounter

string (int64 format)

Chỉ có đầu ra. Dành cho các giá trị bộ đếm sự kiện cụ thể.

RevenueRange

Xác định phạm vi cho các giá trị doanh thu.

Biểu diễn dưới dạng JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Trường
minEventRevenue

number

Chỉ có đầu ra. Đối với phạm vi doanh thu, giá trị tối thiểu trong currencyCode mà giá trị lượt chuyển đổi này sẽ được cập nhật. Giá trị 0 sẽ được coi là chưa được đặt.
maxEventRevenue

number

Chỉ có đầu ra. Đối với phạm vi doanh thu, giá trị tối đa trong currencyCode mà giá trị lượt chuyển đổi này sẽ được cập nhật. Giá trị 0 sẽ được coi là chưa được đặt.

EventOccurrenceRange

Xác định một dải ô cho các giá trị bộ đếm sự kiện.

Biểu diễn dưới dạng JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
Trường
minEventCount

string (int64 format)

Chỉ có đầu ra. Đối với phạm vi bộ đếm sự kiện, giá trị tối thiểu của dải ô xác định. Giá trị 0 sẽ được coi là chưa được đặt.
maxEventCount

string (int64 format)

Chỉ có đầu ra. Đối với phạm vi bộ đếm sự kiện, giá trị tối đa của phạm vi xác định. Giá trị 0 sẽ được coi là chưa được đặt.

PostbackMapping

Liên kết cho từng hệ thống đăng lại trong nhiều khoảng thời gian chuyển đổi.

Biểu diễn dưới dạng JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
Trường
postbackSequenceIndex

integer

Chỉ có đầu ra. Chỉ mục dựa trên 0 cho biết thứ tự đăng lại. Các giá trị hợp lệ nằm trong khoảng [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Chỉ có đầu ra. Liên kết giá trị lượt chuyển đổi cho tất cả giá trị lượt chuyển đổi thô.
Trường hợp lock_window_trigger. Sự kiện hoặc giá trị lượt chuyển đổi được dùng để khoá khoảng thời gian chuyển đổi. lock_window_trigger chỉ có thể là một trong những trạng thái sau:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Chỉ có đầu ra. Giá trị lượt chuyển đổi thô kích hoạt khoá khoảng thời gian chuyển đổi.
lockWindowFineConversionValue

integer

Chỉ có đầu ra. Giá trị lượt chuyển đổi chi tiết kích hoạt khoá khoảng thời gian chuyển đổi.
lockWindowEvent

string

Chỉ có đầu ra. Tên sự kiện kích hoạt khoá khoảng thời gian chuyển đổi.

CoarseGrainedConversionValueMappings

Liên kết cho các giá trị chuyển đổi thô.

Biểu diễn dưới dạng JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Trường
lowConversionValueMapping

object (ConversionValueMapping)

Chỉ có đầu ra. Mối liên kết cho giá trị lượt chuyển đổi thô "thấp".
mediumConversionValueMapping

object (ConversionValueMapping)

Chỉ có đầu ra. Mối liên kết cho giá trị lượt chuyển đổi thô "trung bình".
highConversionValueMapping

object (ConversionValueMapping)

Chỉ có đầu ra. Mối liên kết cho giá trị lượt chuyển đổi thô "cao".

MutateCustomerSkAdNetworkConversionValueSchemaResult

Kết quả cho thay đổi CustomerSkAdNetworkConversionValueSchema.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "appId": string
}
Trường
resourceName

string

Tên tài nguyên của khách hàng đã được sửa đổi.
appId

string

Đã sửa đổi mã ứng dụng của SkanConversionValue.