- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- CustomerSkAdNetworkConversionValueSchemaOperation
- CustomerSkAdNetworkConversionValueSchema
- SkAdNetworkConversionValueSchema
- FineGrainedConversionValueMappings
- ConversionValueMapping
- Sự kiện
- RevenueRange
- EventOccurrenceRange
- PostbackMapping
- CoarseGrainedConversionValueMappings
- MutateCustomerSkAdNetworkConversionValueSchemaResult
- Hãy làm thử!
Tạo hoặc cập nhật CustomerSkAdNetworkConvertValueSchema.
Danh sách các lỗi được gửi: AuthenticationError AuthorizationError FieldError InternalError MutateError
Yêu cầu HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
customerId |
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 ( |
Trường | |
---|---|
operation |
Thao tác cần thực hiện. |
validateOnly |
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 chứ không phải kết quả. |
enableWarnings |
Không bắt buộc. Nếu đúng, cho phép trả về 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 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 ( |
Trường | |
---|---|
result |
Tất cả kết quả về biến đổi. |
warning |
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ỉ trả về khi enableCảnh báo = đúng. |
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 bài viết Tổng quan về OAuth 2.0.
CustomerSkAdNetworkConversionValueSchemaOperation
Một thao tác cập nhật duy nhất cho CustomerSkAdNetworkConversionValueSchema.
Biểu diễn dưới dạng JSON |
---|
{
"update": {
object ( |
Trường | |
---|---|
update |
Thao tác cập nhật: Giản đồ dự kiến sẽ có tên tài nguyên hợp lệ. |
CustomerSkAdNetworkConversionValueSchema
Lược đồ CustomerSkAdNetworkConversionValue.
Biểu diễn dưới dạng JSON |
---|
{
"resourceName": string,
"schema": {
object ( |
Trường | |
---|---|
resourceName |
Chỉ có đầu ra. Tên tài nguyên của giản đồ. Tên tài nguyên CustomerSkAdNetworkConversionValueSchema có dạng: customer/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId} |
schema |
Chỉ có đầu ra. Giản đồ cho tài nguyên được chỉ định. |
SkAdNetworkConversionValueSchema
SkAdNetworkConversionValueSchema cụ thể của CustomerLink.
Biểu diễn dưới dạng JSON |
---|
{ "appId": string, "measurementWindowHours": integer, "fineGrainedConversionValueMappings": [ { object ( |
Trường | |
---|---|
appId |
Bắt buộc. Chỉ có đầu ra. Mã ứng dụng trong Apple App Store. |
measurementWindowHours |
Chỉ có đầu ra. Một khoảng thời gian (được đo 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[] |
Chỉ có đầu ra. Liên kết giá trị lượt chuyển đổi chi tiết. Đối với các phiên bản SkAdNetwork >= 4.0 hỗ trợ nhiều khoảng thời gian chuyển đổi, chỉ áp dụng việc liên kết giá trị lượt chuyển đổi chi tiết cho hệ thống đăng lại đầu tiên. |
postbackMappings[] |
Chỉ có đầu ra. Liên kết giá trị lượt chuyển đổi trên mỗi lượt đăng lại đối với hệ thống đăng lại trong nhiều khoảng thời gian chuyển đổi. Chỉ áp dụng cho các phiên bản SkAdNetwork >= 4.0. |
FineGrainedConversionValueMappings
Liên kết giá trị lượt chuyển đổi chi tiết.
Biểu diễn dưới dạng JSON |
---|
{
"fineGrainedConversionValue": integer,
"conversionValueMapping": {
object ( |
Trường | |
---|---|
fineGrainedConversionValue |
Chỉ có đầu ra. Giá trị lượt chuyển đổi chi tiết. Các giá trị hợp lệ nằm trong phạm vi bao gồm [0,63]. |
conversionValueMapping |
Chỉ có đầu ra. Các sự kiện chuyển đổi mà giá trị chuyển đổi chi tiết liên kết đến. |
ConversionValueMapping
Biểu thị mối liên kết từ một giá trị lượt chuyển đổi với 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 ( |
Trường | |
---|---|
minTimePostInstallHours |
Chỉ có đầu ra. Khoảng thời gian tối thiểu mà một người dùng hoạt động lần gần đây nhất trong khoảng thời gian đo lường. |
maxTimePostInstallHours |
Chỉ có đầu ra. Khoảng thời gian tối đa mà một người dùng hoạt động gần đây nhất trong khoảng thời gian đo lường. |
mappedEvents[] |
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 bằng nhiều thuộc tính. |
Sự kiện
Xác định một sự kiện chuyển đổi trên Google mà giá trị lượt chuyển đổi được liên kết.
Biểu diễn dưới dạng JSON |
---|
{ "mappedEventName": string, "currencyCode": string, // Union field |
Trường | |
---|---|
mappedEventName |
Chỉ có đầu ra. Tên sự kiện trên Google được thể hiện bằng giá trị lượt chuyển đổi này. |
currencyCode |
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 kết hợp revenue_rate . Có thể là 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 đây: |
|
eventRevenueRange |
Chỉ có đầu ra. Phạm vi doanh thu từ sự kiện. |
eventRevenueValue |
Chỉ có đầu ra. Giá trị doanh thu cụ thể của sự kiện. |
Trường kết hợp event_rate . Một phạm vi 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 đây: |
|
eventOccurrenceRange |
Chỉ có đầu ra. Phạm vi bộ đếm sự kiện. |
eventCounter |
Chỉ có đầu ra. Đối với 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 |
Chỉ có đầu ra. Đối với phạm vi doanh thu, giá trị tối thiểu trong |
maxEventRevenue |
Chỉ có đầu ra. Đối với phạm vi doanh thu, giá trị tối đa trong |
EventOccurrenceRange
Xác định phạm vi 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 |
Chỉ có đầu ra. Đối với phạm vi của bộ đếm sự kiện, giá trị tối thiểu của phạm vi đã xác định. Giá trị 0 sẽ được coi là chưa đặt. |
maxEventCount |
Chỉ có đầu ra. Đối với phạm vi của bộ đếm sự kiện, giá trị tối đa là phạm vi đã xác định. Giá trị 0 sẽ được coi là chưa đặ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 ( |
Trường | |
---|---|
postbackSequenceIndex |
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 phạm vi [0,2]. |
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 tương đối. |
Trường kết 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 đây: |
|
lockWindowCoarseConversionValue |
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. |
lockWindowFineConversionValue |
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 |
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 các giá trị lượt chuyển đổi chi tiết.
Biểu diễn dưới dạng JSON |
---|
{ "lowConversionValueMapping": { object ( |
Trường | |
---|---|
lowConversionValueMapping |
Chỉ có đầu ra. Liên kết giá trị lượt chuyển đổi tương đối "thấp". |
mediumConversionValueMapping |
Chỉ có đầu ra. Liên kết giá trị lượt chuyển đổi tương đối "trung bình". |
highConversionValueMapping |
Chỉ có đầu ra. Liên kết giá trị lượt chuyển đổi tương đối "cao". |
MutateCustomerSkAdNetworkConversionValueSchemaResult
Kết quả cho việc thay đổi CustomerSkAdNetworkConversionValueSchema.
Biểu diễn dưới dạng JSON |
---|
{ "resourceName": string, "appId": string } |
Trường | |
---|---|
resourceName |
Tên tài nguyên của khách hàng đã được sửa đổi. |
appId |
Mã ứng dụng của SkanConversionValue đã sửa đổi. |