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' ואת שיעור ההתאמה הסופי כששיעור ההתאמה הסופי זמין אחרי שהסטטוס של המשימה הוא 'SUCCESS/FAILED'.

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)

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