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)

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

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

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

object (PostbackWindow)

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

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

boolean

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

PostbackWindow

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

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

object (ConversionValues)

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

boolean

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

ConversionValues

הגדרות של ערכי המרות לחלון לדיווח חוזר על המרות בסכימה של ערכי ההמרות ב-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 חלה על התנאים ברשימה הזו. אם חלון הדיווח חוזר על המרה (PostBack) מופעל, הוא חייב לכלול לפחות רשומה אחת ולכל היותר עד 3 רשומות.
lockEnabled

boolean

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

integer

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

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

CoarseValue

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

טיפוסים בני מנייה (enums)
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

 יצירת SKAdNetworkConversionValueSchema.

delete

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

get

 מחפש SKAdNetworkConversionValueSchema אחד.

list

 בתיבת הדו-שיח הזו מפורטים SKAdNetworkConversionValueSchema של מקור נתונים.

patch

 עדכון של SKAdNetworkConversionValueSchema.