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. Format: 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.