REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

משאב: SKAdNetworkConversionValueSchema

הסכימה של ערכי המרות ב-SKAdNetwork של פיד ב-iOS.

ייצוג ב-JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
שדות
name

string

פלט בלבד. שם המשאב של הסכימה. הוא יהיה צאצא של מקור נתונים ל-iOS בלבד, וניתן יהיה ליצור רק צאצא אחד כזה במקור נתונים ל-iOS. פורמט: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

חובה. הגדרות ערך ההמרה של החלון הראשון לדיווח חוזר על המרה. הערכים האלה שונים מהערכים של חלון 2 וחלון 3 לדיווח חוזר על המרה, כי הם מכילים ערך המרה ברמת פירוט 'מפורט' (ערך מספרי).

צריך להגדיר ערכי המרות לחלון הזה לדיווח חוזר על המרה. החלונות האחרים הם אופציונליים, והם עשויים לרשת את ההגדרות של החלון הזה אם לא תגדירו אותם או תשביתו אותם.
postbackWindowTwo

object (PostbackWindow)

הגדרות ערכי ההמרות של החלון השני של הדיווח החוזר על המרה (PostBack).

צריך להגדיר את השדה הזה רק אם יש צורך להגדיר ערכים שונים של המרות לחלון הזה לדיווח חוזר על המרה.

אם הערך של enable_postback_window_settings מוגדר כ-false בחלון הדיווח החוזר הזה, המערכת תשתמש בערכים מ-postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

הגדרות ערכי ההמרות של החלון השלישי לדיווח חוזר על המרה.

צריך להגדיר את השדה הזה רק אם המשתמש בחר להגדיר ערכי המרה שונים לחלון הדיווח החוזר הזה על המרה. מותר להגדיר את חלון 3 בלי להגדיר את חלון 2. אם ההגדרות של חלון 1 וחלון 2 מוגדרות והערך של enable_postback_window_settings בחלון הזה לדיווח חוזר על המרה מוגדר כ-false, הסכימה תירש את ההגדרות מ-postbackWindowTwo.
applyConversionValues

boolean

אם ההגדרה הזו מופעלת, מערכת GA SDK תגדיר את ערכי ההמרות באמצעות הגדרת הסכימה הזו, והיא תייצא את הסכימה לכל חשבונות Google Ads שמקושרים לנכס הזה. אם ההגדרה הזו תושבת, ה-GA SDK לא יגדיר ערכי המרות באופן אוטומטי, והסכימה לא תיוּצא אל Google Ads.

PostbackWindow

ההגדרות של חלון הדיווח החוזר על המרות (PostBack) של SKAdNetwork.

ייצוג ב-JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
שדות
conversionValues[]

object (ConversionValues)

הסדר של השדה החוזר ישמש לקביעת סדר העדיפויות של ההגדרות של ערכי ההמרות. לרשומות עם מספר נמוך יותר במדד העדיפות ניתנת עדיפות גבוהה יותר. המערכת תבחר את הגדרת ערך ההמרה הראשונה שהערך שלה הוא true. אם הערך של enable_postback_window_settings מוגדר כ-true, חייב להיות בו לפחות רשומה אחת. אפשר להוסיף אליו עד 128 רשומות.
postbackWindowSettingsEnabled

boolean

אם הערך של enable_postback_window_settings הוא true, צריך לאכלס את conversionValues, והוא ישמש לקביעת המועד והאופן שבהם מגדירים את ערך ההמרה במכשיר הלקוח ולייצוא הסכימה לחשבונות Google Ads מקושרים. אם הערך הוא false, לא נעשה שימוש בהגדרות, אבל הן נשמרות למקרה שייעשה בהן שימוש בעתיד. הערך הזה תמיד חייב להיות נכון עבור postbackWindowOne.

ConversionValues

הגדרות של ערכי המרות לחלון של דיווח חוזר על המרה (PostBack) עבור סכימת ערכי המרות של SKAdNetwork.

ייצוג ב-JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
שדות
displayName

string

השם המוצג של ערך ההמרה ב-SKAdNetwork. האורך המקסימלי המותר של השם המוצג הוא 50 יחידות קוד UTF-16.
coarseValue

enum (CoarseValue)

חובה. ערך המרה בפירוט גס.

אין ערובה שהערך יהיה ייחודי.
eventMappings[]

object (EventMapping)

תנאי האירוע שצריך לעמוד בהם כדי להשיג את ערך ההמרה הזה. התנאים ברשימה הזו מקושרים באמצעות AND. אם חלון הדיווח החוזר מופעל, צריכות להיות בו לפחות רשומה אחת ולפחות 3 רשומות לכל היותר.
lockEnabled

boolean

אם הערך הוא True, ה-SDK אמור לנעול את ערך ההמרה הזה בחלון הנוכחי לדיווח חוזר על המרה.
fineValue

integer

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

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

CoarseValue

ערך ההמרה המשוער שמוגדר בקריאה של ה-SDK ל-updatePostbackConversionValue כשהתנאים של ConversionValues.event_mappings מתקיימים. מידע נוסף זמין במאמר SKAdNetwork.CoarseConversionValue.

טיפוסים בני מנייה (enum)
COARSE_VALUE_UNSPECIFIED לא צוין ערך גס.
COARSE_VALUE_LOW ערך משוער נמוך.
COARSE_VALUE_MEDIUM ערך משוער של המדיום.
COARSE_VALUE_HIGH ערך משוער גבוה.

EventMapping

תנאים להגדרת אירוע כך שיתאימו לאירוע.

ייצוג ב-JSON 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
שדות
eventName

string

חובה. השם של האירוע ב-Google Analytics. תמיד צריך להגדיר אותו. האורך המקסימלי המותר של השם המוצג הוא 40 יחידות קוד UTF-16.
minEventCount

string (int64 format)

צריך להגדיר לפחות אחד מארבעת הערכים המינימליים או המקסימליים הבאים. הערכים שהוגדרו ישויכו באמצעות AND כדי להגדיר אירוע. מספר הפעמים המינימלי שהאירוע התרחש. אם לא תגדירו את הערך, לא תתבצע בדיקה של מספר האירועים המינימלי.
maxEventCount

string (int64 format)

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

number

ההכנסה המינימלית שנוצרה כתוצאה מהאירוע. מטבע ההכנסות יוגדר ברמת הנכס. אם לא תגדירו ערך מינימלי, המערכת לא תבדוק את ערך האירוע המינימלי.
maxEventValue

number

ההכנסה המקסימלית שנוצרה כתוצאה מהאירוע. מטבע ההכנסות יוגדר ברמת הנכס. אם לא תגדירו ערך, לא תתבצע בדיקה של הערך המקסימלי של האירוע.

Methods

create

 יצירת SKAdNetworkConversionValueSchema.

delete

 המחיקה של היעד SKAdNetworkConversionValueSchema.

get

 חיפוש של SKAdNetworkConversionValueSchema יחיד.

list

 הצגת SKAdNetworkConversionValueSchema בשידור.

patch

 עדכון של SKAdNetworkConversionValueSchema.