Customer

לקוח.

ייצוג JSON
{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "offlineConversionClientSummaries": [
    {
      object (OfflineConversionClientSummary)
    }
  ],
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "hasPartnersBadge": boolean,
  "manager": boolean,
  "testAccount": boolean,
  "optimizationScore": number,
  "locationAssetAutoMigrationDone": boolean,
  "imageAssetAutoMigrationDone": boolean,
  "locationAssetAutoMigrationDoneDateTime": string,
  "imageAssetAutoMigrationDoneDateTime": string
}
שדות
resourceName

string

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

customers/{customerId}

callReportingSetting

object (CallReportingSetting)

הגדרת דיווח על שיחות ללקוח. ניתן לשינוי רק בפעולה update.

conversionTrackingSetting

object (ConversionTrackingSetting)

פלט בלבד. הגדרת מעקב המרות עבור הלקוח.

remarketingSetting

object (RemarketingSetting)

פלט בלבד. הגדרת רימרקטינג ללקוח.

payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

פלט בלבד. סיבות לכך שהלקוח לא כשיר להשתמש ב-PaymentMode.convert. אם הרשימה ריקה, הלקוח עומד בדרישות. השדה הזה הוא לקריאה בלבד.

optimizationScoreWeight

number

פלט בלבד. משקל ציון האופטימיזציה של הלקוח.

המשקל של ציון האופטימיזציה יכול לשמש להשוואה או לצבירה של ציוני אופטימיזציה בין כמה לקוחות בלי חשבון ניהול. ציון האופטימיזציה המצטבר של חשבון ניהול מחושב כסיכום של כל הלקוחות שלו בדומיין Customer.optimization_score * Customer.optimization_score_weight. הערך בשדה הזה הוא 0 לכל לקוחות הניהול וללקוחות שאינם חשבונות ניהול.

השדה הזה הוא לקריאה בלבד.

status

enum (CustomerStatus)

פלט בלבד. סטטוס הלקוח.

offlineConversionClientSummaries[]

object (OfflineConversionClientSummary)

פלט בלבד. אבחון של העלאת המרות אופליין.

customerAgreementSetting

object (CustomerAgreementSetting)

פלט בלבד. הגדרת הסכם לקוח ללקוח.

id

string (int64 format)

פלט בלבד. מספר הלקוח.

descriptiveName

string

שם תיאורי (אופציונלי) לא ייחודי של הלקוח.

currencyCode

string

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

timeZone

string

לא משתנה. מזהה אזור הזמן המקומי של הלקוח.

trackingUrlTemplate

string

התבנית של כתובת ה-URL ליצירת כתובת URL למעקב מפרמטרים. ניתן לשינוי רק בפעולה update.

finalUrlSuffix

string

התבנית של כתובת ה-URL להוספת פרמטרים לכתובת ה-URL הסופית. ניתן לשינוי רק בפעולה update.

autoTaggingEnabled

boolean

האם תיוג אוטומטי הופעל עבור הלקוח.

hasPartnersBadge

boolean

פלט בלבד. אם ללקוח יש תג של תוכנית Partners. אם הלקוח לא משויך לתוכנית Partners, הערך יהיה false. מידע נוסף זמין בכתובת https://support.google.com/partners/answer/3125774.

manager

boolean

פלט בלבד. האם הלקוח הוא מנהל.

testAccount

boolean

פלט בלבד. האם הלקוח הוא חשבון בדיקה.

optimizationScore

number

פלט בלבד. ציון האופטימיזציה של הלקוח.

ציון האופטימיזציה הוא מדד שמעריך את יעילות ההגדרות של הקמפיינים של הלקוח ואת ההשפעה שלהן על פוטנציאל הביצועים. הערך נע בין 0% (0.0) ל-100% (1.0). השדה הזה ריק לכל לקוחות הניהול וללקוחות שאינם חשבונות ניהול.

