OfflineUserDataJob

משימה שמכילה נתוני משתמשים אופליין של מבקרים בחנות או חברים ברשימת משתמשים, שתעובד באופן אסינכרוני. לא ניתן לקרוא את הנתונים שהועלו ואת תוצאות העיבוד של המשימה ניתן לקרוא רק באמצעות GoogleAdsService.Search/SearchStream.

ייצוג JSON
{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}
שדות
resourceName

string

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

customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}

type

enum (OfflineUserDataJobType)

בלתי ניתן לשינוי. סוג המשימה.

status

enum (OfflineUserDataJobStatus)

פלט בלבד. סטטוס המשרה.

failureReason

enum (OfflineUserDataJobFailureReason)

פלט בלבד. הסיבה לכשל העיבוד, אם הסטטוס הוא 'נכשל'.

operationMetadata

object (OfflineUserDataJobMetadata)

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

id

string (int64 format)

פלט בלבד. המזהה של המשימה הזו של נתוני משתמש אופליין.

externalId

string (int64 format)

בלתי ניתן לשינוי. מזהה משימה שצוין על ידי המשתמש.

שדה איחוד metadata. המטא-נתונים של המשימה. metadata יכול להיות רק אחת מהאפשרויות הבאות:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

בלתי ניתן לשינוי. מטא-נתונים לעדכוני נתונים של רשימת משתמשים שמבוססת על ניהול קשרי לקוחות (CRM).

storeSalesMetadata

object (StoreSalesMetadata)

בלתי ניתן לשינוי. עדכון המטא-נתונים של נתוני המכירות בחנות הפיזית.

OfflineUserDataJobType

סוג המשימה של נתוני משתמשים אופליין.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
STORE_SALES_UPLOAD_FIRST_PARTY נתונים של מכירות ישירות בחנות הפיזית לשירות עצמי.
STORE_SALES_UPLOAD_THIRD_PARTY נתונים על מכירות ישירות בחנות הפיזית של צד שלישי.
CUSTOMER_MATCH_USER_LIST נתונים של רשימות משתמשים מסוג 'התאמה ללקוחות'.
CUSTOMER_MATCH_WITH_ATTRIBUTES התאמה ללקוחות באמצעות נתוני מאפיינים.

OfflineUserDataJobStatus

הסטטוס של משימה בנתוני משתמש אופליין.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
PENDING המשימה נוצרה בהצלחה וממתינה להעלאה.
RUNNING ההעלאות התקבלו והמערכת מעבדת את הנתונים.
SUCCESS הנתונים שהועלו עובדו בהצלחה.
FAILED עיבוד הנתונים שהועלו נכשל.

OfflineUserDataJobFailureReason

הסיבה לכשל במשימה של נתוני משתמש אופליין.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
INSUFFICIENT_MATCHED_TRANSACTIONS העסקאות שהותאמו לא מספיקות.
INSUFFICIENT_TRANSACTIONS העסקאות שהועלו לא מספיקות.
HIGH_AVERAGE_TRANSACTION_VALUE ערך העסקה הממוצע גבוה באופן חריג בחשבון שלכם. אם התכוונת לעשות זאת, יש לפנות לתמיכה ולבקש חריגה. מידע נוסף זמין בכתובת https://support.google.com/google-ads/answer/10018944#transaction_value
LOW_AVERAGE_TRANSACTION_VALUE ערך העסקה הממוצע נמוך באופן חריג בחשבון שלכם. אם התכוונת לעשות זאת, יש לפנות לתמיכה ולבקש חריגה. מידע נוסף זמין בכתובת https://support.google.com/google-ads/answer/10018944#transaction_value
NEWLY_OBSERVED_CURRENCY_CODE יש קוד מטבע שלא נעשה בו שימוש בעבר בהעלאות שלך. אם התכוונת לעשות זאת, יש לפנות לתמיכה ולבקש חריגה. מידע נוסף זמין בכתובת https://support.google.com/google-ads/answer/10018944#Unrecognized_currency

OfflineUserDataJobMetadata

מטא-נתונים של משימה בנתוני משתמש אופליין.

ייצוג JSON
{
  "matchRateRange": enum (OfflineUserDataJobMatchRateRange)
}
שדות
matchRateRange

enum (OfflineUserDataJobMatchRateRange)

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

OfflineUserDataJobMatchRateRange

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN ערך ברירת המחדל של טווח אחוז הלקוחות לטירגוט.
MATCH_RANGE_LESS_THAN_20 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא בין 0% ל-19%.
MATCH_RANGE_20_TO_30 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא בין 20% ל-30%.
MATCH_RANGE_31_TO_40 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא בין 31% ל-40%.
MATCH_RANGE_41_TO_50 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא בין 41% ל-50%.
MATCH_RANGE_51_TO_60 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא בין 51% ל-60%.
MATCH_RANGE_61_TO_70 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא בין 61% ל-70%.
MATCH_RANGE_71_TO_80 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא בין 71% ל-80%.
MATCH_RANGE_81_TO_90 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא בין 81% ל-90%.
MATCH_RANGE_91_TO_100 טווח אחוז הלקוחות לטירגוט בישות להעלאת נתונים ממקורות אופליין הוא 91% או גדול יותר.

StoreSalesMetadata

מטא-נתונים של מכירות ישירות בחנות הפיזית.

ייצוג JSON
{
  "thirdPartyMetadata": {
    object (StoreSalesThirdPartyMetadata)
  },
  "loyaltyFraction": number,
  "transactionUploadFraction": number,
  "customKey": string
}
שדות
thirdPartyMetadata

object (StoreSalesThirdPartyMetadata)

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

loyaltyFraction

number

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

transactionUploadFraction

number

זה היחס בין המכירות שמעלים לבין כלל המכירות שניתן לשייך ללקוח. חובה. השבר צריך להיות מספר בין 0 ל-1 (לא כולל 0). לדוגמה: אם מעלים חצי מהמספר הכולל של המכירות שניתן לשייך ללקוח, הערך יהיה 0.5.

customKey

string

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

StoreSalesThirdPartyMetadata

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

ייצוג JSON
{
  "advertiserUploadDateTime": string,
  "validTransactionFraction": number,
  "partnerMatchFraction": number,
  "partnerUploadFraction": number,
  "bridgeMapVersionId": string,
  "partnerId": string
}
שדות
advertiserUploadDateTime

string

השעה שבה המפרסם העלה את הנתונים לשותף. חובה. הפורמט הוא 'YYYY-MM-DD HH:MM:SS'. לדוגמה: '2018-03-05 09:15:00' או '2018-02-01 14:34:30'

validTransactionFraction

number

החלק היחסי של העסקאות שהן תקינות. עסקאות לא חוקיות עשויות לכלול פורמטים או ערכים לא חוקיים. חובה. השבר צריך להיות מספר בין 0 ל-1 (לא כולל 0).

partnerMatchFraction

number

החלק של העסקאות החוקיות שתואמות למזהה משתמש שהוקצה על ידי צד שלישי בצד השותף. חובה. השבר צריך להיות מספר בין 0 ל-1 (לא כולל 0).

partnerUploadFraction

number

החלק של העסקאות החוקיות שהשותף העלה ל-Google. חובה. השבר צריך להיות מספר בין 0 ל-1 (לא כולל 0).

bridgeMapVersionId

string

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

partnerId

string (int64 format)

המזהה של שותף הצד השלישי שמעדכן את פיד העסקאות.