Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

CustomerSkAdNetworkConversionValueSchema را ایجاد یا به روز می کند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError FieldError InternalError MutateError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

شناسه مشتری که مجموعه‌های مشترک او در حال تغییر است.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
زمینه های
operation

object ( CustomerSkAdNetworkConversionValueSchemaOperation )

عملیات برای انجام.

validateOnly

boolean

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج.

بدن پاسخگو

پیام پاسخ برای customerSkAdNetworkConversionValueSchemas.mutate.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
زمینه های
result

object ( MutateCustomerSkAdNetworkConversionValueSchemaResult )

همه نتایج برای جهش.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

CustomerSkAdNetworkConversionValueSchemaOperation

یک عملیات به روز رسانی واحد برای CustomerSkAdNetworkConversionValueSchema.

نمایندگی JSON
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
زمینه های
update

object ( CustomerSkAdNetworkConversionValueSchema )

عملیات به‌روزرسانی: انتظار می‌رود طرحواره نام منبع معتبری داشته باشد.

CustomerSkAdNetworkConversionValueSchema

یک CustomerSkAdNetworkConversionValueSchema.

نمایندگی JSON
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
زمینه های
resourceName

string

فقط خروجی نام منبع طرحواره. نام منابع CustomerSkAdNetworkConversionValueSchema به این شکل است: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}

schema

object ( SkAdNetworkConversionValueSchema )

فقط خروجی طرح واره برای منبع مشخص شده.

SkAdNetworkConversionValueSchema

SkAdNetworkConversionValueSchema خاص CustomerLink.

نمایندگی JSON
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
زمینه های
appId

string

ضروری. فقط خروجی Apple App Store ID app.

measurementWindowHours

integer

فقط خروجی یک پنجره زمانی (برحسب ساعت اندازه‌گیری شده) پس از نصب، که پس از آن شریک Attribution App یا تبلیغ‌کننده تماس updateConversionValue را متوقف می‌کند.

fineGrainedConversionValueMappings[]

object ( FineGrainedConversionValueMappings )

فقط خروجی نگاشتهای ارزش تبدیلی با دانه بندی ریز.

FineGrainedConversionValueMappings

نقشه برداری برای ارزش تبدیل دانه ریز.

نمایندگی JSON
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
زمینه های
fineGrainedConversionValue

integer

فقط خروجی ارزش تبدیل دانه ریز. مقادیر معتبر در محدوده شامل [0،63] هستند.

conversionValueMapping

object ( ConversionValueMapping )

فقط خروجی رویدادهای تبدیلی که ارزش تبدیل ریزدانه به آن نگاشت می شود.

ConversionValueMapping

نشان دهنده نقشه برداری از یک مقدار تبدیل به یک یا چند رویداد تبدیل است.

نمایندگی JSON
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
زمینه های
minTimePostInstallHours

string ( int64 format)

فقط خروجی حداقل بازه زمانی که کاربر آخرین بار در طول پنجره اندازه گیری فعال بوده است.

maxTimePostInstallHours

string ( int64 format)

فقط خروجی حداکثر بازه زمانی که کاربر آخرین بار در طول پنجره اندازه گیری فعال بوده است.

mappedEvents[]

object ( Event )

فقط خروجی مقدار تبدیل ممکن است به چندین رویداد با ویژگی های مختلف نگاشت شود.

رویداد

یک رویداد تبدیل Google را تعریف می کند که ارزش تبدیل به آن نگاشت شده است.

نمایندگی 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.
}
زمینه های
mappedEventName

string

فقط خروجی نام رویداد Google با این مقدار تبدیل نشان داده شده است.

currencyCode

string

فقط خروجی ارز گزارش شده برای event_revenue. کد ارز سه حرفی ISO 4217، به عنوان مثال، "USD"

revenue_rate میدان اتحادیه محدوده یا مقدار خاصی برای درآمد رویداد. revenue_rate فقط می تواند یکی از موارد زیر باشد:
eventRevenueRange

object ( RevenueRange )

فقط خروجی محدوده درآمد رویداد

eventRevenueValue

number

فقط خروجی ارزش درآمد رویداد خاص

event_rate میدان اتحادیه یک محدوده یا مقدار خاصی برای شمارنده رویداد. event_rate فقط می تواند یکی از موارد زیر باشد:
eventOccurrenceRange

object ( EventOccurrenceRange )

فقط خروجی محدوده شمارنده رویداد.

eventCounter

string ( int64 format)

فقط خروجی برای مقادیر شمارنده رویداد خاص.

محدوده درآمد

محدوده ای را برای مقادیر درآمد تعریف می کند.

نمایندگی JSON
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
زمینه های
minEventRevenue

number

فقط خروجی برای محدوده درآمد، حداقل مقدار در currencyCode که این مقدار تبدیل برای آن به‌روزرسانی می‌شود. مقدار 0 به عنوان تنظیم نشده در نظر گرفته می شود.

maxEventRevenue

number

فقط خروجی برای محدوده درآمد، حداکثر مقدار در currencyCode که این مقدار تبدیل برای آن به‌روزرسانی می‌شود. مقدار 0 به عنوان تنظیم نشده در نظر گرفته می شود.

EventOccurrenceRange

محدوده ای را برای مقادیر شمارنده رویداد تعریف می کند.

نمایندگی JSON
{
  "minEventCount": string,
  "maxEventCount": string
}
زمینه های
minEventCount

string ( int64 format)

فقط خروجی برای محدوده شمارنده رویداد، حداقل محدوده تعریف شده. مقدار 0 به عنوان تنظیم نشده در نظر گرفته می شود.

maxEventCount

string ( int64 format)

فقط خروجی برای محدوده های شمارنده رویداد، حداکثر محدوده تعریف شده. مقدار 0 به عنوان تنظیم نشده در نظر گرفته می شود.

MutateCustomerSkAdNetworkConversionValueSchemaResult

نتیجه جهش CustomerSkAdNetworkConversionValueSchema.

نمایندگی JSON
{
  "resourceName": string,
  "appId": string
}
زمینه های
resourceName

string

نام منبع مشتری که اصلاح شد.

appId

string

شناسه برنامه SkanConversionValue اصلاح شد.