מידע נוסף זמין במאמר 'מידע על ציון האופטימיזציה' בכתובת https://support.google.com/google-ads/answer/9061546.

השדה הזה הוא לקריאה בלבד.

locationAssetAutoMigrationDone

boolean

פלט בלבד. True אם מיקום מבוסס פיד הועבר למיקום מבוסס נכס.

imageAssetAutoMigrationDone

boolean

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

locationAssetAutoMigrationDoneDateTime

string

פלט בלבד. חותמת הזמן של ההעברה ממיקום מבוסס-פיד למיקום בסיס הנכסים בפורמט yyyy-MM-dd HH:mm:ss.

imageAssetAutoMigrationDoneDateTime

string

פלט בלבד. חותמת הזמן של ההעברה מתמונה מבוססת פיד לתמונה בסיסית של נכס בפורמט yyyy-MM-dd HH:mm:ss.

CallReportingSetting

הגדרת דיווח על שיחות ללקוח. ניתן לשינוי רק בפעולה update.

ייצוג JSON
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
שדות
callReportingEnabled

boolean

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

callConversionReportingEnabled

boolean

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

callConversionAction

string

פעולת המרה מסוג שיחה ברמת הלקוח שאליה רוצים לשייך המרה מסוג שיחה. אם היא לא מוגדרת, המערכת תשתמש בפעולת המרה שמוגדרת כברירת מחדל. בתוקף רק כאשר callConversionReportingEnabled מוגדר כ-True.

ConversionTrackingSetting

אוסף של הגדרות ברמת הלקוח הקשורות למעקב המרות ב-Google Ads.

ייצוג JSON
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
שדות
acceptedCustomerDataTerms

boolean

פלט בלבד. האם הלקוח אישר את התנאים בנוגע לנתונים של לקוחות. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מהמנהל. השדה הזה הוא לקריאה בלבד. מידע נוסף זמין בכתובת https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

פלט בלבד. הסטטוס של מעקב ההמרות. מציין אם הלקוח משתמש במעקב המרות, ומיהו הבעלים של מעקב ההמרות של לקוח זה. אם הלקוח הזה משתמש במעקב המרות ברמת חשבון ניהול, הערך שיוחזר ישתנה בהתאם ל-login-customer-id של הבקשה.

enhancedConversionsForLeadsEnabled

boolean

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

googleAdsConversionCustomer

string

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

conversionTrackingId

string (int64 format)

פלט בלבד. המזהה לצורכי מעקב המרות שנעשה בו שימוש בחשבון הזה. המזהה הזה לא מציין אם הלקוח משתמש במעקב המרות (הפרמטר conversionTrackingStatus כן פועל). השדה הזה הוא לקריאה בלבד.

crossAccountConversionTrackingId

string (int64 format)

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

ConversionTrackingStatus

סטטוס מעקב ההמרות של הלקוח.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
NOT_CONVERSION_TRACKED הלקוח לא משתמש במעקב המרות כלשהו.
CONVERSION_TRACKING_MANAGED_BY_SELF הלקוח הזה יוצר ומנוהל את פעולות ההמרה.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER המנהל שצוין בlogin-customer-id של הבקשה יוצר ומנוהל על ידי המנהל שלו.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER מנהל שונה מהלקוח או המנהל שצוינו בlogin-customer-id של הבקשה יוצר ומנוהל על ידי מנהל החשבון.

RemarketingSetting

הגדרת רימרקטינג ללקוח.

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

string

פלט בלבד. Google Tag.

CustomerPayPerConversionEligibilityFailureReason

