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)
  },
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "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.{9} אם הרשימה ריקה, הלקוח עומד בדרישות. השדה הזה הוא לקריאה בלבד.
optimizationScoreWeight

number

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

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

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

enum (CustomerStatus)

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

object (CustomerAgreementSetting)

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

object (LocalServicesSettings)

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

enum (BrandSafetySuitability)

פלט בלבד. הגנה על המותג ברמת החשבון. ההגדרה מאפשרת לבחור סוג של מלאי שטחי פרסום כדי להציג את המודעות בתוכן שמתאים למותג. פרטים נוספים זמינים בכתובת https://support.google.com/google-ads/answer/7515513.
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). השדה הזה הוא null לכל הלקוחות עם הרשאות ניהול וללקוחות שאינם חשבונות ניהול.

מידע נוסף זמין במאמר "מידע על ציון האופטימיזציה" בכתובת 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. השדה הזה הוא לקריאה בלבד.

RemarketingSetting

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

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

string

פלט בלבד. Google Tag.

CustomerPayPerConversionEligibilityFailureReason

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

טיפוסים בני מנייה (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

Enum לתיאור סטטוס של קטגוריית אימות ספציפית של מודעות '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)

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