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). הערכים האלה שונים מהערכים של חלונות 2 ו-3 לדיווח חוזר על המרה, כי הם מכילים ערך המרה מדויק (ערך מספרי).

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

object (PostbackWindow)

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

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

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

object (PostbackWindow)

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

צריך להגדיר את השדה הזה רק אם המשתמש בחר להגדיר ערכי המרה שונים לחלון הדיווח החוזר על המרה הזה. מותר להגדיר את חלון 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, ההגדרות לא נמצאות בשימוש, אבל הן נשמרות למקרה שיהיה בהן שימוש בעתיד. הערך הזה תמיד צריך להיות true עבור 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. אם חלון הדיווח החוזר על המרה מופעל, צריך להזין לפחות ערך אחד ולכל היותר 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

 מוחק את הסכימה של ערכי ההמרות ב-SKAdNetwork.

get

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

list

 מציג את SKAdNetworkConversionValueSchema בשידור.

patch

 עדכון של SKAdNetworkConversionValueSchema.