ספירה שמתארת את הסיבות האפשריות לכך שלקוח לא כשיר להשתמש ב-PaymentMode.conversion.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
NOT_ENOUGH_CONVERSIONS לא התקבלו מספיק המרות בחשבון של הלקוח.
CONVERSION_LAG_TOO_HIGH פרק הזמן עד להמרה ארוך מדי אצל הלקוח.
HAS_CAMPAIGN_WITH_SHARED_BUDGET הלקוח משתמש בתקציבים משותפים.
HAS_UPLOAD_CLICKS_CONVERSION ללקוח יש המרות מסוג ConversionActionType.UPLOAD_CPC.
AVERAGE_DAILY_SPEND_TOO_HIGH ההוצאה היומית הממוצעת של הלקוח גבוהה מדי.
ANALYSIS_NOT_COMPLETE הכשירות של הלקוח עדיין לא חושבה באמצעות הקצה העורפי של Google Ads. כדאי לחזור לכאן בקרוב ולבדוק שוב.
OTHER הלקוח לא עומד בדרישות מסיבות אחרות.

OfflineConversionClientSummary

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

ייצוג JSON
{
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionUploadAlert)
    }
  ]
}
שדות
client

enum (OfflineEventUploadClient)

פלט בלבד. סוג הלקוח של אירוע ההעלאה.

status

enum (OfflineConversionDiagnosticStatus)

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

totalEventCount

string (int64 format)

פלט בלבד. המספר הכולל של האירועים שהועלו.

successfulEventCount

string (int64 format)

פלט בלבד. המספר הכולל של אירועים שהועלו בהצלחה.

successRate

number

פלט בלבד. דירוג הצלחה.

lastUploadDateTime

string

פלט בלבד. התאריך של ההעלאה האחרונה.

dailySummaries[]

object (OfflineConversionUploadSummary)

פלט בלבד. סיכום של נתונים סטטיסטיים בהיסטוריה לפי N הימים האחרונים.

jobSummaries[]

object (OfflineConversionUploadSummary)

פלט בלבד. סיכום של נתונים סטטיסטיים בהיסטוריה לפי N המשימות האחרונות.

alerts[]

object (OfflineConversionUploadAlert)

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

OfflineEventUploadClient

סוג הלקוח.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
GOOGLE_ADS_API ב-Google Ads API
GOOGLE_ADS_WEB_CLIENT לקוח האינטרנט של Google Ads, שיכול לכלול כמה מקורות, כמו ממשק המשתמש של Google Ads, SFTP וכו'.
ADS_DATA_CONNECTOR פלטפורמת החיבור.

OfflineConversionDiagnosticStatus

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EXCELLENT ההגדרה של הטמעת הנתונים ממקורות אופליין פעילה ואופטימלית לעיבוד נתונים במורד הזרם (downstream).
GOOD ההגדרה של הטמעת הנתונים ממקורות אופליין פעילה, אבל יש שיפורים נוספים שאפשר לבצע. הצגת ההתראות.
NEEDS_ATTENTION ההגדרה של הטמעת הנתונים ממקורות אופליין פעילה, אבל יש שגיאות שדורשות התייחסות. הצגת ההתראות.
NO_RECENT_UPLOAD ב-28 הימים האחרונים לא התקבלו נתונים בהגדרה של הטמעת הנתונים ממקורות אופליין. יכול להיות שמשהו השתבש.

OfflineConversionUploadSummary

סיכום העלאה היסטורי, שמקובץ לפי תאריך ההעלאה או משרה.

ייצוג JSON
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
שדות
successfulCount

string (int64 format)

פלט בלבד. המספר הכולל של אירועים מוצלחים.

failedCount

string (int64 format)

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

שדה איחוד dimension_key. מפתח מאפיין לסיכום. הערך של dimension_key יכול להיות רק אחת מהאפשרויות הבאות:
jobId

string (int64 format)

פלט בלבד. מפתח מאפיין ל-N המשימות האחרונות.

uploadDate

string

פלט בלבד. מפתח מאפיין ל-N הימים האחרונים.

OfflineConversionUploadAlert

התראה לסיכום לקוח של המרות אופליין.

ייצוג JSON
{
  "error": {
    object (OfflineConversionUploadError)
  },
  "errorPercentage": number
}
שדות
error

object (OfflineConversionUploadError)

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

