Customer

לקוח.

ייצוג JSON 
{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "localServicesSettings": {
    object (LocalServicesSettings)
  },
  "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)

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

object (CustomerAgreementSetting)

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

object (LocalServicesSettings)

פלט בלבד. הגדרות עבור לקוח 'Google בעלי מקצוע'.
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 הלקוח לא עומד בדרישות מסיבות אחרות.

CustomerAgreementSetting

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

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

boolean

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

LocalServicesSettings

הגדרות עבור לקוח 'Google בעלי מקצוע'.

ייצוג JSON 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
שדות
granularLicenseStatuses[]

object (GranularLicenseStatus)

פלט בלבד. רשימה לקריאה בלבד של סטטוסים של רישיונות ברמת האזור הגיאוגרפי הגיאוגרפי.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

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

GranularLicenseStatus

סטטוס הרישיון ברמה הגיאוגרפית + האנכית.

ייצוג JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
שדות
geoCriterionId

string (int64 format)

פלט בלבד. מזהה קריטריון של מיקוד גיאוגרפי המשויך לסטטוס. יכול להיות ברמת הגיאוגרפיה של מדינה או מחוז, בהתאם לדרישות ולמיקום. מידע נוסף זמין בכתובת https://developers.google.com/google-ads/api/data/geotargets.
categoryId

string

פלט בלבד. קטגוריית השירות שמשויכת לסטטוס. לדוגמה, xcat:service_area_business_שרברב. מידע נוסף זמין בכתובת https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
verificationStatus

enum (LocalServicesVerificationStatus)

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

LocalServicesVerificationStatus

ספירה שמתארת את הסטטוס של קטגוריית אימות ספציפית של מודעות 'Google בעלי מקצוע'.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN סטטוס אימות לא ידוע.
NEEDS_REVIEW האימות התחיל, אבל עדיין לא הסתיים.
FAILED האימות נכשל.
PASSED האימות עבר.
NOT_APPLICABLE האימות לא רלוונטי.
NO_SUBMISSION נדרש אימות, אבל בהמתנה לשליחה.
PARTIAL_SUBMISSION לא כל האימות הנדרש נשלח.
PENDING_ESCALATION צריך לבדוק את האימות על ידי מומחה לתפעול מודעות של 'Google בעלי מקצוע'.

GranularInsuranceStatus

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

ייצוג JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
שדות
geoCriterionId

string (int64 format)

פלט בלבד. מזהה קריטריון של מיקוד גיאוגרפי המשויך לסטטוס. יכול להיות ברמת הגיאוגרפיה של מדינה או מחוז, בהתאם לדרישות ולמיקום. מידע נוסף זמין בכתובת https://developers.google.com/google-ads/api/data/geotargets.
categoryId

string

פלט בלבד. קטגוריית השירות שמשויכת לסטטוס. לדוגמה, xcat:service_area_business_שרברב. מידע נוסף זמין בכתובת https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
verificationStatus

enum (LocalServicesVerificationStatus)

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