- 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 (Phạm vi doanh thu)
- EventOccurrenceRange
- MutateCustomerSkAdNetworkConversionValueSchemaResult
- Hãy làm thử!
Tạo hoặc cập nhật CustomerSkAdNetworkconversionValueSchema.
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/v14/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
customerId |
Mã của khách hàng có các nhóm dùng chung đ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 ( |
Các trường | |
---|---|
operation |
Thao tác cần thực hiện. |
validateOnly |
Nếu đúng thì yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ có lỗi được trả về, chứ không phải kết quả. |
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 ( |
Các trường | |
---|---|
result |
Tất cả kết quả cho biến đổi. |
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 duy nhất cho một CustomerSkAdNetworkconversionValueSchema.
Biểu diễn dưới dạng JSON |
---|
{
"update": {
object ( |
Các trường | |
---|---|
update |
Thao tác cập nhật: Giản đồ phải 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 ( |
Các 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
Giản đồ SkAdNetworkConversionValue cụ thể cho CustomerLink.
Biểu diễn dưới dạng JSON |
---|
{
"appId": string,
"measurementWindowHours": integer,
"fineGrainedConversionValueMappings": [
{
object ( |
Các trường | |
---|---|
appId |
Bắt buộc. Chỉ có đầu ra. Mã ứng dụng trên App Store của Apple. |
measurementWindowHours |
Chỉ có đầu ra. 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 sẽ ngừng gọi updateConversionValue. |
fineGrainedConversionValueMappings[] |
Chỉ có đầu ra. Liên kết giá trị lượt chuyển đổi chi tiết. |
FineGrainedConversionValueMappings
Liên kết cho giá trị chuyển đổi chi tiết.
Biểu diễn dưới dạng JSON |
---|
{
"fineGrainedConversionValue": integer,
"conversionValueMapping": {
object ( |
Các trường | |
---|---|
fineGrainedConversionValue |
Chỉ có đầu ra. Giá trị 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 tới. |
ConversionValueMapping
Biểu thị mối liên kết từ một giá trị 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 ( |
Các trường | |
---|---|
minTimePostInstallHours |
Chỉ có đầu ra. Phạm vi 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 |
Chỉ có đầu ra. Tối đa khoảng thời gian 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[] |
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 |
Các trường | |
---|---|
mappedEventName |
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 |
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 nhóm revenue_rate . Một phạm vi hoặc giá trị cụ thể cho doanh thu 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 của sự kiện. |
eventRevenueValue |
Chỉ có đầu ra. Giá trị doanh thu cụ thể từ sự kiện. |
Trường nhóm 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. Dành cho các giá trị bộ đếm sự kiện cụ thể. |
RevenueRange
Xác định phạm vi cho giá trị doanh thu.
Biểu diễn dưới dạng JSON |
---|
{ "minEventRevenue": number, "maxEventRevenue": number } |
Các 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 một 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 } |
Các trường | |
---|---|
minEventCount |
Chỉ có đầu ra. Đối với phạm vi bộ đếm sự kiện, giá trị tối thiểu của phạm vi được xác định. Giá trị 0 sẽ được coi là chưa được đặt. |
maxEventCount |
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 được xác định. Giá trị 0 sẽ được coi là chưa được đặt. |
MutateCustomerSkAdNetworkConversionValueSchemaResult
Kết quả cho thay đổi CustomerSkAdNetworkconversionValueSchema.
Biểu diễn dưới dạng JSON |
---|
{ "resourceName": string, "appId": string } |
Các trường | |
---|---|
resourceName |
Tên tài nguyên của khách hàng đã được sửa đổi. |
appId |
Đã sửa đổi mã ứng dụng của SkanConversionValue. |