errorPercentage

number

פלט בלבד. אחוז השגיאה.

OfflineConversionUploadError

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

ייצוג JSON
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
שדות
שדה איחוד error_code. שגיאה בתיאור. הערך של error_code יכול להיות רק אחת מהאפשרויות הבאות:
collectionSizeError

enum (CollectionSizeError)

פלט בלבד. שגיאה בגודל האוסף.

conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

פלט בלבד. שגיאה בהעלאה של התאמת המרה.

conversionUploadError

enum (ConversionUploadError)

פלט בלבד. שגיאה בהעלאת המרה.

dateError

enum (DateError)

פלט בלבד. שגיאת תאריך.

distinctError

enum (DistinctError)

פלט בלבד. שגיאה ייחודית.

fieldError

enum (FieldError)

פלט בלבד. שגיאת שדה.

mutateError

enum (MutateError)

פלט בלבד. שגיאת שינוי.

notAllowlistedError

enum (NotAllowlistedError)

פלט בלבד. שגיאה מסוג 'לא ברשימת ההיתרים'.

stringFormatError

enum (StringFormatError)

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

stringLengthError

enum (StringLengthError)

פלט בלבד. שגיאה באורך המחרוזת.

CollectionSizeError

ספירה שמתארת שגיאות אפשריות בגודל אוסף.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
TOO_FEW מעט מדי.
TOO_MANY יותר מדי.

ConversionAdjustmentUploadError

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
TOO_RECENT_CONVERSION_ACTION אי אפשר לייבא אירועים לפעולת המרה שנוצרה עכשיו. אפשר לנסות לייבא שוב בעוד 6 שעות.
INVALID_CONVERSION_ACTION חשוב לציין פעולת המרה פעילה שאפשר לשנות.
CONVERSION_ALREADY_RETRACTED דיווח ההמרה כבר בוטל. ההתאמה הזו לא עובדה.
CONVERSION_NOT_FOUND ההמרה לפעולת ההמרה הזו ולמזהה ההמרה הזה לא נמצאה. צריך לוודא שמזהי ההמרות משויכים לפעולת ההמרה הנכונה ולנסות שוב.
CONVERSION_EXPIRED אי אפשר לבצע התאמה להמרה שהתרחשה לפני יותר מ-54 ימים.
ADJUSTMENT_PRECEDES_CONVERSION להתאמה יש adjustmentDateTime שהתרחש לפני ההמרה המשויכת. צריך לוודא שהשדה adjustmentDateTime תקין ולנסות שוב.
MORE_RECENT_RESTATEMENT_FOUND כבר דווח על התאמה עדכנית יותר, adjustmentDateTime, עבור ההמרה המשויכת. צריך לוודא שההתאמה adjustmentDateTime נכונה ולנסות שוב.
TOO_RECENT_CONVERSION אי אפשר לתעד את ההתאמה כי ההמרה התרחשה לפני זמן קצר מדי. כדאי לנסות לשנות המרה שהתרחשה לפני 24 שעות לפחות.
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE אי אפשר לבצע התאמה להמרה שהוגדרה להשתמש בערך ברירת המחדל. צריך לבדוק את ההגדרה של ערך פעולת ההמרה ולנסות שוב.
TOO_MANY_ADJUSTMENTS_IN_REQUEST כדאי לנסות להעלות פחות מ-2,001 התאמות בבקשת API אחת.
TOO_MANY_ADJUSTMENTS ההמרה כבר הותאמה מספר הפעמים המקסימלי. כדאי לבצע את ההתאמות הדרושות רק בהמרה קיימת.
RESTATEMENT_ALREADY_EXISTS ההמרה שונתה בעבר עם אותו adjustmentDateTime. צריך לוודא שערכת את הערך adjustmentDateTime הנכון והייחודי ולנסות שוב.
DUPLICATE_ADJUSTMENT_IN_REQUEST להתאמה שיובאה יש התאמת המרה כפולה עם אותו adjustmentDateTime. צריך לוודא שערך adjustmentDateTime של ההתאמה נכון ולנסות שוב.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS צריך לוודא שהסכמת לתנאים לעיבוד של נתוני הלקוחות בהגדרות ההמרה ולנסות שוב.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT אי אפשר להשתמש בהמרות משופרות עם פעולת ההמרה שצוינה.
INVALID_USER_IDENTIFIER חשוב לבצע גיבוב (hash) של הנתונים שהמשתמשים סיפקו באמצעות SHA-256, ולוודא שאתם מבצעים נירמול בהתאם להנחיות.
UNSUPPORTED_USER_IDENTIFIER צריך להשתמש בנתונים שהמשתמשים סיפקו, כמו כתובות אימייל או מספרי טלפון, שגובבו באמצעות אלגוריתם SHA-256, ואז לנסות שוב.
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET לא ניתן להגדיר גם gclidDateTimePair וגם orderId. צריך להשתמש רק בסוג אחד ולנסות שוב.
CONVERSION_ALREADY_ENHANCED להמרה כבר יש שיפורים עם אותו מזהה הזמנה ואותה פעולת המרה. צריך לוודא שהנתונים מוגדרים כראוי ולנסות שוב.
DUPLICATE_ENHANCEMENT_IN_REQUEST פעולת ההמרה ומזהה ההזמנה זהים בכמה שיפורים. צריך לוודא שהנתונים מוגדרים כראוי ולנסות שוב.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT אי אפשר להשתמש בהמרות משופרות בחשבון הזה בגלל המדיניות של Google בנושא נתוני לקוחות. אפשר לפנות לנציג Google.
MISSING_ORDER_ID_FOR_WEBPAGE כדי לבצע התאמה להמרות באתר, צריך להזין מזהה הזמנה (כלומר, מזהה עסקה). צריך לוודא שתגי האתר מתעדים את מזהי ההזמנות, ושאותם מזהי הזמנות נשלחים יחד עם ההתאמה.
ORDER_ID_CONTAINS_PII אי אפשר להשתמש בהתאמה עם מזהי הזמנות שמכילים פרטים אישיים מזהים (PII).

