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)

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

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

object (PostbackWindow)

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

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

אם Enable_postback_window_settings מוגדר כ-False עבור החלון לדיווח חוזר על המרה (PostBack), ייעשה שימוש בערכים מ-postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

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

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

boolean

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

PostbackWindow

הגדרות של חלון לדיווח חוזר על המרות ב-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

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

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

CoarseValue

ערך ההמרה המשוער שמוגדר בקריאה של updatePostbackConversionValue ל-SDK כשמתקיימים התנאים של 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

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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

שיטות

create

 יוצרת סכימת SKAdNetworkConversionValue.

delete

 מחיקת היעד SKAdNetworkConversionValueSchema.

get

 המערכת מחפשת סכימה אחת של SKAdNetworkConversionValue.

list

 רשימה של SKAdNetworkConversionValueSchema בשידור.

patch

 מעדכנות סכימת SKAdNetworkConversionValue.