- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- CustomerSkAdNetworkConversionValueSchemaOperation
- CustomerSkAdNetworkConversionValueSchema
- SkAdNetworkConversionValueSchema
- FineGrainedConversionValueMappings
- ConversionValueMapping
- رویداد
- محدوده درآمد
- EventOccurrenceRange
- PostbackMapping
- CoarseGrainedConversionValueMappings
- MutateCustomerSkAdNetworkConversionValueSchemaResult
- آن را امتحان کنید!
CustomerSkAdNetworkConversionValueSchema را ایجاد یا به روز می کند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError FieldError InternalError MutateError
درخواست HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | شناسه مشتری که مجموعههای مشترک او در حال تغییر است. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"operation": {
object ( |
زمینه های | |
---|---|
operation | عملیات برای انجام. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
enableWarnings | اختیاری. اگر درست باشد، هشدارهای برگشتی را فعال می کند. اخطارها پیام های خطا و کدهای خطا را بدون مسدود کردن اجرای عملیات جهش باز می گرداند. |
بدن پاسخگو
پیام پاسخ برای customerSkAdNetworkConversionValueSchemas.mutate.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "result": { object ( |
زمینه های | |
---|---|
result | همه نتایج برای جهش. |
warning | خطاهای غیر مسدود کننده که جزئیات خرابی تأیید طرح را ارائه می دهد. فقط زمانی برگردانده می شود که enableWarnings = true باشد. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
CustomerSkAdNetworkConversionValueSchemaOperation
یک عملیات به روز رسانی واحد برای CustomerSkAdNetworkConversionValueSchema.
نمایندگی JSON |
---|
{
"update": {
object ( |
زمینه های | |
---|---|
update | عملیات بهروزرسانی: انتظار میرود طرحواره نام منبع معتبری داشته باشد. |
CustomerSkAdNetworkConversionValueSchema
یک CustomerSkAdNetworkConversionValueSchema.
نمایندگی JSON |
---|
{
"resourceName": string,
"schema": {
object ( |
زمینه های | |
---|---|
resourceName | فقط خروجی نام منبع طرحواره. نام منابع CustomerSkAdNetworkConversionValueSchema به این شکل است: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId} |
schema | فقط خروجی طرح واره برای منبع مشخص شده. |
SkAdNetworkConversionValueSchema
SkAdNetworkConversionValueSchema خاص CustomerLink.
نمایندگی JSON |
---|
{ "appId": string, "measurementWindowHours": integer, "fineGrainedConversionValueMappings": [ { object ( |
زمینه های | |
---|---|
appId | ضروری. فقط خروجی Apple App Store ID app. |
measurementWindowHours | فقط خروجی یک پنجره زمانی (برحسب ساعت اندازهگیری شده) پس از نصب، که پس از آن شریک Attribution App یا تبلیغکننده تماس updateConversionValue را متوقف میکند. |
fineGrainedConversionValueMappings[] | فقط خروجی نگاشتهای ارزش تبدیلی با دانه بندی ریز. برای نسخههای SkAdNetwork >= 4.0 که از پنجرههای تبدیل چندگانه پشتیبانی میکنند، نگاشتهای ارزش تبدیل با دانهریزی فقط برای اولین پسبازگشت قابل اعمال هستند. |
postbackMappings[] | فقط خروجی نگاشت ارزش تبدیل به ازای پسبازگشت برای پسبستها در چندین پنجره تبدیل. فقط برای نسخه های SkAdNetwork >= 4.0 قابل اجرا است. |
FineGrainedConversionValueMappings
نقشه برداری برای ارزش تبدیل دانه ریز.
نمایندگی JSON |
---|
{
"fineGrainedConversionValue": integer,
"conversionValueMapping": {
object ( |
زمینه های | |
---|---|
fineGrainedConversionValue | فقط خروجی ارزش تبدیل دانه ریز. مقادیر معتبر در محدوده شامل [0،63] هستند. |
conversionValueMapping | فقط خروجی رویدادهای تبدیلی که ارزش تبدیل ریزدانه به آن نگاشت می شود. |
ConversionValueMapping
نشان دهنده نقشه برداری از یک مقدار تبدیل به یک یا چند رویداد تبدیل است.
نمایندگی JSON |
---|
{
"minTimePostInstallHours": string,
"maxTimePostInstallHours": string,
"mappedEvents": [
{
object ( |
زمینه های | |
---|---|
minTimePostInstallHours | فقط خروجی حداقل بازه زمانی که کاربر آخرین بار در طول پنجره اندازه گیری فعال بوده است. |
maxTimePostInstallHours | فقط خروجی حداکثر بازه زمانی که کاربر آخرین بار در طول پنجره اندازه گیری فعال بوده است. |
mappedEvents[] | فقط خروجی مقدار تبدیل ممکن است به چندین رویداد با ویژگی های مختلف نگاشت شود. |
رویداد
یک رویداد تبدیل Google را تعریف می کند که ارزش تبدیل به آن نگاشت شده است.
نمایندگی JSON |
---|
{ "mappedEventName": string, "currencyCode": string, // Union field |
زمینه های | |
---|---|
mappedEventName | فقط خروجی نام رویداد Google با این مقدار تبدیل نشان داده شده است. |
currencyCode | فقط خروجی ارز گزارش شده برای event_revenue. کد ارز سه حرفی ISO 4217، به عنوان مثال، "USD" |
revenue_rate میدان اتحادیه . محدوده یا مقدار خاصی برای درآمد رویداد. revenue_rate فقط می تواند یکی از موارد زیر باشد: | |
eventRevenueRange | فقط خروجی محدوده درآمد رویداد |
eventRevenueValue | فقط خروجی ارزش درآمد رویداد خاص |
event_rate میدان اتحادیه یک محدوده یا مقدار خاصی برای شمارنده رویداد. event_rate فقط می تواند یکی از موارد زیر باشد: | |
eventOccurrenceRange | فقط خروجی محدوده شمارنده رویداد. |
eventCounter | فقط خروجی برای مقادیر شمارنده رویداد خاص. |
محدوده درآمد
محدوده ای را برای مقادیر درآمد تعریف می کند.
نمایندگی JSON |
---|
{ "minEventRevenue": number, "maxEventRevenue": number } |
زمینه های | |
---|---|
minEventRevenue | فقط خروجی برای محدوده درآمد، حداقل مقدار در |
maxEventRevenue | فقط خروجی برای محدوده درآمد، حداکثر مقدار در |
EventOccurrenceRange
محدوده ای را برای مقادیر شمارنده رویداد تعریف می کند.
نمایندگی JSON |
---|
{ "minEventCount": string, "maxEventCount": string } |
زمینه های | |
---|---|
minEventCount | فقط خروجی برای محدوده شمارنده رویداد، حداقل محدوده تعریف شده. مقدار 0 به عنوان تنظیم نشده در نظر گرفته می شود. |
maxEventCount | فقط خروجی برای محدوده های شمارنده رویداد، حداکثر محدوده تعریف شده. مقدار 0 به عنوان تنظیم نشده در نظر گرفته می شود. |
PostbackMapping
نقشه برداری برای هر پس بک در چندین پنجره تبدیل.
نمایندگی JSON |
---|
{ "postbackSequenceIndex": integer, "coarseGrainedConversionValueMappings": { object ( |
زمینه های | |
---|---|
postbackSequenceIndex | فقط خروجی شاخص مبتنی بر 0 که نشان دهنده ترتیب پسبازگشت است. مقادیر معتبر در محدوده شامل [0،2] هستند. |
coarseGrainedConversionValueMappings | فقط خروجی نگاشت ارزش تبدیل برای همه مقادیر تبدیل دانه درشت. |
فیلد اتحادیه lock_window_trigger . رویداد یا مقدار تبدیل مورد استفاده برای قفل کردن پنجره تبدیل. lock_window_trigger تنها می تواند یکی از موارد زیر باشد: | |
lockWindowCoarseConversionValue | فقط خروجی مقدار تبدیل دانه درشت که باعث قفل پنجره تبدیل می شود. |
lockWindowFineConversionValue | فقط خروجی ارزش تبدیل ریز دانه که باعث قفل پنجره تبدیل می شود. |
lockWindowEvent | فقط خروجی نام رویدادی که قفل پنجره تبدیل را فعال میکند. |
CoarseGrainedConversionValueMappings
نقشه برداری برای مقادیر تبدیل دانه درشت.
نمایندگی JSON |
---|
{ "lowConversionValueMapping": { object ( |
زمینه های | |
---|---|
lowConversionValueMapping | فقط خروجی نقشه برداری برای ارزش تبدیل درشت "کم". |
mediumConversionValueMapping | فقط خروجی نقشه برداری برای مقدار تبدیل درشت "متوسط". |
highConversionValueMapping | فقط خروجی نقشه برداری برای ارزش تبدیل درشت "بالا". |
MutateCustomerSkAdNetworkConversionValueSchemaResult
نتیجه جهش CustomerSkAdNetworkConversionValueSchema.
نمایندگی JSON |
---|
{ "resourceName": string, "appId": string } |
زمینه های | |
---|---|
resourceName | نام منبع مشتری که اصلاح شد. |
appId | شناسه برنامه SkanConversionValue اصلاح شد. |