ConversionUploadError

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
TOO_MANY_CONVERSIONS_IN_REQUEST יש להעלות פחות מ-2,001 אירועים בבקשה אחת.
UNPARSEABLE_GCLID לא ניתן לפענח את ה-GCLID שיובא. חשוב לוודא שמזהי הקליקים לא שונו.
CONVERSION_PRECEDES_EVENT לאירוע המיובא יש conversionDateTime לפני הקליק. צריך לוודא שהשדה conversionDateTime תקין ולנסות שוב.
EXPIRED_EVENT אי אפשר לתעד את האירוע שיובא כי הקליק שהוביל אליו התרחש לפני חלון ההמרות מהקליקים. צריך לייבא את הנתונים העדכניים ביותר.
TOO_RECENT_EVENT הקליק המשויך למזהה הנתון או לפרמטר של כתובת האתר ב-iOS התרחש לפני פחות מ-6 שעות. אפשר לנסות שוב אחרי 6 שעות.
EVENT_NOT_FOUND לא ניתן לשייך את האירוע שיובא לקליק. יכול להיות שהוא לא הגיע מקמפיין Google Ads, ולכן המערכת לא מוצאת אותו.
UNAUTHORIZED_CUSTOMER הקריאה או מזהה הקליק משויכים לחשבון Google Ads שאין לך גישה אליהם. צריך לייבא המרות מחשבונות שמנוהלים על ידי חשבון הניהול שלך.
INVALID_CONVERSION_ACTION חשוב לציין פעולת המרה חוקית שמוגדרת לייבוא אופליין.
TOO_RECENT_CONVERSION_ACTION אי אפשר לייבא אירועים לפעולת המרה שנוצרה עכשיו. אפשר לנסות לייבא שוב בעוד 6 שעות.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME במועד הקליק, מעקב ההמרות לא היה מופעל בחשבון ההמרות האפקטיבי של חשבון Google Ads שאליו משויך הקליק.
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION האירוע המיובא כולל נתוני שיוך (Attribution) חיצוניים, אבל פעולת ההמרה לא מוגדרת לשימוש במודל שיוך חיצוני. צריך לוודא שפעולת ההמרה מוגדרת בצורה נכונה ולנסות שוב.
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION פעולת ההמרה מוגדרת לשימוש במודל שיוך (Attribution) חיצוני, אבל באירוע המיובא חסרים נתונים. צריך לוודא שהאירועים המיובאים כוללים את הקרדיט על שיוך החיצוני ואת כל השדות הנדרשים.
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION אי אפשר להשתמש במזהי הזמנות להמרה שנמדדת באמצעות מודל שיוך חיצוני. צריך לוודא שההמרה מוגדרת בצורה תקינה ושהאירועים שיובאו כוללים רק את הנתונים הנדרשים, ולאחר מכן לנסות שוב.
ORDER_ID_ALREADY_IN_USE האירוע המיובא כולל מזהה הזמנה שתועד בעבר, כך שהאירוע לא עבר עיבוד.
DUPLICATE_ORDER_ID אירועים מיובאים כוללים כמה המרות עם אותו מזהה הזמנה, והם לא עובדו. צריך לוודא שמזהי ההזמנות ייחודיים ולנסות שוב.
TOO_RECENT_CALL לא ניתן לייבא שיחות שהתרחשו לפני פחות מ-6 שעות. כדאי לנסות להעלות שוב בעוד 6 שעות.
EXPIRED_CALL אי אפשר להקליט את השיחה כי היא התרחשה לפני חלון המבט לאחור של פעולת ההמרה. צריך לוודא שהייבוא מוגדר כך שתקבלו את הנתונים העדכניים ביותר.
CALL_NOT_FOUND השיחה או הקליק שהובילו לאירוע המיובא לא נמצאו. חשוב לוודא שמקור הנתונים מוגדר כך שיכלול מזהים נכונים.
CONVERSION_PRECEDES_CALL לשיחה יש conversionDateTime שלפני הקליק המשויך. צריך לוודא שהשדה conversionDateTime נכון.
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME במועד ביצוע השיחה שיובאה, מעקב ההמרות לא הופעל בחשבון ההמרות האפקטיבי של חשבון Google Ads שאליו משויך הקליק.
UNPARSEABLE_CALLERS_PHONE_NUMBER חשוב לוודא שמספרי הטלפון מופיעים בפורמט E.164 (+16502531234), בפורמט בינלאומי (+64 3-331 6005) או במספרים לאומיים של ארה"ב (6502531234).
CLICK_CONVERSION_ALREADY_EXISTS האירוע שיובא כולל את אותם קליק ו-conversionDateTime כמו של המרה קיימת. צריך להזין conversionDateTime ייחודי או מזהה הזמנה ייחודי לכל אירוע ייחודי ולנסות שוב.
CALL_CONVERSION_ALREADY_EXISTS לשיחה שיובאה יש אותו conversionDateTime כמו להמרה קיימת. צריך לוודא שהconversionDateTime מוגדר כראוי ולנסות שוב.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST למספר אירועים יש את אותו קליק ואותו conversionDateTime. צריך לוודא שהconversionDateTime מוגדר בצורה נכונה ולנסות שוב.
DUPLICATE_CALL_CONVERSION_IN_REQUEST למספר אירועים יש את אותה שיחה ו-conversionDateTime. צריך לוודא שהconversionDateTime מוגדר בצורה נכונה ולנסות שוב.
CUSTOM_VARIABLE_NOT_ENABLED צריך להפעיל את המשתנה המותאם אישית בהגדרות ההמרה ולנסות שוב.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII אי אפשר לייבא אירועים עם משתנים מותאמים אישית שיש בהם פרטים אישיים מזהים (PII). צריך להסיר את המשתנים האלה ולנסות שוב.
INVALID_CUSTOMER_FOR_CLICK הקליק מהאירוע המיובא משויך לחשבון Google Ads אחר. צריך לוודא שהייבוא מתבצע לחשבון הנכון.
INVALID_CUSTOMER_FOR_CALL הקליק מהשיחה משויך לחשבון Google Ads אחר. צריך לוודא שהייבוא מתבצע לחשבון הנכון. צריך להריץ שאילתה מסוג conversionTrackingSetting.google_ads_conversion_customer ב'לקוח' כדי לזהות את החשבון הנכון.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY אי אפשר לייבא את ההמרה כי מקור ההמרה לא עמד בדרישות של מדיניות Apple App Transparency Tracking (ATT) או כי הלקוח לא הסכים למעקב.
CLICK_NOT_FOUND לא ניתן להתאים את כתובת האימייל או את מספר הטלפון של האירוע הזה לקליק. יכול להיות שהנתונים האלה לא הגיעו מקמפיין שלGoogle Ads. במצב כזה, אפשר להתעלם מהאזהרה הזו. אם באזהרה מופיעים יותר אירועים מיובאים מהצפוי, כדאי לבדוק את ההגדרה.
INVALID_USER_IDENTIFIER חשוב לבצע גיבוב (hash) של הנתונים שהמשתמשים סיפקו באמצעות SHA-256, ולוודא שאתם מבצעים נירמול בהתאם להנחיות.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER אי אפשר להשתמש בנתונים שהמשתמשים סיפקו במודלים חיצוניים של שיוך (Attribution). צריך להשתמש במודל שיוך אחר או להשמיט את מזהי המשתמשים ולנסות שוב.
UNSUPPORTED_USER_IDENTIFIER אין תמיכה במזהי משתמש שסופקו. צריך להשתמש רק בכתובת אימייל או במספר טלפון שעברו גיבוב (hash) ולנסות שוב.
GBRAID_WBRAID_BOTH_SET אי אפשר להשתמש גם בפרמטר gbraid וגם בפרמטר wbraid צריך להשתמש רק באחד מהם ולנסות שוב.
UNPARSEABLE_WBRAID אי אפשר לנתח את הנתונים של ייבוא האירועים. צריך לבדוק אם הפרמטר wbraid השתנה ולנסות שוב.
UNPARSEABLE_GBRAID אי אפשר לנתח את הנתונים של ייבוא האירועים. צריך לבדוק אם הפרמטר gbraid לא השתנה ולנסות שוב.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID אי אפשר להשתמש בפעולות המרה שנעשה בהן שימוש בספירה של המרה אחת לקליק עם פרמטרים מסוג gbraid או wbraid.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS אי אפשר להשתמש בהמרות משופרות בחשבון הזה בגלל המדיניות של Google בנושא נתוני לקוחות. אפשר לפנות לנציג Google.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS צריך לוודא שהסכמת לתנאים לעיבוד של נתוני הלקוחות בהגדרות ההמרה ולנסות שוב. כדי לבדוק את ההגדרה, יש לשלוח שאילתה ל-conversionTrackingSetting.accepted_customer_data_terms ב'לקוח'.
ORDER_ID_CONTAINS_PII אי אפשר לייבא אירועים עם מזהי הזמנות שמכילים פרטים אישיים מזהים (PII).
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS צריך לוודא שהפעלת המרות משופרות לצורך שיוך ללידים בהגדרות ההמרה ולנסות שוב. כדי לבדוק את ההגדרה, אתם יכולים לשלוח שאילתה ל-conversionTrackingSetting.enhanced_conversions_for_leads_enabled ב'לקוח'.

