Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

יוצר או מעדכן את CustomerSkAdNetworkConversionValueSchema.

רשימה של שגיאות הטמעה: AuthenticationError AuthorizationError FieldError InternalError MutateError

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

המזהה של הלקוח שמתבצע שינוי בקבוצות המשותפות שלו.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
שדות
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

הפעולה שצריך לבצע.
validateOnly

boolean

אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות.

גוף התגובה

הודעת תגובה ל-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

A CustomerSkAdNetworkConversionValueSchema.

ייצוג JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
שדות
resourceName

string

פלט בלבד. שם המשאב של הסכימה. הפורמט של שמות המשאבים CustomerSkAdNetworkConversionValueSchema הוא: customer/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

פלט בלבד. הסכימה של המשאב שצוין.

SkAdNetworkConversionValueSchema

SkAdNetworkConversionValueSchema הספציפי ל-CustomerLink.

ייצוג JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
שדות
appId

string

חובה. פלט בלבד. מזהה האפליקציה ב-Apple App Store.
measurementWindowHours

integer

פלט בלבד. חלון זמן (שנמדד בשעות) אחרי ההתקנה, ולאחר מכן שותף דוחות השיוך לקמפיינים של האפליקציה או המפרסם יפסיקו לבצע קריאה ל-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)

פלט בלבד. לערכי מונה ספציפיים לאירועים.

RevenueRange

הגדרת טווח לערכי הכנסה.

ייצוג 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 השתנה.