UserData

נתוני משתמשים שכוללים מזהים ומאפיינים של משתמשים.

ייצוג JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  },
  "consent": {
    object (Consent)
  }
}
שדות
userIdentifiers[]

object (UserIdentifier)

פרטי זיהוי של משתמש. חובה.
transactionAttribute

object (TransactionAttribute)

עסקאות/מאפיינים נוספים שמשויכים למשתמש. חובה כשמעדכנים את נתוני המכירות בחנות הפיזית.
userAttribute

object (UserAttribute)

מאפיינים נוספים שמשויכים למשתמש. חובה כשמעדכנים מאפייני התאמה ללקוחות. הם תקפים למשך 540 יום.
consent

object (Consent)

הגדרת ההסכמה של המשתמש. התאמה ללקוחות תתעלם מהשדה הזה ותחזיר אזהרה.

TransactionAttribute

המאפיין של עסקת המכירות בחנות הפיזית.

ייצוג JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
שדות
storeAttribute

object (StoreAttribute)

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

object (ItemAttribute)

מאפייני הפריט של העסקה.
transactionDateTime

string

חותמת הזמן של מועד ביצוע העסקה. חובה. הפורמט הוא 'YYYY-MM-DD HH:MM:SS[+/-HH:MM]'. אם לא קיים קיזוז, ה-API ישתמש באזור הזמן של החשבון כברירת מחדל. דוגמאות: 2018-03-05 09:15:00 או 2018-02-01 14:34:30+03:00
transactionAmountMicros

number

סכום העסקה במיליוניות השנייה. חובה. סכום העסקה במיליוניות השנייה צריך להיות גדול מ-1,000. אם מציינים את מאפייני הפריט, הוא מייצג את הערך הכולל של הפריטים, לאחר הכפלת המחיר ליחידה בסכום שצוין במאפיין ItemAttributes.
currencyCode

string

קוד מטבע לעסקה. נעשה שימוש בקוד בן שלוש אותיות לפי תקן ISO 4217. חובה.
conversionAction

string

שם המשאב של פעולת ההמרה שעליו רוצים לדווח על ההמרות. חובה.
orderId

string

מזהה ההזמנה של העסקה. הגישה מותרת רק ללקוחות ברשימת ההיתרים.
customValue

string

הערך של המשתנה המותאם אישית לכל עסקה. הגישה מותרת רק ללקוחות ברשימת ההיתרים.

StoreAttribute

מאפייני העסקה של העסקה.

ייצוג JSON 
{
  "storeCode": string
}
שדות
storeCode

string

קוד החנות שמופיע בכתובת https://support.google.com/business/answer/3370250#storecode

ItemAttribute

מאפייני הפריט של העסקה.

ייצוג JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
שדות
itemId

string

מזהה ייחודי של מוצר. הוא יכול להיות מזהה פריט ב-Merchant Center או מספר GTIN (מספר פריט מסחרי גלובלי).
countryCode

string

קוד הטריטוריה של מאגר נתוני הלוקאל המשותף (CLDR) של המדינה המשויכת אל הפיד שאליו מועלים הפריטים. מידע נוסף זמין בכתובת https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes.
languageCode

string

קוד ISO 639-1 של השפה המשויכת אל הפיד שאליו מועלים הפריטים
quantity

string (int64 format)

מספר הפריטים שנמכרו. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא 1.
merchantId

string (int64 format)

מספר החשבון ב-Merchant Center.

UserAttribute

מאפיין משתמש, ניתן להשתמש רק בסוג המשימה CUSTOMER_MATCH_WITH_ATTRIBUTES.

ייצוג JSON 
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
שדות
lastPurchaseDateTime

string

חותמת הזמן של הרכישה האחרונה שביצע המשתמש. הפורמט הוא YYYY-MM-DD HH:MM:SS[+/-HH:MM]. אם לא קיים קיזוז, ה-API ישתמש באזור הזמן של החשבון כברירת מחדל.
averagePurchaseCount

integer

מספר הרכישות הממוצע שהמשתמש ביצע בתקופה של 30 יום, לפי הגדרת המפרסם.
averagePurchaseValueMicros

string (int64 format)

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

string

חותמת הזמן של צירוף המשתמש. הפורמט הוא YYYY-MM-DD HH:MM:SS[+/-HH:MM]. אם לא קיים קיזוז, ה-API ישתמש באזור הזמן של החשבון כברירת מחדל.
lifecycleStage

string

אפשרות. שלב במחזור החיים שהוגדר על ידי המפרסם עבור המשתמש. הערכים הקבילים הם 'Lead', 'Active' ו-'Cherned'.
firstPurchaseDateTime

string

אפשרות. חותמת הזמן של הרכישה הראשונה שביצע המשתמש. הפורמט הוא YYYY-MM-DD HH:MM:SS[+/-HH:MM]. אם לא קיים קיזוז, ה-API ישתמש באזור הזמן של החשבון כברירת מחדל.
eventAttribute[]

object (EventAttribute)

אפשרות. אירועים שהוגדרו על ידי המפרסם והמאפיינים שלהם. כל הערכים בשדות המקוננים הם חובה. השדה הזה נמצא כרגע בגרסת בטא.
lifetimeValueMicros

string (int64 format)

ערך חיי המשתמש הגדיר על ידי המפרסם.
lifetimeValueBucket

integer

קטגוריית ערך חיי המשתמש שהגדיר המפרסם. הטווח החוקי של קטגוריה של ערך חיי המשתמש הוא בין 1 (נמוך) ל-10 (גבוה), למעט פעולת הסרה שבה יתקבל גם 0.
shoppingLoyalty

object (ShoppingLoyalty)

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

ShoppingLoyalty

נתונים שקשורים למועדון לקוחות בשופינג. Google שופינג משתמשת בנתונים האלה כדי לספק למשתמשים חוויה טובה יותר. נגיש רק למוכרים ברשימת ההיתרים.

ייצוג JSON 
{
  "loyaltyTier": string
}
שדות
loyaltyTier

string

רמת החברות במועדון. זו מחרוזת בפורמט חופשי, כי לכל מוכר יכולה להיות מערכת מועדון לקוחות משלו. לדוגמה, הוא יכול להיות מספר בין 1 ל-10, מחרוזת כמו "זהב" או "כסף", או אפילו מחרוזת ריקה "".

EventAttribute

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

ייצוג JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
שדות
event

string

חובה. אירוע בהגדרת המפרסם שישמש לרימרקטינג. הערכים הקבילים הם 'נצפו', 'עגלת קניות', 'נרכש' ו'מומלץ'.
eventDateTime

string

חובה. חותמת הזמן שבה התרחש האירוע. הפורמט הוא YYYY-MM-DD HH:MM:SS[+/-HH:MM]. אם לא קיים קיזוז, ה-API ישתמש באזור הזמן של החשבון כברירת מחדל.
itemAttribute[]

object (EventItemAttribute)

חובה. מאפייני הפריט של האירוע.

EventItemAttribute

מאפייני הפריט של האירוע בהתאמה ללקוחות.

ייצוג JSON 
{
  "itemId": string
}
שדות
itemId

string

אפשרות. מזהה ייחודי של מוצר. הוא יכול להיות מזהה פריט ב-Merchant Center או מספר GTIN (מספר פריט מסחרי גלובלי).