DateError

ספירה שמתארת שגיאות תאריך אפשריות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
INVALID_FIELD_VALUES_IN_DATE ערכי השדה הנתונים לא תואמים לתאריך חוקי.
INVALID_FIELD_VALUES_IN_DATE_TIME ערכי השדות הנתונים לא תואמים לתאריך חוקי של תאריך.
INVALID_STRING_DATE הפורמט של תאריך המחרוזת צריך להיות yyyy-mm-dd.
INVALID_STRING_DATE_TIME_MICROS פורמט התאריך של המחרוזת צריך להיות yyyy-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS פורמט התאריך של המחרוזת צריך להיות yyyy-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET פורמט התאריך של המחרוזת צריך להיות yyyy-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE התאריך חל לפני המינימום המותר.
LATER_THAN_MAXIMUM_DATE התאריך חל אחרי המקסימום המותר.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE גבולות טווח התאריכים אינם לפי הסדר.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL שני התאריכים בטווח הם ריקים.

DistinctError

טיפוסים בני מנייה שמתארים שגיאות ייחודיות אפשריות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
DUPLICATE_ELEMENT רכיב כפול.
DUPLICATE_TYPE סוג משוכפל.

FieldError

Enum מתאר שגיאות שדה אפשריות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
REQUIRED לא היה קיים שדה חובה.
IMMUTABLE_FIELD לא ניתן לשנות את השדה הזה.
INVALID_VALUE ערך השדה אינו חוקי.
VALUE_MUST_BE_UNSET לא ניתן להגדיר את השדה.
REQUIRED_NONEMPTY_LIST השדה הנדרש החוזר היה ריק.
FIELD_CANNOT_BE_CLEARED לא ניתן לנקות את השדה.
BLOCKED_VALUE ערך השדה מופיע ברשימת הישויות שנחסמו לשדה הזה.
FIELD_CAN_ONLY_BE_CLEARED לא ניתן לשנות את ערך השדה, מלבד ניקוי.

