UserData

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

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

object (UserIdentifier)

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

object (TransactionAttribute)

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

object (UserAttribute)

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

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]', כאשר [+/-HH:MM] הוא אזור זמן אופציונלי שמשתנה משעון UTC. אם לא קיים קיזוז, ה-API ישתמש באזור הזמן של החשבון כברירת מחדל. דוגמאות: '2018-03-05 09:15:00' או '2018-02-01 14:34:30+03:00'
transactionAmountMicros

number

סכום העסקה ב-Micros. חובה. סכום העסקה ב-Micros צריך להיות גדול מ-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], כאשר [+/-HH:MM] הוא אזור זמן אופציונלי שנוצר מסטייה משעון UTC. אם לא קיים קיזוז, ה-API ישתמש באזור הזמן של החשבון כברירת מחדל.
averagePurchaseCount

integer

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

string (int64 format)

ערך הרכישה הממוצע של המשתמש הוגדר במיקרו-נתונים של המשתמש.
acquisitionDateTime

string

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

string

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

string

אפשרות. חותמת הזמן של הרכישה הראשונה שביצע המשתמש. הפורמט הוא YYYY-MM-DD HH:MM:SS[+/-HH:MM], כאשר [+/-HH:MM] הוא אזור זמן אופציונלי שנוצר מסטייה משעון UTC. אם לא קיים קיזוז, ה-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], כאשר [+/-HH:MM] הוא אזור זמן אופציונלי שנוצר מסטייה משעון UTC. אם לא קיים קיזוז, ה-API ישתמש באזור הזמן של החשבון כברירת מחדל.
itemAttribute[]

object (EventItemAttribute)

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

EventItemAttribute

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

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

string

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