Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

יצירה או עדכון של CustomerSkAdNetworkConversionValueSchema.

רשימת שגיאות שנשלפו: AuthenticationError AuthorizationError FieldError InternalError MutateError

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

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

object (CustomerSkAdNetworkConversionValueSchemaOperation)

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

boolean

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

boolean

זה שינוי אופציונלי. אם True, מאפשרת החזרה של אזהרות. אזהרות מחזירות הודעות שגיאה וקודי שגיאה בלי לחסום את הביצוע של פעולת השינוי.

גוף התשובה

הודעת תגובה ל-customerSkAdNetworkConversionValueSchemas.mutate.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
שדות
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

כל התוצאות עבור השינוי.
warning

object (Status)

שגיאות שאינן חסימה שמספקות פרטים על הכשלים באימות הסכימה. מוחזר רק כאשר allowWarnings = true.

היקפי הרשאות

נדרש היקף ההרשאות הבא של 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)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
שדות
appId

string

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

integer

פלט בלבד. חלון זמן (שנמדד בשעות) אחרי ההתקנה, שאחריו שותף דוחות השיוך לקמפיינים של אפליקציה או המפרסם יפסיקו לבצע קריאה ל-updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

פלט בלבד. מיפויים מפורטים של ערכי המרות. בגרסאות SkAdNetwork >= 4.0 שתומכות בחלונות מרובים של המרות, מיפויים של ערכי המרות ברמת פירוט גבוהה רלוונטיים רק לדיווח חוזר על המרה (PostBack) הראשון.
postbackMappings[]

object (PostbackMapping)

פלט בלבד. מיפויים של ערכי המרות לכל דיווח חוזר על המרה (PostBack) במספר חלונות של המרות. רלוונטי רק לגרסאות SkAdNetwork >= 4.0.

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, המערכת תתייחס אליו כאל ערך לא מוגדר.

PostbackMapping

מיפויים לכל דיווח חוזר על המרה (PostBack) במספר חלונות של המרות.

ייצוג JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
שדות
postbackSequenceIndex

integer

פלט בלבד. אינדקס מבוסס 0 שמציין את סדר הדיווח החוזר על ההמרה. ערכים חוקיים הם בטווח הכולל [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

פלט בלבד. מיפויים של ערכי המרות לכל ערכי ההמרות בפירוט גס.
שדה איחוד lock_window_trigger. אירוע או ערך המרה שמשמשים לנעילת חלון ההמרות. lock_window_trigger יכול להיות רק אחד מהבאים:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

פלט בלבד. ערך המרה בפירוט גס שמפעיל את נעילת חלון ההמרות.
lockWindowFineConversionValue

integer

פלט בלבד. ערך המרה מפורט שמפעיל את נעילת חלון ההמרות.
lockWindowEvent

string

פלט בלבד. שם האירוע שמפעיל את נעילת חלון ההמרות.

CoarseGrainedConversionValueMappings

מיפויים של ערכי המרות בפירוט גס.

ייצוג JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
שדות
lowConversionValueMapping

object (ConversionValueMapping)

פלט בלבד. מיפוי של ערך המרה משוער 'נמוך'.
mediumConversionValueMapping

object (ConversionValueMapping)

פלט בלבד. מיפוי של ערך המרה משוער 'בינוני'.
highConversionValueMapping

object (ConversionValueMapping)

פלט בלבד. מיפוי של ערך המרה משוער 'גבוה'.

MutateCustomerSkAdNetworkConversionValueSchemaResult

התוצאה של השינוי של CustomerSkAdNetworkConversionValueSchema.

ייצוג JSON 
{
  "resourceName": string,
  "appId": string
}
שדות
resourceName

string

שם המשאב של הלקוח ששונה.
appId

string

מזהה האפליקציה של SkanConversionValue שהשתנה.