MutateError

Enum מתאר שגיאות מוטציה אפשריות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
RESOURCE_NOT_FOUND המשאב המבוקש לא נמצא.
ID_EXISTS_IN_MULTIPLE_MUTATES לא ניתן לשנות את אותו משאב פעמיים בבקשה אחת.
INCONSISTENT_FIELD_VALUES התוכן בשדה הזה לא תואם לשדה אחר שמייצג את אותם נתונים.
MUTATE_NOT_ALLOWED אי אפשר לבצע שינויים במשאב המבוקש.
RESOURCE_NOT_IN_GOOGLE_ADS המשאב לא נמצא ב-Google Ads. היא שייכת למערכת מודעות אחרת.
RESOURCE_ALREADY_EXISTS המשאב שנוצר כבר קיים.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY לא ניתן להשתמש במשאב הזה עם האפשרות 'validateOnly'.
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE לא ניתן להשתמש בפעולה זו עם "partialFailure".
RESOURCE_READ_ONLY ניסיון לכתוב בשדות שהם לקריאה בלבד.

NotAllowlistedError

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE הלקוח לא נכנס לרשימת ההיתרים עבור גישה לתכונה הזו.

StringFormatError

טיפוסים בני מנייה (Enum) המתארים שגיאות אפשריות בפורמט מחרוזת.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
ILLEGAL_CHARS הערך של מחרוזת הקלט מכיל תווים אסורים.
INVALID_FORMAT הערך של מחרוזת הקלט לא תקין בשדה המשויך.

StringLengthError

טיפוסים בני מנייה (Enum) המתארים שגיאות אפשריות של אורך מחרוזת.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
EMPTY השדה שצוין צריך להכיל לפחות תו אחד שאינו רווח לבן.
TOO_SHORT קצר מדי.
TOO_LONG יותר מדי זמן.

CustomerAgreementSetting

הגדרת הסכם לקוח ללקוח.

ייצוג JSON
{
  "acceptedLeadFormTerms": boolean
}
שדות
acceptedLeadFormTerms

boolean

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