SearchAds360Row

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

ייצוג JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
שדות
adGroup

object (AdGroup)

קבוצת המודעות שאליה מפנה השאילתה.

adGroupAd

object (AdGroupAd)

המודעה שאליה מפנה השאילתה.

adGroupAdLabel

object (AdGroupAdLabel)

תווית המודעה של קבוצת המודעות שאליה מפנה השאילתה.

adGroupAsset

object (AdGroupAsset)

הנכס של קבוצת המודעות שיש אליו הפניה בשאילתה.

adGroupAssetSet

object (AdGroupAssetSet)

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

adGroupAudienceView

object (AdGroupAudienceView)

תצוגת הקהל של קבוצת המודעות שאליה מפנה השאילתה.

adGroupBidModifier

object (AdGroupBidModifier)

ערך ההתאמה של הצעת המחיר שמוזכר בשאילתה.

adGroupCriterion

object (AdGroupCriterion)

הקריטריון שהוזכר בשאילתה.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

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

adGroupLabel

object (AdGroupLabel)

תווית קבוצת המודעות שאליה מפנה השאילתה.

ageRangeView

object (AgeRangeView)

תצוגת טווח הגילאים שאליה מפנה השאילתה.

asset

object (Asset)

הנכס שהוזכר בשאילתה.

assetGroupAsset

object (AssetGroupAsset)

הנכס של קבוצת הנכסים שהוזכר בשאילתה.

assetGroupSignal

object (AssetGroupSignal)

האות של קבוצת הנכסים שהוזכר בשאילתה.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

מסנן הקבוצות של כרטיסי המוצר של קבוצת הנכסים שהוזכר בשאילתה.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

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

assetGroup

object (AssetGroup)

קבוצת הנכסים שאליה מפנה השאילתה.

assetSetAsset

object (AssetSetAsset)

הנכס של קבוצת הנכסים שהוזכר בשאילתה.

assetSet

object (AssetSet)

קבוצת הנכסים שאליה מפנה השאילתה.

biddingStrategy

object (BiddingStrategy)

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

campaignBudget

object (CampaignBudget)

תקציב הקמפיין שמוזכר בשאילתה.

campaign

object (Campaign)

הקמפיין שאליו מפנה השאילתה.

campaignAsset

object (CampaignAsset)

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

campaignAssetSet

object (CampaignAssetSet)

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

campaignAudienceView

object (CampaignAudienceView)

תצוגת הקהל של הקמפיין שאליה מפנה השאילתה.

campaignCriterion

object (CampaignCriterion)

הקריטריון של הקמפיין שאליו מפנה השאילתה.

campaignLabel

object (CampaignLabel)

תווית הקמפיין שאליה מפנה השאילתה.

cartDataSalesView

object (CartDataSalesView)

תצוגת המכירות של נתוני עגלות הקניות שאליה מפנה השאילתה.

audience

object (Audience)

הקהל שאליו מפנה השאילתה.

conversionAction

object (ConversionAction)

פעולת ההמרה שאליה מפנה השאילתה.

conversionCustomVariable

object (ConversionCustomVariable)

המשתנה המותאם אישית של ההמרה שמוזכר בשאילתה.

customer

object (Customer)

הלקוח שאליו מפנה השאילתה.

customerAsset

object (CustomerAsset)

נכס הלקוח שמוזכר בשאילתה.

customerAssetSet

object (CustomerAssetSet)

קבוצת הנכסים של הלקוח שאליה מפנה השאילתה.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

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

customerClient

object (CustomerClient)

לקוח הלקוח שאליו מפנה השאילתה.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

תצוגת מונחי החיפוש של המודעות הדינמיות לרשת החיפוש שאליה מפנה השאילתה.

genderView

object (GenderView)

תצוגת המגדר שאליה מפנה השאילתה.

geoTargetConstant

object (GeoTargetConstant)

קבוע הטירגוט הגיאוגרפי שמוזכר בשאילתה.

keywordView

object (KeywordView)

התצוגה המפורטת של מילת המפתח שאליה מפנה השאילתה.

label

object (Label)

התווית שאליה מפנה השאילתה.

languageConstant

object (LanguageConstant)

קבוע השפה שיש אליו הפניה בשאילתה.

locationView

object (LocationView)

תצוגת המיקום שאליה מפנה השאילתה.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

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

productGroupView

object (ProductGroupView)

תצוגת קבוצת המוצרים שאליה מפנה השאילתה.

shoppingPerformanceView

object (ShoppingPerformanceView)

תצוגת הביצועים בשופינג שאליה מפנה השאילתה.

userList

object (UserList)

רשימת המשתמשים שאליה בוצעה הפניה בשאילתה.

webpageView

object (WebpageView)

תצוגת דף האינטרנט שאליה מפנה השאילתה.

visit

object (Visit)

הביקור ברמת האירוע שמוזכר בשאילתה.

conversion

object (Conversion)

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

metrics

object (Metrics)

המדדים.

segments

object (Segments)

הפלחים.

customColumns[]

object (Value)

העמודות בהתאמה אישית.

קבוצת מודעות

קבוצת מודעות.

ייצוג JSON
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
שדות
resourceName

string

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

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

הסטטוס של קבוצת המודעות.

type

enum (AdGroupType)

הסוג של קבוצת המודעות.

adRotationMode

enum (AdGroupAdRotationMode)

המצב של סבב המודעות של קבוצת המודעות.

creationTime

string

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

targetingSetting

object (TargetingSetting)

הגדרה לטירגוט של תכונות שקשורות.

labels[]

string

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

engineId

string

המזהה של קבוצת המודעות בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבון שאינו חשבון Google Ads. לדוגמה, Yahoo Japan, Microsoft, Baidu וכו'. אם מדובר בישות Google Ads, יש להשתמש במאפיין adGroup.id במקום זאת.

startDate

string

התאריך שבו קבוצת המודעות מתחילה להציג מודעות. כברירת מחדל, קבוצת המודעות מתחילה עכשיו או תאריך ההתחלה של קבוצת המודעות, המוקדם מביניהם. אם מגדירים את השדה הזה, קבוצת המודעות תתחיל בתחילת התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ו-Facebook.

פורמט: YYYY-MM-DD דוגמה: 2019-03-14

endDate

string

התאריך שבו הצגת המודעות בקבוצת המודעות תסתיים. כברירת מחדל, קבוצת המודעות מסתיימת בתאריך הסיום של קבוצת המודעות. אם מגדירים את השדה הזה, קבוצת המודעות מסתיימת בסוף התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ו-Facebook.

פורמט: YYYY-MM-DD דוגמה: 2019-03-14

languageCode

string

השפה של המודעות ומילות המפתח בקבוצת מודעות. השדה הזה זמין רק לחשבונות Microsoft Advertising. למידע נוסף: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

התאריך והשעה שבהם בוצעה השינוי האחרון בקבוצת המודעות. התאריך והשעה מוצגים באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss.sssss'. הפורמט.

id

string (int64 format)

המזהה של קבוצת המודעות.

name

string

השם של קבוצת המודעות.

זהו שדה חובה והוא לא יכול להיות ריק כשיוצרים קבוצות חדשות של מודעות.

היא צריכה להכיל פחות מ-255 תווים בפורמט UTF-8 ברוחב מלא.

היא לא יכולה להכיל תווי null (נקודת קוד 0x0), פיד שורות NL (נקודת קוד 0xA) או תווי חזרה לתחילת השורה (נקודת קוד 0xD).

cpcBidMicros

string (int64 format)

הצעת המחיר המקסימלית לקליק (CPC).

engineStatus

enum (AdGroupEngineStatus)

סטטוס המנוע של קבוצת המודעות.

AdGroupStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED הסטטוס לא צוין.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

ENABLED קבוצת המודעות מופעלת.
PAUSED קבוצת המודעות מושהית.
REMOVED קבוצת המודעות תוסר.

AdGroupType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED הסוג לא צוין.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

SEARCH_STANDARD סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לרשת החיפוש.
DISPLAY_STANDARD סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לרשת המדיה.
SHOPPING_PRODUCT_ADS סוג קבוצת המודעות בקמפיינים של שופינג שמציגים מודעות רגילות למוצרים.
SHOPPING_SHOWCASE_ADS הסוג של קבוצות של מודעות שמוגבלות להצגת מודעות קטלוג או מודעות של מוכר בתוצאות של שופינג.
HOTEL_ADS סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לקידום מלונות.
SHOPPING_SMART_ADS הסוג של קבוצות של מודעות בקמפיינים חכמים לשופינג.
VIDEO_BUMPER מודעות וידאו קצרות In-stream שלא ניתן לדלג עליהן.
VIDEO_TRUE_VIEW_IN_STREAM מודעות וידאו In-stream מסוג TrueView (ניתנות לדילוג).
VIDEO_TRUE_VIEW_IN_DISPLAY מודעות וידאו מסוג TrueView ברשת המדיה.
VIDEO_NON_SKIPPABLE_IN_STREAM מודעות וידאו In-stream שלא ניתן לדלג עליהן.
VIDEO_OUTSTREAM מודעות וידאו Outstream.
SEARCH_DYNAMIC_ADS סוג קבוצת המודעות עבור קבוצות של מודעות דינמיות לרשת החיפוש.
SHOPPING_COMPARISON_LISTING_ADS הסוג של קבוצות של מודעות בקמפיינים של השוואת מחירים.
PROMOTED_HOTEL_ADS סוג קבוצת המודעות שמשויכת לקבוצות של מודעות לקידום מלונות.
VIDEO_RESPONSIVE קבוצות של מודעות וידאו רספונסיביות.
VIDEO_EFFICIENT_REACH קבוצות של מודעות וידאו לשיפור פוטנציאל החשיפה.
SMART_CAMPAIGN_ADS סוג קבוצת המודעות בקמפיינים חכמים.
TRAVEL_ADS סוג קבוצת המודעות בקמפיינים ל-Google נסיעות.

AdGroupAdRotationMode

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

טיפוסים בני מנייה (enum)
UNSPECIFIED המצב של סבב המודעות לא צוין.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

OPTIMIZE ביצוע אופטימיזציה למודעות בקבוצת המודעות על סמך קליקים או המרות.
ROTATE_FOREVER סובב באופן שווה באופן שווה.

AdGroupEngineStatus

הסטטוס של המנוע של קבוצת המודעות.

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

הוצא משימוש. אין להשתמש בו.

AD_GROUP_EXPIRED אין מודעות מוצגות בקבוצת המודעות הזו, מפני שתאריך הסיום של קבוצת המודעות חלף.
AD_GROUP_REMOVED קבוצת המודעות נמחקה.
AD_GROUP_DRAFT אין מודעות מוצגות עבור קבוצת המודעות הזו, מאחר שקבוצת המודעות המשויכת עדיין במצב טיוטה.
AD_GROUP_PAUSED קבוצת המודעות הושהתה.
AD_GROUP_SERVING קבוצת המודעות פעילה ומציגה מודעות כרגע.
AD_GROUP_SUBMITTED קבוצת המודעות נשלחה (בסטטוס מדור קודם של Microsoft Bing Ads).
CAMPAIGN_PAUSED לא מוצגות מודעות עבור קבוצת המודעות הזו, מפני שהקמפיין מושהה.
ACCOUNT_PAUSED אין מודעות מוצגות בקבוצת המודעות הזו, כי החשבון מושהה.

TargetingSetting

הגדרות לתכונות שקשורות לטירגוט, ברמת הקמפיין וקבוצת המודעות. מידע נוסף על הגדרת הטירגוט זמין בכתובת https://support.google.com/google-ads/answer/7365594

ייצוג JSON
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
שדות
targetRestrictions[]

object (TargetRestriction)

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

TargetRestriction

רשימת הגדרות הטירגוט לכל מאפיין טירגוט.

ייצוג JSON
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
שדות
targetingDimension

enum (TargetingDimension)

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

bidOnly

boolean

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

TargetingDimension

Enum מתאר מאפייני טירגוט אפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
KEYWORD קריטריונים של מילות מפתח. לדוגמה, 'שייט במאדים'. אפשר להשתמש במילת המפתח KEYWORD כמאפיין מותאם אישית של הצעת מחיר. מילות מפתח הן תמיד מאפיין טירגוט, לכן לא ניתן להגדיר אותן כטירגוט לפי 'הכול' עם TargetRestriction.
AUDIENCE קריטריונים לקהל, שכוללים רשימת משתמשים, תחומי עניין של משתמשים, קהל בהתאמה אישית עם תחום עניין משותף וקהלים בהתאמה אישית עם כוונת רכישה.
TOPIC קריטריונים של נושא לטירגוט קטגוריות של תוכן, לדוגמה, 'category::בעלי חיים>חיות מחמד' משמש לטירגוט לרשת המדיה ולווידאו.
GENDER קריטריונים לטירגוט לפי מגדר.
AGE_RANGE קריטריונים לטירגוט לטווחי גילאים.
PLACEMENT קריטריונים למיקום, הכוללים אתרים כגון 'www.flowers4sale.com', וכן אפליקציות לנייד, קטגוריות של אפליקציות לנייד, סרטוני YouTube וערוצי YouTube.
PARENTAL_STATUS קריטריונים לטירגוט לפי סטטוס הורה.
INCOME_RANGE קריטריונים לטירגוט לפי טווח הכנסה.

AdGroupAd

מודעה בקבוצת מודעות.

ייצוג JSON
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
שדות
resourceName

string

שם המשאב של המודעה. שמות של משאבי מודעות לקבוצות מודעות מופיעים בתבנית:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

הסטטוס של המודעה.

ad

object (Ad)

המודעה.

creationTime

string

חותמת הזמן של מועד היצירה של adGroupAd. התאריך והשעה מוצגים באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss.sssss'. הפורמט.

labels[]

string

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

engineId

string

המזהה של המודעה בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד לחשבון Search Ads 360 בלבד. לדוגמה, Yahoo Japan, Microsoft, Baidu וכו'. אם מדובר בישות שאינה Search Ads 360, משתמשים ב-adGroupAd.ad.id במקום זאת.

engineStatus

enum (AdGroupAdEngineStatus)

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

lastModifiedTime

string

התאריך והשעה שבהם בוצע השינוי האחרון במודעה בקבוצת המודעות הזו. התאריך והשעה מוצגים באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss.sssss'. הפורמט.

AdGroupAdStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

ENABLED המודעה בקבוצת המודעות מופעלת.
PAUSED המודעה בקבוצת המודעות מושהית.
REMOVED המודעה בקבוצת המודעות הוסרה.

AdType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

TEXT_AD המודעה היא מודעת טקסט.
EXPANDED_TEXT_AD המודעה היא מודעת טקסט מורחבת.
CALL_ONLY_AD המודעה היא מודעה לשיחות בלבד.
EXPANDED_DYNAMIC_SEARCH_AD המודעה היא מודעה דינמית מורחבת לרשת החיפוש.
HOTEL_AD המודעה היא מודעה להזמנת חדרים.
SHOPPING_SMART_AD המודעה היא מודעת שופינג חכמה.
SHOPPING_PRODUCT_AD המודעה היא מודעת שופינג רגילה.
VIDEO_AD המודעה היא מודעת וידאו.
GMAIL_AD זו מודעת Gmail.
IMAGE_AD המודעה הזו היא מודעת תמונה.
RESPONSIVE_SEARCH_AD זו מודעה רספונסיבית לרשת החיפוש.
LEGACY_RESPONSIVE_DISPLAY_AD זו מודעה רספונסיבית לרשת המדיה מדור קודם.
APP_AD המודעה היא מודעה לאפליקציה.
LEGACY_APP_INSTALL_AD המודעה היא מודעה להתקנת אפליקציה מדור קודם.
RESPONSIVE_DISPLAY_AD המודעה היא מודעה רספונסיבית לרשת המדיה.
LOCAL_AD המודעה היא מודעה מקומית.
HTML5_UPLOAD_AD המודעה היא מודעה לרשת המדיה מסוג 'העלאה לרשת המדיה' מסוג מוצר מסוג HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD המודעה היא מודעה להעלאה לרשת המדיה שכוללת אחד מסוגי המוצרים DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD המודעה היא מודעה לעידוד השימוש באפליקציה.
SHOPPING_COMPARISON_LISTING_AD המודעה היא מודעת השוואת מחירים.
VIDEO_BUMPER_AD מודעת באמפר בווידאו.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD מודעת וידאו In-stream שלא ניתן לדלג עליה.
VIDEO_OUTSTREAM_AD מודעת וידאו Outstream.
VIDEO_TRUEVIEW_DISCOVERY_AD מודעת וידאו TrueView ברשת המדיה.
VIDEO_TRUEVIEW_IN_STREAM_AD מודעת וידאו TrueView In-stream.
VIDEO_RESPONSIVE_AD מודעת וידאו רספונסיבית.
SMART_CAMPAIGN_AD מודעה בקמפיין חכם.
APP_PRE_REGISTRATION_AD מודעה אוניברסלית לרישום מראש לאפליקציה.
DISCOVERY_MULTI_ASSET_AD מודעת Discovery עם כמה נכסים.
TRAVEL_AD מודעת נסיעות.
DISCOVERY_VIDEO_RESPONSIVE_AD מודעת וידאו רספונסיבית מסוג Discovery.
MULTIMEDIA_AD מודעת מולטימדיה.

SearchAds360TextAdInfo

מודעת טקסט ב-Search Ads 360.

ייצוג JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
שדות
headline

string

הכותרת של המודעה.

description1

string

השורה הראשונה בתיאור המודעה.

description2

string

השורה השנייה של תיאור המודעה.

displayUrl

string

כתובת ה-URL שמוצגת במודעה.

displayMobileUrl

string

כתובת ה-URL לניידים שמוצגת במודעה.

adTrackingId

string (int64 format)

מזהה המעקב של המודעה.

SearchAds360ExpandedTextAdInfo

מודעת טקסט מורחבת ב-Search Ads 360.

ייצוג JSON
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
שדות
headline

string

הכותרת של המודעה.

headline2

string

הכותרת השנייה של המודעה.

headline3

string

הכותרת השלישית של המודעה.

description1

string

השורה הראשונה בתיאור המודעה.

description2

string

השורה השנייה של תיאור המודעה.

path1

string

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

path2

string

טקסט שמצורף לנתיב 1 עם מפריד.

adTrackingId

string (int64 format)

מזהה המעקב של המודעה.

SearchAds360ResponsiveSearchAdInfo

מודעה רספונסיבית לרשת החיפוש ב-Search Ads 360.

ייצוג JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
שדות
headlines[]

object (AdTextAsset)

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

descriptions[]

object (AdTextAsset)

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

path1

string

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

path2

string

טקסט שמצורף לנתיב 1 עם מפריד.

adTrackingId

string (int64 format)

מזהה המעקב של המודעה.

AdTextAsset

נכס טקסט שמשמש בתוך מודעה.

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

string

טקסט של נכס.

SearchAds360ProductAdInfo

אין שדות בסוג הזה.

מודעת מוצר ב-Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

מודעת חיפוש דינמית מורחבת.

ייצוג JSON
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
שדות
description1

string

השורה הראשונה בתיאור המודעה.

description2

string

השורה השנייה של תיאור המודעה.

adTrackingId

string (int64 format)

מזהה המעקב של המודעה.

AdGroupAdEngineStatus

מסכם את הסטטוסים של מנוע AdGroupAd.

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

הוצא משימוש. אין להשתמש בו.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: הקריאייטיב לא אושר.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: כתובת ה-URL לניידים בתהליך בדיקה.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: מודעת הקריאייטיב לא חוקית בנייד אבל תקפה במחשב.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: הקריאייטיב מוכן להפעלה.
AD_GROUP_AD_NOT_REVIEWED Baidu: הקריאייטיב לא נבדק.
AD_GROUP_AD_ON_HOLD

הוצא משימוש. אין להשתמש בו. תבניות שהיו בשימוש בעבר ב-Gemini

AD_GROUP_AD_PAUSED הקריאייטיב הושהה.
AD_GROUP_AD_REMOVED הקריאייטיב הוסר.
AD_GROUP_AD_PENDING_REVIEW הקריאייטיב ממתין לבדיקה.
AD_GROUP_AD_UNDER_REVIEW הקריאייטיב נמצא בבדיקה.
AD_GROUP_AD_APPROVED הקריאייטיב אושר.
AD_GROUP_AD_DISAPPROVED הקריאייטיב נדחה.
AD_GROUP_AD_SERVING הקריאייטיב מוצג.
AD_GROUP_AD_ACCOUNT_PAUSED הקריאייטיב הושהה כי החשבון מושהה.
AD_GROUP_AD_CAMPAIGN_PAUSED הקריאייטיב הושהה מפני שהקמפיין מושהה.
AD_GROUP_AD_AD_GROUP_PAUSED הקריאייטיב הושהה מפני שקבוצת המודעות מושהית.

AdGroupAdLabel

קשר בין מודעה בקבוצת מודעות לבין תווית.

ייצוג JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}
שדות
resourceName

string

שם המשאב של תווית המודעה של קבוצת המודעות. שמות המשאבים של תוויות המודעות ברמת קבוצת המודעות מופיעים בפורמט: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

המודעה בקבוצת המודעות שאליה מצורפת התווית.

label

string

התווית שהוקצתה למודעה בקבוצת המודעות.

AdGroupAsset

קישור בין קבוצת מודעות לנכס.

ייצוג JSON
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
שדות
resourceName

string

שם המשאב של הנכס בקבוצת המודעות. כך נראה השם של המשאבים של AdGroupAsset:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

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

asset

string

חובה. הנכס שמקושר לקבוצת המודעות.

status

enum (AssetLinkStatus)

הסטטוס של הנכס בקבוצת המודעות.

AssetLinkStatus

טיפוסים בני מנייה (enum) שמתאר סטטוסים של קישור לנכס.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED הקישור לנכס מופעל.
REMOVED הקישור לנכס הוסר.
PAUSED הקישור לנכס מושהה.

AdGroupAssetSet

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

ייצוג JSON
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
שדות
resourceName

string

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

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

קבוצת המודעות שאליה מקושר קבוצת הנכסים הזו.

assetSet

string

קבוצת הנכסים שמקושרת לקבוצת המודעות.

status

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

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

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

AdGroupAudienceView

תצוגת קהל של קבוצת מודעות. כולל נתוני ביצועים מרשימות עניין ורשימות רימרקטינג עבור מודעות ברשת המדיה וברשת YouTube, וכן רשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), המצטברים ברמת הקהל.

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

string

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

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

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

ייצוג JSON
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
שדות
resourceName

string

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

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

ההתאמה של הצעת המחיר כאשר הקריטריון תואם. ערך הצירוף חייב להיות בטווח: 0.1 עד 10.0. הטווח הוא בין 1.0 ל-6.0 לתוכן מועדף. יש להשתמש בספרה 0 כדי לבטל את ההסכמה לשימוש בסוג מכשיר.

שדה איחוד criterion. הקריטריון של התאמת הצעת המחיר של קבוצת המודעות הזו.

נדרש בפעולות יצירה שמתחילות ב-V5. criterion יכול להיות רק אחת מהאפשרויות הבאות:

device

object (DeviceInfo)

קריטריון של מכשיר.

DeviceInfo

קריטריון של מכשיר.

ייצוג JSON
{
  "type": enum (Device)
}
שדות
type

enum (Device)

סוג המכשיר.

מכשיר

רשימת המכשירים של Google Ads שזמינים לטירגוט.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
MOBILE ניידים עם דפדפני אינטרנט מלאים.
TABLET טאבלטים עם דפדפנים מלאים.
DESKTOP מחשבים.
CONNECTED_TV טלוויזיות חכמות וקונסולות משחקים.
OTHER סוגי מכשירים אחרים.

AdGroupCriterion

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

ייצוג JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
שדות
resourceName

string

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

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

string

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

status

enum (AdGroupCriterionStatus)

הסטטוס של הקריטריון.

זהו הסטטוס של ישות הקריטריון של קבוצת המודעות, שהוגדר על ידי הלקוח. הערה: דוחות ממשק המשתמש עשויים לכלול מידע נוסף שקובע אם קריטריון כשיר להצגה. במקרים מסוימים, קריטריון שהוסר מה-API עדיין יכול להופיע כמופעל בממשק המשתמש. לדוגמה, כברירת מחדל, קמפיינים מוצגים למשתמשים בכל טווחי הגילאים, אלא אם החרגתם אותם. בממשק המשתמש יוצג הסטטוס 'מופעל' של כל טווח גילאים, מאחר שהמודעות עומדות בדרישות להצגת המודעות. אבל AdGroupCriterion.status יופיע בתור 'הוסרה', כי לא נוסף קריטריון חיובי.

qualityInfo

object (QualityInfo)

מידע בנוגע לאיכות הקריטריון.

type

enum (CriterionType)

סוג הקריטריון.

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

engineId

string

המזהה של הקריטריון של קבוצת המודעות בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבון שאינו חשבון Google Ads. לדוגמה, Yahoo Japan, Microsoft, Baidu וכו'. אם מדובר בישות Google Ads, צריך להשתמש במאפיין adGroupCriterion.criterion_id במקום זאת.

lastModifiedTime

string

התאריך והשעה שבהם השתנה לאחרונה הקריטריון של קבוצת המודעות. התאריך והשעה מוצגים באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss.sssss'. הפורמט.

criterionId

string (int64 format)

המזהה של הקריטריון.

adGroup

string

קבוצת המודעות שאליה שייך הקריטריון.

negative

boolean

האם לטרגט (false) או להחריג (true) את הקריטריון.

השדה הזה לא ניתן לשינוי. כדי לשנות קריטריון מחיובי לשלילי, יש להסיר אותו ולהוסיף אותו מחדש.

bidModifier

number

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

cpcBidMicros

string (int64 format)

הצעת המחיר לקליק (CPC).

effectiveCpcBidMicros

string (int64 format)

הצעת המחיר בפועל לקליק (CPC).

engineStatus

enum (AdGroupCriterionEngineStatus)

סטטוס המנוע של קריטריון של קבוצת מודעות.

finalUrlSuffix

string

תבנית לכתובת URL לצירוף פרמטרים לכתובת ה-URL הסופית.

trackingUrlTemplate

string

תבנית כתובת ה-URL ליצירת כתובת URL למעקב.

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

יש להגדיר אחד בדיוק. criterion יכול להיות רק אחת מהאפשרויות הבאות:

keyword

object (KeywordInfo)

מילת מפתח.

listingGroup

object (ListingGroupInfo)

קבוצה של כרטיסי מוצר.

ageRange

object (AgeRangeInfo)

טווח גילאים.

gender

object (GenderInfo)

מגדר.

userList

object (UserListInfo)

רשימת משתמשים.

webpage

object (WebpageInfo)

דף אינטרנט

location

object (LocationInfo)

מיקום.

AdGroupCriterionStatus

הסטטוסים האפשריים של AdGroupCriterion.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

ENABLED הקריטריון של קבוצת המודעות מופעל.
PAUSED הקריטריון של קבוצת המודעות מושהה.
REMOVED הקריטריון של קבוצת המודעות הוסר.

QualityInfo

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

ייצוג JSON
{
  "qualityScore": integer
}
שדות
qualityScore

integer

ציון האיכות.

יכול להיות שהשדה הזה לא יאוכלס אם אין ל-Google מספיק מידע כדי לקבוע את הערך.

CriterionType

טיפוסים בני מנייה (enum) שמתאר סוגי קריטריונים אפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
KEYWORD מילת מפתח, לדוגמה, 'שייט במאדים'.
PLACEMENT מיקום, המוכר גם בשם 'אתר', לדוגמה, 'www.flowers4sale.com'
MOBILE_APP_CATEGORY קטגוריות של אפליקציות לנייד לטירגוט.
MOBILE_APPLICATION אפליקציות לנייד לטירגוט.
DEVICE מכשירים לטירגוט.
LOCATION מיקומים לטירגוט.
LISTING_GROUP קבוצות של כרטיסי מוצר לטירגוט.
AD_SCHEDULE תזמון הצגת מודעות.
AGE_RANGE טווח גילאים.
GENDER מגדר.
INCOME_RANGE טווח הכנסה.
PARENTAL_STATUS סטטוס הורה.
YOUTUBE_VIDEO סרטון ב-YouTube.
YOUTUBE_CHANNEL ערוץ YouTube.
USER_LIST רשימת משתמשים.
PROXIMITY קירבה.
TOPIC טירגוט לנושא ברשת המדיה (לדוגמה, 'חיות מחמד ובעלי חיים').
LISTING_SCOPE היקף דף האפליקציה לטירגוט.
LANGUAGE שפה.
IP_BLOCK IpBlock.
CONTENT_LABEL תווית תוכן להחרגה של קטגוריה.
CARRIER ספק.
USER_INTEREST קטגוריה שהמשתמש מתעניין בה.
WEBPAGE קריטריון של דף אינטרנט למודעות דינמיות לרשת החיפוש.
OPERATING_SYSTEM_VERSION גרסת מערכת הפעלה.
APP_PAYMENT_MODEL מודל תשלום עבור האפליקציה.
MOBILE_DEVICE מכשיר נייד.
CUSTOM_AFFINITY תחום עניין מותאם אישית.
CUSTOM_INTENT קהל בהתאמה אישית לפי העדפות תוכן.
LOCATION_GROUP קבוצת מיקומים.
CUSTOM_AUDIENCE קהל בהתאמה אישית
COMBINED_AUDIENCE קהל משולב
KEYWORD_THEME נושא של מילות מפתח בקמפיין חכם
AUDIENCE קהל
LOCAL_SERVICE_ID מזהה השירות של מודעות 'Google בעלי מקצוע'.
BRAND מותג
BRAND_LIST רשימת מותגים
LIFE_EVENT אירוע משמעותי בחיים

PositionEstimates

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

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

string (int64 format)

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

AdGroupCriterionEngineStatus

מסכם את הסטטוסים של מנוע AdGroupCriterion.

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

הוצא משימוש. אין להשתמש בו.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: הצעת המחיר או האיכות נמוכה מדי מכדי להופיע.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: הושהתה על ידי Baidu בגלל נפח חיפושים נמוך.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: כתובת ה-URL לניידים בתהליך בדיקה.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: דף הנחיתה של מכשיר אחד לא חוקי, ודף הנחיתה של המכשיר השני תקין.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: מילת המפתח נוצרה ומושהית על ידי ניהול החשבון ב-Baidu, ועכשיו אפשר להפעיל אותה.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: בתהליך בדיקה על ידי Baidu. Gemini: קריטריון בבדיקה.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: קריטריון לבדיקה.
AD_GROUP_CRITERION_ON_HOLD

הוצא משימוש. אין להשתמש בו. תבניות שהיו בשימוש בעבר ב-Gemini

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : הקריטריון בהמתנה לבדיקה
AD_GROUP_CRITERION_PAUSED הקריטריון הושהה.
AD_GROUP_CRITERION_REMOVED הקריטריון הוסר.
AD_GROUP_CRITERION_APPROVED הקריטריון אושר.
AD_GROUP_CRITERION_DISAPPROVED הקריטריון נדחה.
AD_GROUP_CRITERION_SERVING הקריטריון פעיל ומציג מודעות.
AD_GROUP_CRITERION_ACCOUNT_PAUSED הקריטריון הושהה כי החשבון מושהה.

KeywordInfo

קריטריון של מילת מפתח.

ייצוג JSON
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
שדות
matchType

enum (KeywordMatchType)

סוג ההתאמה של מילת המפתח.

text

string

הטקסט של מילת המפתח (80 תווים ו-10 מילים לכל היותר).

KeywordMatchType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EXACT התאמה מדויקת.
PHRASE התאמה לביטוי.
BROAD התאמה רחבה.

ListingGroupInfo

קריטריון של קבוצה של כרטיסי מוצר.

ייצוג JSON
{
  "type": enum (ListingGroupType)
}
שדות
type

enum (ListingGroupType)

סוג הקבוצה של כרטיסי המוצר.

ListingGroupType

סוג הקבוצה של כרטיסי המוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
SUBDIVISION חלוקת משנה של מוצרים לצד מאפיין מסוים של כרטיס המוצר. הצמתים האלה לא משמשים כדי למלא בקשות יעד רשומות, אלא רק להגדיר את מבנה העץ.
UNIT יחידת קבוצה של כרטיסי מוצר שמגדירה הצעת מחיר.

AgeRangeInfo

קריטריון לטווח גילאים.

ייצוג JSON
{
  "type": enum (AgeRangeType)
}
שדות
type

enum (AgeRangeType)

הסוג של טווח הגילאים.

AgeRangeType

סוג טווחי הגילאים הדמוגרפיים (לדוגמה: בין 18 ל-24).

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
AGE_RANGE_18_24 בין 18 ל-24 שנים.
AGE_RANGE_25_34 בין 25 ל-34 שנים.
AGE_RANGE_35_44 בין 35 ל-44 שנים.
AGE_RANGE_45_54 בין 45 ל-54 שנים.
AGE_RANGE_55_64 בין 55 ל-64 שנים.
AGE_RANGE_65_UP בגיל 65 ומעלה.
AGE_RANGE_UNDETERMINED טווח גילאים לא ידוע.

GenderInfo

קריטריון של מגדר.

ייצוג JSON
{
  "type": enum (GenderType)
}
שדות
type

enum (GenderType)

סוג המגדר.

GenderType

הסוג של המגדרים הדמוגרפיים (לדוגמה, נשים).

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

UserListInfo

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

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

string

שם המשאב של רשימת המשתמשים.

WebpageInfo

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

ייצוג JSON
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
שדות
conditions[]

object (WebpageConditionInfo)

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

השדה הזה נדרש לפעולות CREATE, והוא אסור בפעולות UPDATE.

coveragePercentage

number

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

criterionName

string

שם הקריטריון שמוגדר על ידי הפרמטר הזה. ערך השם ישמש לזיהוי, למיון ולסינון של קריטריונים בסוג הפרמטרים הזה.

השדה הזה נדרש לפעולות CREATE, והוא אסור בפעולות UPDATE.

WebpageConditionInfo

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

ייצוג JSON
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
שדות
operand

enum (WebpageConditionOperand)

תנאי לגבי טירגוט לדפי אינטרנט אחרים.

operator

enum (WebpageConditionOperator)

מפעיל של תנאי טירגוט לדפי אינטרנט.

argument

string

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

WebpageConditionOperand

אופרנד של תנאי דף אינטרנט בקריטריון של דף אינטרנט.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
URL אופציה שמציינת תנאי טירגוט לכתובת URL של דף אינטרנט.
CATEGORY אופציה שמציינת תנאי טירגוט לפי קטגוריה של דפי אינטרנט.
PAGE_TITLE אופציה לציון תנאי טירגוט לכותרת של דף אינטרנט.
PAGE_CONTENT אופציה לציון תנאי טירגוט לפי תוכן בדף אינטרנט.
CUSTOM_LABEL מאפיין של אופרנד שמציין תנאי טירגוט לתוויות מותאמות אישית של דף אינטרנט.

WebpageConditionOperator

האופרטור של תנאי דף אינטרנט בקריטריון של דף אינטרנט.

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

LocationInfo

קריטריון של מיקום.

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

string

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

AdGroupCriterionLabel

קשר בין קריטריון של קבוצת מודעות לבין תווית.

ייצוג JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}
שדות
resourceName

string

שם המשאב לתווית הקריטריון של קבוצת המודעות. שמות המשאבים של תוויות קריטריון של קבוצת מודעות מופיעים בפורמט: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

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

label

string

התווית שהוקצתה לקריטריון של קבוצת המודעות.

AdGroupLabel

קשר בין קבוצת מודעות לבין תווית.

ייצוג JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
שדות
resourceName

string

שם המשאב של התווית של קבוצת המודעות. שמות המשאבים של תוויות קבוצת המודעות מופיעים בפורמט: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

adGroup

string

קבוצת המודעות שאליה מצורפת התווית.

label

string

התווית שהוקצתה לקבוצת המודעות.

AgeRangeView

תצוגה של טווח הגילאים.

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

string

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

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

נכס

נכס הוא חלק ממודעה שניתן לשתף במספר מודעות. הנכסים יכולים להיות תמונה (ImageAsset), סרטון (YouTubeVideoAsset) וכו'. הנכסים לא ניתנים לשינוי ואי אפשר להסיר אותם. כדי להפסיק את ההצגה של נכס, צריך להסיר את הנכס מהישות שמשתמשת בו.

ייצוג JSON
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
שדות
resourceName

string

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

סוג הנכס.

finalUrls[]

string

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

status

enum (AssetStatus)

סטטוס הנכס.

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

מזהה הנכס.

name

string

שם אופציונלי של הנכס.

trackingUrlTemplate

string

תבנית לכתובת URL ליצירת כתובת URL למעקב.

engineStatus

enum (AssetEngineStatus)

סטטוס המנוע של נכס.

שדה איחוד asset_data. הסוג הספציפי של הנכס. asset_data יכול להיות רק אחת מהאפשרויות הבאות:
youtubeVideoAsset

object (YoutubeVideoAsset)

נכס וידאו ב-YouTube.

imageAsset

object (ImageAsset)

נכס תמונות.

textAsset

object (TextAsset)

נכס טקסט.

calloutAsset

object (UnifiedCalloutAsset)

נכס יתרונות מרכזיים מאוחד.

pageFeedAsset

object (UnifiedPageFeedAsset)

נכס מאוחד בפיד דפי הנחיתה.

mobileAppAsset

object (MobileAppAsset)

נכס אפליקציה לנייד.

callAsset

object (UnifiedCallAsset)

נכס התקשרות מאוחד.

callToActionAsset

object (CallToActionAsset)

נכס קריאה לפעולה.

locationAsset

object (UnifiedLocationAsset)

נכס מיקום מאוחד.

AssetType

טיפוסים בני מנייה (enum) שמתאר סוגים אפשריים של נכסים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
YOUTUBE_VIDEO נכס וידאו ב-YouTube.
MEDIA_BUNDLE נכס של חבילת מדיה.
IMAGE נכס תמונות.
TEXT נכס טקסט.
LEAD_FORM נכס השארת פרטים.
BOOK_ON_GOOGLE נכס Book on Google (הזמנה דרך Google).
PROMOTION נכס קידום מכירות.
CALLOUT נכס יתרונות מרכזיים.
STRUCTURED_SNIPPET נכס מידע מובנה.
PAGE_FEED נכס של פיד דפי נחיתה.
DYNAMIC_EDUCATION נכס דיגיטלי דינמי לחינוך.
MOBILE_APP נכס אפליקציה לנייד.
HOTEL_CALLOUT נכס יתרונות מרכזיים של מלון.
CALL נכס התקשרות.
PRICE נכס מחיר.
CALL_TO_ACTION נכס של קריאה לפעולה.
DYNAMIC_REAL_ESTATE נכס נדל"ן דינמי.
DYNAMIC_CUSTOM נכס דינמי בהתאמה אישית.
DYNAMIC_HOTELS_AND_RENTALS נכס דינמי של מלונות ויחידות נופש להשכרה.
DYNAMIC_FLIGHTS נכס טיסות דינמי.
DYNAMIC_TRAVEL נכס נסיעות דינמי.
DYNAMIC_LOCAL נכס מקומי דינמי.
DYNAMIC_JOBS נכס משימות דינמי.
LOCATION נכס מיקום.
HOTEL_PROPERTY נכס של נכס מלון.

AssetStatus

הסטטוסים האפשריים של הנכס.

טיפוסים בני מנייה (enum)
UNSPECIFIED הסטטוס לא צוין.
UNKNOWN הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתשובה בלבד.
ENABLED הנכס מופעל.
REMOVED הנכס הוסר.
ARCHIVED הנכס נמצא בארכיון.
PENDING_SYSTEM_GENERATED הנכס נוצר על ידי מערכת ובהמתנה לבדיקת משתמש.

AssetEngineStatus

המזהה הבא = 11

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
SERVING הנכס פעיל.
SERVING_LIMITED הנכס פעיל ומוגבל.
DISAPPROVED הנכס נדחה (לא עומד בדרישות).
DISABLED הנכס לא פעיל (בהמתנה).
REMOVED הנכס הוסר.

YoutubeVideoAsset

נכס ב-YouTube.

ייצוג JSON
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
שדות
youtubeVideoTitle

string

כותרת הסרטון ב-YouTube.

youtubeVideoId

string

מזהה סרטון ב-YouTube. זהו ערך של מחרוזת באורך 11 תווים המשמש בכתובת ה-URL של הסרטון ב-YouTube.

ImageAsset

נכס תמונות.

ייצוג JSON
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
שדות
mimeType

enum (MimeType)

סוג ה-MIME של נכס התמונות.

fullSize

object (ImageDimension)

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

fileSize

string (int64 format)

גודל הקובץ של נכס התמונות בבייטים.

MimeType

סוג MIME

טיפוסים בני מנייה (enum)
UNSPECIFIED סוג MIME לא צוין.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

IMAGE_JPEG סוג MIME של תמונה/jpeg.
IMAGE_GIF סוג MIME של תמונה/GIF.
IMAGE_PNG סוג MIME של תמונה/png.
FLASH סוג MIME של אפליקציה/x-shockwave-Flash.
TEXT_HTML סוג MIME של טקסט/HTML.
PDF סוג MIME של אפליקציה/pdf.
MSWORD סוג MIME של אפליקציה/msword.
MSEXCEL סוג MIME של application/vnd.ms-excel.
RTF סוג MIME של אפליקציה/rtf.
AUDIO_WAV סוג MIME של אודיו/WAV.
AUDIO_MP3 סוג MIME של אודיו/mp3.
HTML5_AD_ZIP סוג MIME של application/x-html5-ad-zip.

ImageDimension

מטא-נתונים של תמונה בגודל מסוים, מקוריים או שונים.

ייצוג JSON
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
שדות
heightPixels

string (int64 format)

גובה התמונה.

widthPixels

string (int64 format)

רוחב התמונה.

url

string

כתובת URL שמחזירה את התמונה בגובה וברוחב האלה.

TextAsset

נכס טקסט.

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

string

תוכן הטקסט של נכס הטקסט.

UnifiedCalloutAsset

נכס יתרונות מרכזיים מאוחד.

ייצוג JSON
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
שדות
calloutText

string

הטקסט של נכס היתרונות המרכזיים. האורך של המחרוזת הזו צריך להיות בין 1 ל-25, כולל.

startDate

string

תאריך ההתחלה של המועד שבו הנכס הזה יהיה בתוקף וניתן יהיה להתחיל להציג אותו, בפורמט yyyy-MM-dd.

endDate

string

התאריך האחרון שבו הנכס הזה יהיה בתוקף ועדיין יוצג, בפורמט yyyy-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

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

useSearcherTimeZone

boolean

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

AdScheduleInfo

מייצג קריטריון של תזמון הצגת מודעות.

תזמון הצגת המודעות מוגדר כיום בשבוע וכמרווח זמן שבו המודעות יוצגו.

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

ייצוג JSON
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
שדות
startMinute

enum (MinuteOfHour)

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

השדה הזה נדרש לפעולות CREATE, והוא אסור בפעולות UPDATE.

endMinute

enum (MinuteOfHour)

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

השדה הזה נדרש לפעולות CREATE, והוא אסור בפעולות UPDATE.

dayOfWeek

enum (DayOfWeek)

היום בשבוע שעליו חל לוח הזמנים.

השדה הזה נדרש לפעולות CREATE, והוא אסור בפעולות UPDATE.

startHour

integer

שעת ההתחלה בפורמט של 24 שעות. השדה הזה חייב להיות מספר בין 0 ל-23, כולל.

השדה הזה נדרש לפעולות CREATE, והוא אסור בפעולות UPDATE.

endHour

integer

שעת סיום בפורמט 24 שעות; 24 מציין את סוף היום. השדה הזה חייב להיות מספר בין 0 ל-24, כולל.

השדה הזה נדרש לפעולות CREATE, והוא אסור בפעולות UPDATE.

MinuteOfHour

חישוב רבע שעות. לדוגמה, "FIFTEEN"

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
ZERO אפס דקות מעבר לשעה.
FIFTEEN ו-15 דקות אחרי השעה.
THIRTY יותר מ-30 דקות אחרי השעה.
FORTY_FIVE ארבעים וחמש דקות אחרי השעה.

DayOfWeek

מציין את הימים בשבוע, לדוגמה, 'יום שני'.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
MONDAY יום שני.
TUESDAY יום שלישי.
WEDNESDAY יום רביעי.
THURSDAY יום חמישי.
FRIDAY יום שישי.
SATURDAY יום שבת.
SUNDAY יום ראשון.

UnifiedSitelinkAsset

נכס Sitelink מאוחד.

ייצוג JSON
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
שדות
description1

string

השורה הראשונה של התיאור של ה-Sitelink. אם מוגדר, האורך צריך להיות בין 1 ל-35, כולל, וצריך להגדיר גם את description2.

description2

string

השורה השנייה של התיאור של ה-Sitelink. אם מגדירים את האורך, צריך להגדיר את האורך בין 1 ל-35, כולל, וגם צריך להגדיר את description1.

startDate

string

תאריך ההתחלה של המועד שבו הנכס הזה יהיה בתוקף וניתן יהיה להתחיל להציג אותו, בפורמט yyyy-MM-dd.

endDate

string

התאריך האחרון שבו הנכס הזה יהיה בתוקף ועדיין יוצג, בפורמט yyyy-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

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

trackingId

string (int64 format)

המזהה שמשמש למעקב אחרי קליקים על נכס ה-Sitelink. זהו חשבון Yahoo! שדה ביפן בלבד.

useSearcherTimeZone

boolean

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

mobilePreferred

boolean

האם ההעדפה היא שנכס ה-Sitelink יוצג במכשירים ניידים. המאמר הזה רלוונטי ל-Microsoft Ads.

UnifiedPageFeedAsset

נכס של פיד דפי נחיתה מאוחד.

ייצוג JSON
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
שדות
pageUrl

string

דף האינטרנט שאליו המפרסמים רוצים לטרגט.

labels[]

string

תוויות שמשמשות לקיבוץ כתובות ה-URL של הדפים.

MobileAppAsset

נכס שמייצג אפליקציה לנייד.

ייצוג JSON
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
שדות
appId

string

חובה. מחרוזת שמשמשת לזיהוי ייחודי של אפליקציה לנייד. הוא צריך להכיל רק את המזהה המקורי של הפלטפורמה, כמו com.android.ebay. ל-Android או ל-'12345689' ל-iOS.

appStore

enum (MobileAppVendor)

חובה. חנות האפליקציות שמפיצה את האפליקציה הספציפית הזו.

MobileAppVendor

סוג הספק של האפליקציה לנייד

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
APPLE_APP_STORE ספק אפליקציות לנייד של Apple App Store.
GOOGLE_APP_STORE ספק של אפליקציה לנייד לחנות אפליקציות של Google.

UnifiedCallAsset

נכס התקשרות מאוחד.

ייצוג JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
שדות
countryCode

string

קוד מדינה בן שתי אותיות של מספר הטלפון. דוגמאות: 'US', 'us'.

phoneNumber

string

מספר הטלפון הגולמי של המפרסם. דוגמאות: '1234567890', '(123)456-7890'

callConversionReportingState

enum (CallConversionReportingState)

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

callConversionAction

string

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

adScheduleTargets[]

object (AdScheduleInfo)

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

callOnly

boolean

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

callTrackingEnabled

boolean

האם צריך להפעיל את השיחה במעקב שיחות. המאמר הזה רלוונטי ל-Microsoft Ads.

useSearcherTimeZone

boolean

הגדרה שקובעת אם להציג את תוסף השיחה באזור הזמן של משתמש החיפוש. המאמר הזה רלוונטי ל-Microsoft Ads.

startDate

string

תאריך ההתחלה של המועד שבו הנכס הזה יהיה בתוקף וניתן יהיה להתחיל להציג אותו, בפורמט yyyy-MM-dd.

endDate

string

התאריך האחרון שבו הנכס הזה יהיה בתוקף ועדיין יוצג, בפורמט yyyy-MM-dd.

CallConversionReportingState

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
DISABLED פעולת ההמרה מסוג שיחה מושבתת.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION פעולת ההמרה מסוג שיחה תשתמש בסוג ההמרה מסוג שיחה שהוגדר ברמת החשבון.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION פעולת המרה מסוג שיחה תשתמש בסוג ההמרה מסוג שיחה שהוגדר ברמת המשאב (מודעות לשיחות בלבד/תוספי שיחה).

CallToActionAsset

נכס קריאה לפעולה.

ייצוג JSON
{
  "callToAction": enum (CallToActionType)
}
שדות
callToAction

enum (CallToActionType)

קריאה לפעולה

CallToActionType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
LEARN_MORE סוג הקריאה לפעולה הוא מידע נוסף.
GET_QUOTE סוג הקריאה לפעולה הוא 'בקשה להצעת מחיר'.
APPLY_NOW סוג הקריאה לפעולה מיושם עכשיו.
SIGN_UP סוג הקריאה לפעולה הוא 'הרשמה'.
CONTACT_US הסוג של הקריאה לפעולה הוא יצירת קשר.
SUBSCRIBE סוג הקריאה לפעולה הוא 'להרשמה'.
DOWNLOAD סוג הקריאה לפעולה הוא הורדה.
BOOK_NOW סוג הקריאה לפעולה הוא 'להזמנה' עכשיו.
SHOP_NOW סוג הקריאה לפעולה הוא 'קנו עכשיו'.
BUY_NOW הסוג 'קריאה לפעולה' הוא 'קנו עכשיו'.
DONATE_NOW סוג הקריאה לפעולה הוא 'לתרומה'.
ORDER_NOW הסוג 'קריאה לפעולה' הוא 'להזמנה עכשיו'.
PLAY_NOW הסוג של הקריאה לפעולה מופעל עכשיו.
SEE_MORE סוגי הקריאה לפעולה הם יותר.
START_NOW הסוג של הקריאה לפעולה מתחיל עכשיו.
VISIT_SITE הסוג של הקריאה לפעולה הוא 'ביקור באתר'.
WATCH_NOW סוג הקריאה לפעולה הוא 'לצפייה עכשיו'.

UnifiedLocationAsset

נכס מיקום מאוחד.

ייצוג JSON
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
שדות
placeId

string

המזהה הייחודי של מקום במסד הנתונים של כתובות ב-Google ובמפות Google. השדה הזה ייחודי למספר לקוח ולסוג נכס מסוימים. מידע נוסף על מזהה מקום זמין בכתובת https://developers.google.com/places/web-service/place-id.

businessProfileLocations[]

object (BusinessProfileLocation)

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

locationOwnershipType

enum (LocationOwnershipType)

סוג הבעלות על המיקום. אם הסוג הוא BUSINESS_OWNER, הוא יוצג כתוסף מיקום. אם הסוג הוא 'שותף עצמאי', הוא יוצג כמיקום של שותף עצמאי.

BusinessProfileLocation

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

ייצוג JSON
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
שדות
labels[]

string

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

storeCode

string

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

listingId

string (int64 format)

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

LocationOwnershipType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BUSINESS_OWNER בעל העסק של המיקום(תוסף מיקום מדור קודם - LE).
AFFILIATE מיקום מקושר(תוסף מיקום של צד שלישי - ALE).

AssetGroupAsset

AssetGroupAsset הוא הקישור בין הנכס לקבוצת נכסים. הוספה של נכס AssetGroupAsset תקשר בין נכס לקבוצת נכסים.

ייצוג JSON
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
שדות
resourceName

string

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

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

קבוצת הנכסים שאליה מקושר הנכס של קבוצת הנכסים הזו.

asset

string

הנכס שאליו מקשר הנכס של קבוצת הנכסים.

fieldType

enum (AssetFieldType)

התיאור של המיקום של הנכס בקבוצת הנכסים. לדוגמה: HEADLINE, YOUTUBE_VIDEO וכו'

status

enum (AssetLinkStatus)

סטטוס הקישור בין הנכס לקבוצת הנכסים.

AssetFieldType

טיפוסים בני מנייה (enum) שמתאר את המיקומים האפשריים של נכס.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
HEADLINE הנכס מקושר לשימוש ככותרת.
DESCRIPTION הנכס מקושר לשימוש כתיאור.
MANDATORY_AD_TEXT הנכס מקושר לשימוש כטקסט חובה של מודעה.
MARKETING_IMAGE הנכס מקושר לשימוש כתמונה שיווקית.
MEDIA_BUNDLE הנכס מקושר לשימוש כחבילת מדיה.
YOUTUBE_VIDEO הנכס מקושר לשימוש כסרטון ב-YouTube.
BOOK_ON_GOOGLE הנכס מקושר כדי לציין שקמפיין לקידום מלון הוא 'הזמנה דרך Google'. מופעל.
LEAD_FORM הנכס מקושר לשימוש כתוסף השארת פרטים.
PROMOTION הנכס מקושר לשימוש כתוסף קידום מכירות.
CALLOUT הנכס מקושר לשימוש כתוסף יתרונות מרכזיים.
STRUCTURED_SNIPPET הנכס מקושר לשימוש כתוסף מידע מובנה.
MOBILE_APP הנכס מקושר לשימוש כתוסף אפליקציה לנייד.
HOTEL_CALLOUT הנכס מקושר לשימוש כתוסף יתרונות מרכזיים של מלון.
CALL הנכס מקושר לשימוש כתוסף שיחה.
PRICE הנכס מקושר לשימוש כתוסף מחיר.
LONG_HEADLINE הנכס מקושר לשימוש ככותרת ארוכה.
BUSINESS_NAME הנכס מקושר לשימוש כשם עסק.
SQUARE_MARKETING_IMAGE הנכס מקושר לשימוש כתמונה שיווקית ריבועית.
PORTRAIT_MARKETING_IMAGE הנכס מקושר לשימוש כתמונה שיווקית בפריסה לאורך.
VIDEO הנכס מקושר לשימוש כלוגו שאינו של YouTube.
CALL_TO_ACTION_SELECTION הנכס מקושר לשימוש כדי לבחור קריאה לפעולה.
AD_IMAGE הנכס מקושר כדי לבחור תמונה למודעה.
HOTEL_PROPERTY הנכס מקושר לשימוש כמלון בקמפיין למיקסום הביצועים לענף התיירות והאירוח.

AssetGroupSignal

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

ייצוג JSON
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
שדות
resourceName

string

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

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

קבוצת הנכסים שאליה שייך האות של קבוצת הנכסים.

שדה איחוד signal. האות של קבוצת הנכסים. signal יכול להיות רק אחת מהאפשרויות הבאות:
audience

object (AudienceInfo)

אות הקהל שישמש בקמפיין למיקסום הביצועים.

AudienceInfo

קריטריון של קהל.

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

string

השם של משאב הקהל.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter מייצג צומת עץ של מסנן קבוצות של כרטיסי מוצר בקבוצת נכסים.

ייצוג JSON
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
שדות
resourceName

string

שם המשאב במסנן הקבוצות של כרטיסי המוצר של קבוצת הנכסים. שם המשאב של מסנן קבוצות כרטיסי המוצר של קבוצת הנכסים ייראה כך:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

קבוצת הנכסים שאליה שייך המסנן של קבוצת כרטיסי המוצר של קבוצת הנכסים.

id

string (int64 format)

המזהה של ה-ListGroupFilter.

type

enum (ListingGroupFilterType)

סוג הצומת של מסנן קבוצות של כרטיסי מוצר.

vertical

enum (ListingGroupFilterVertical)

העמודה האנכית שעץ הצומת הנוכחי מייצג. כל הצמתים באותו עץ חייבים להשתייך לאותו ענף.

caseValue

object (ListingGroupFilterDimension)

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

parentListingGroupFilter

string

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

path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

סוג המסנן של הקבוצות של כרטיסי המוצר.

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

ListingGroupFilterVertical

סוג ענף הסינון של הקבוצות של כרטיסי המוצר.

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

ListingGroupFilterDimension

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

ייצוג JSON
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
שדות
שדה איחוד dimension. המאפיין של אחד מהסוגים הבאים תמיד מופיע. dimension יכול להיות רק אחת מהאפשרויות הבאות:
productBiddingCategory

object (ProductBiddingCategory)

קטגוריית בידינג של מוצר מסוים.

productBrand

object (ProductBrand)

המותג של המוצר.

productChannel

object (ProductChannel)

הרשות המוניציפאלית למוצר מסוים.

productCondition

object (ProductCondition)

המצב של מוצר ספציפי.

productCustomAttribute

object (ProductCustomAttribute)

מאפיין מותאם אישית של מוצר.

productItemId

object (ProductItemId)

מזהה הפריט של המוצר.

productType

object (ProductType)

הסוג של הצעת המוצר.

ProductBiddingCategory

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

ייצוג JSON
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
שדות
level

enum (ListingGroupFilterBiddingCategoryLevel)

מציינת את הרמה של הקטגוריה בטקסונומיה.

id

string (int64 format)

המזהה של קטגוריית הבידינג של המוצר.

המזהה הזה זהה למזהה של google_product_category כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

רמת קטגוריית הבידינג של מסנן הקבוצות של כרטיסי המוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
LEVEL1 רמה 1.
LEVEL2 רמה 2.
LEVEL3 רמה 3.
LEVEL4 רמה 4.
LEVEL5 רמה 5.

ProductBrand

המותג של המוצר.

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

string

ערך המחרוזת של המותג של המוצר.

ProductChannel

הרשות המוניציפאלית למוצר מסוים.

ייצוג JSON
{
  "channel": enum (ListingGroupFilterProductChannel)
}
שדות
channel

enum (ListingGroupFilterProductChannel)

הערך של הרשות המוניציפאלית.

ListingGroupFilterProductChannel

Enum שמתאר את הרשות המוניציפאלית למוצר מסוים.

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

ProductCondition

המצב של מוצר ספציפי.

ייצוג JSON
{
  "condition": enum (ListingGroupFilterProductCondition)
}
שדות
condition

enum (ListingGroupFilterProductCondition)

ערך התנאי.

ListingGroupFilterProductCondition

Enum שמתאר את המצב של מוצר מסוים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
NEW מצב המוצר חדש.
REFURBISHED מצב המוצר מחודש.
USED מצב המוצר נמצא בשימוש.

ProductCustomAttribute

מאפיין מותאם אישית של מוצר.

ייצוג JSON
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
שדות
index

enum (ListingGroupFilterCustomAttributeIndex)

מציין את האינדקס של המאפיין המותאם אישית.

value

string

ערך המחרוזת של המאפיין המותאם אישית של המוצר.

ListingGroupFilterCustomAttributeIndex

האינדקס של מאפייני הלקוח.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
INDEX0 מאפיין מותאם אישית לסינון קבוצות של כרטיסי מוצר ראשון.
INDEX1 מאפיין מותאם אישית של מסנן הקבוצה השנייה של כרטיסי המוצר.
INDEX2 מאפיין מותאם אישית של מסנן הקבוצה השלישית של כרטיסי מוצר.
INDEX3 מאפיין מותאם אישית של מסנן קבוצה רביעית של כרטיסי מוצר.
INDEX4 מאפיין מותאם אישית של מסנן קבוצה חמישית של כרטיסי מוצר.

ProductItemId

מזהה הפריט של המוצר.

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

string

ערך המזהה.

ProductType

הסוג של הצעת המוצר.

ייצוג JSON
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
שדות
level

enum (ListingGroupFilterProductTypeLevel)

רמת הסוג.

value

string

ערך של הסוג.

ListingGroupFilterProductTypeLevel

טיפוסים בני מנייה (enum) שמתאר את הרמה של סוג המוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
LEVEL1 רמה 1.
LEVEL2 רמה 2.
LEVEL3 רמה 3.
LEVEL4 רמה 4.
LEVEL5 רמה 5.

ListingGroupFilterDimensionPath

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

ייצוג JSON
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
שדות
dimensions[]

object (ListingGroupFilterDimension)

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

AssetGroupTopCombinationView

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

ייצוג JSON
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
שדות
resourceName

string

שם המשאב בתצוגת השילוב העליון של קבוצת הנכסים. שמות המשאבים של התצוגות המובילות של AssetGroup מופיעים בפורמט הבא: `"customers/{customerId}/assetGroupTopIntegrationViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

השילובים המובילים של נכסים שהוצגו יחד.

AssetGroupAssetCombinationData

נתוני שילוב נכסים של קבוצת נכסים

ייצוג JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
שדות
assetCombinationServedAssets[]

object (AssetUsage)

הנכסים המוצגים.

AssetUsage

פרטי השימוש בנכס.

ייצוג JSON
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
שדות
asset

string

שם המשאב של הנכס.

servedAssetFieldType

enum (ServedAssetFieldType)

סוג השדה של הצגת המודעות בנכס.

ServedAssetFieldType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

HEADLINE_1 הנכס מופיע בכותרת 1.
HEADLINE_2 הנכס מופיע בכותרת 2.
HEADLINE_3 הנכס מופיע בכותרת 3.
DESCRIPTION_1 הנכס משמש בתיאור 1.
DESCRIPTION_2 הנכס נמצא בשימוש בתיאור 2.
HEADLINE הנכס שימש בכותרת. משתמשים באפשרות הזו רק אם יש במודעה כותרת אחת בלבד. אחרת, אפשר להשתמש במכסות HEADLINE_1, HEADLINE_2 או HEADLINE_3 enum
HEADLINE_IN_PORTRAIT הנכס שימש ככותרת בתמונה לאורך.
LONG_HEADLINE הנכס היה בשימוש בכותרת ארוכה (משמשת ב-MultiAssetResponsiveAd).
DESCRIPTION הנכס שימש בתיאור. יש להשתמש באפשרות הזו רק אם יש במודעה תיאור אחד בלבד. אחרת, השתמש ב-DESCRIPTION_1 או DESCRIPTION_@ enum
DESCRIPTION_IN_PORTRAIT הנכס שימש כתיאור בתמונה לאורך.
BUSINESS_NAME_IN_PORTRAIT הנכס שימש כשם העסק בתמונה לאורך.
BUSINESS_NAME הנכס שימש כשם העסק.
MARKETING_IMAGE הנכס שימש כתמונה שיווקית.
MARKETING_IMAGE_IN_PORTRAIT הנכס שימש כתמונה שיווקית בתמונה לאורך.
SQUARE_MARKETING_IMAGE הנכס שימש כתמונה שיווקית בפורמט ריבועי.
PORTRAIT_MARKETING_IMAGE הנכס שימש כתמונה שיווקית בפריסה לאורך.
CALL_TO_ACTION הנכס שימש כקריאה לפעולה.
YOU_TUBE_VIDEO הנכס שימש כסרטון ב-YouTube.
CALL הנכס הזה משמש כקריאה.
MOBILE_APP הנכס הזה משמש כאפליקציה לנייד.
CALLOUT הנכס הזה משמש כנכס יתרונות מרכזיים.
STRUCTURED_SNIPPET הנכס הזה משמש כנכס מידע מובנה.
PRICE הנכס הזה משמש כמחיר.
PROMOTION הנכס הזה משמש כקידום מכירות.
AD_IMAGE הנכס הזה משמש כתמונה.
LEAD_FORM הנכס משמש כנכס השארת פרטים.

AssetGroup

קבוצת נכסים. הנכס AssetGroupAsset משמש לקישור של נכס לקבוצת הנכסים. השדה AssetGroupSignal משמש לשיוך אות לקבוצת נכסים.

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
שדות
resourceName

string

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

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

המזהה של קבוצת הנכסים.

campaign

string

הקמפיין שאליו משויכת קבוצת הנכסים הזו. הנכס שמקושר לקבוצת הנכסים.

name

string

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

finalUrls[]

string

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

finalMobileUrls[]

string

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

status

enum (AssetGroupStatus)

הסטטוס של קבוצת הנכסים.

path1

string

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

path2

string

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

adStrength

enum (AdStrength)

הציון הכולל של חוזק המודעה בקבוצת הנכסים הזו.

AssetGroupStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED הסטטוס לא צוין.
UNKNOWN הערך שהתקבל לא ידוע בגרסה הזו.
ENABLED קבוצת הנכסים מופעלת.
PAUSED קבוצת הנכסים מושהית.
REMOVED קבוצת הנכסים הוסרה.

AdStrength

ערכים של חוזק המודעה האפשריים.

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

AssetSetAsset

AssetSetAsset הוא הקישור בין נכס לקבוצת נכסים. הוספה של AssetSetAsset תקשר בין נכס לקבוצת נכסים.

ייצוג JSON
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
שדות
resourceName

string

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

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

קבוצת הנכסים שאליה מקושר קבוצת הנכסים הזו.

asset

string

הנכס שאליו מקושר קבוצת הנכסים הזו.

status

enum (AssetSetAssetStatus)

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

AssetSetAssetStatus

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

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

AssetSet

קבוצת נכסים שמייצגת אוסף של נכסים. משתמשים ב- AssetSetAsset כדי לקשר נכס לקבוצת הנכסים.

ייצוג JSON
{
  "id": string,
  "resourceName": string
}
שדות
id

string (int64 format)

המזהה של קבוצת הנכסים.

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

שיטת בידינג.

ייצוג JSON
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
שדות
resourceName

string

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

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

הסטטוס של שיטת הבידינג.

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

type

enum (BiddingStrategyType)

הסוג של שיטת הבידינג. מגדירים את סכימת הבידינג כדי ליצור שיטת בידינג.

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

currencyCode

string

המטבע שמוגדר בשיטת הבידינג (קוד בן שלוש אותיות לפי תקן ISO 4217).

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

id

string (int64 format)

המזהה של שיטת הבידינג.

name

string

השם של שיטת הבידינג. לכל שיטות הבידינג בחשבון צריך לתת שם ייחודי.

האורך של המחרוזת הזו צריך להיות בין 1 ל-255, כולל, בבייטים מסוג UTF-8, (חתוך).

effectiveCurrencyCode

string

המטבע שמוגדר בשיטת הבידינג (קוד בן שלוש אותיות לפי תקן ISO 4217).

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

המדדים של שיטת הבידינג מדווחים במטבע הזה.

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

campaignCount

string (int64 format)

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

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

nonRemovedCampaignCount

string (int64 format)

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

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

שדה איחוד scheme. סכימת הבידינג.

אפשר להגדיר רק הצעה אחת. scheme יכול להיות רק אחת מהאפשרויות הבאות:

enhancedCpc

object (EnhancedCpc)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

שיטת בידינג שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

targetImpressionShare

object (TargetImpressionShare)

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

targetOutrankShare

object (TargetOutrankShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

ENABLED שיטת הבידינג מופעלת.
REMOVED שיטת הבידינג הוסרה.

BiddingStrategyType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
COMMISSION 'עמלה' היא שיטת בידינג אוטומטית שבה המפרסם משלם חלק מסוים מערך ההמרה.
ENHANCED_CPC 'אופטימיזציית עלות לקליק (eCPC)' היא שיטת בידינג שמגדילה את הצעות המחיר לקליקים שיש סיכוי גבוה יותר שיובילו להמרה, ומקטינה את הצעות המחיר לקליקים במקרים שבהם נראה שיש סיכוי נמוך יותר שהם יובילו להמרה.
INVALID משמש רק לערך המוחזר. מעיד על כך שלקמפיין אין שיטת בידינג. הפעולה הזו מונעת את הצגת המודעות בקמפיין. לדוגמה, ייתכן שקמפיין יצורף לשיטת בידינג ניהול, ולאחר מכן הקישור של החשבון להצגת המודעות אל חשבון הניהול יבוטל. במקרה כזה, הקמפיין ינותק באופן אוטומטי משיטת הבידינג של חשבון ניהול שאינו נגישה עכשיו, ויעבור לסוג שיטת הבידינג INVALID.
MANUAL_CPA שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לפי פעולה שצוינה על ידי המפרסם.
MANUAL_CPC בידינג ידני שמבוסס על קליקים, שבו המשתמש משלם לפי קליק.
MANUAL_CPM בידינג ידני מבוסס חשיפות, שבו המשתמש משלם על כל אלף חשיפות.
MANUAL_CPV שיטת בידינג שמשלמת סכום ניתן להגדרה לכל צפייה בסרטון.
MAXIMIZE_CONVERSIONS שיטת בידינג שממקסמת באופן אוטומטי את מספר ההמרות במסגרת תקציב יומי.
MAXIMIZE_CONVERSION_VALUE שיטת בידינג אוטומטית שמגדירה הצעות מחיר באופן אוטומטי כדי למקסם את ההכנסות במסגרת התקציב.
PAGE_ONE_PROMOTED סכמת הצעות מחיר מסוג 'קידום דף ראשון', שמגדירה הצעות מחיר מקסימליות לקליק כך שיטרגטו חשיפות בדף הראשון או בדף מספר 1 ב-google.com. ערך enum הזה הוצא משימוש.
PERCENT_CPC שיטת הבידינג 'אחוז עלות לקליק' היא שיטת בידינג שבה הצעות המחיר הן חלק קטן מהמחיר שפורסם במודעה על מוצר או שירות מסוימים.
TARGET_CPA 'יעד עלות להמרה' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
TARGET_CPM 'יעד עלות לאלף חשיפות' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם לקבל כמה שיותר חשיפות במסגרת יעד העלות לאלף חשיפות (CPM) שהגדרתם.
TARGET_IMPRESSION_SHARE שיטת בידינג אוטומטית שמגדירה הצעות מחיר כך שאחוז מסוים של המודעות לרשת החיפוש יוצג בחלק העליון של הדף הראשון (או מיקום מטורגט אחר).
TARGET_OUTRANK_SHARE 'יעד נתח הובלה בדירוג' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר על סמך נתח היעד במכרזים שבהם המפרסם צריך לקבל דירוג גבוה יותר ממתחרה ספציפי. ערך enum הזה הוצא משימוש.
TARGET_ROAS 'יעד החזר על הוצאות פרסום' היא שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך השגת ממוצע ספציפי של יעד החזר על הוצאות פרסום (ROAS).
TARGET_SPEND 'יעד הוצאות' היא שיטת בידינג אוטומטית. כשמשתמשים בה, המערכת מגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

EnhancedCpc

אין שדות בסוג הזה.

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

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

MaximizeConversionValue

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

ייצוג JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
שדות
cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

targetRoas

number

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

MaximizeConversions

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

ייצוג JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
שדות
cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

targetCpaMicros

string (int64 format)

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

TargetCpa

זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

ייצוג JSON
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
שדות
targetCpaMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetImpressionShare

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

ייצוג JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
location

enum (TargetImpressionShareLocation)

המיקום הגיאוגרפי המטורגט בדף תוצאות החיפוש.

locationFractionMicros

string (int64 format)

החלק הנבחר של המודעות שיוצגו במיקום הגיאוגרפי המטורגט במיליוניות השנייה. לדוגמה, 1% שווה 10,000.

cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

Enum מתאר יעדים אפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ANYWHERE_ON_PAGE כל מיקום בדף האינטרנט.
TOP_OF_PAGE תיבה עליונה עם מודעות.
ABSOLUTE_TOP_OF_PAGE מיקום עליון בתיבה העליונה של המודעות.

TargetOutrankShare

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

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

string (Int64Value format)

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

TargetRoas

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

ייצוג JSON
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
שדות
targetRoas

number

חובה. ההכנסה שנבחרה (על סמך נתוני המרות) לכל יחידת הוצאה. הערך חייב להיות בין 0.01 ל-1000.0, כולל.

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetSpend

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

ייצוג JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
targetSpendMicros
(deprecated)

string (int64 format)

הוצא משימוש: יעד ההוצאות שלפיו יתקבלו מקסימום קליקים. מגיש הצעות מחיר מסוג יעד הוצאת יעד ינסה להוציא את הסכום הנמוך יותר מהערך הזה או את סכום ההוצאה הטבעית. אם לא מציינים זאת, התקציב משמש בתור יעד ההוצאות. השדה הזה הוצא משימוש ולא צריך להשתמש בו יותר. פרטים נוספים זמינים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpcBidCeilingMicros

string (int64 format)

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

CampaignBudget

תקציב לקמפיין.

ייצוג JSON
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
שדות
resourceName

string

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

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

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

ברירת המחדל היא 'STANDARD' אם היא לא מוגדרת בפעולת יצירה.

period

enum (BudgetPeriod)

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

amountMicros

string (int64 format)

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

BudgetDeliveryMethod

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
STANDARD שרת התקציבים יבצע ויסות נתונים (throttle) להצגת מודעות באופן שווה לאורך כל תקופת הזמן.
ACCELERATED שרת התקציב לא יגביל את הצגת המודעות, והמודעות יוצגו במהירות האפשרית.

BudgetPeriod

התקופה האפשרית של התקציב.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
DAILY תקציב יומי.
FIXED_DAILY תקציב יומי קבוע.
CUSTOM_PERIOD אפשר להשתמש בתקציב מותאם אישית יחד עם total_amount כדי לציין מגבלת תקציב לכל משך החיים.

קמפיין

קמפיין.

ייצוג JSON
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
שדות
resourceName

string

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

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

הסטטוס של הקמפיין.

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

servingStatus

enum (CampaignServingStatus)

סטטוס הצגת המודעות של הקמפיין.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

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

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

סטטוס האופטימיזציה של הצגת המודעות בקמפיין.

advertisingChannelType

enum (AdvertisingChannelType)

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

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

ניתן להגדיר אותם רק במהלך יצירת קמפיינים. אחרי שהקמפיין נוצר, אי אפשר לשנות את השדה.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

חידוד אופציונלי ל-advertisingChannelType. חייב להיות סוג משנה חוקי של סוג ערוץ ההורה.

ניתן להגדיר אותם רק במהלך יצירת קמפיינים. אחרי שהקמפיין נוצר, אי אפשר לשנות את השדה.

urlCustomParameters[]

object (CustomParameter)

רשימת המיפויים שמשמשים להחלפת תגים של פרמטרים מותאמים אישית ב-trackingUrlTemplate, ב-finalUrls או ב-mobile_final_urls.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

הגדרות של 'בידינג בזמן אמת'. תכונה זו זמינה רק בקמפיינים שמטרגטים את רשת Ad Exchange.

networkSettings

object (NetworkSettings)

הגדרות הרשת לקמפיין.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

ההגדרה לשליטה במודעות דינמיות לרשת החיפוש (DSA).

shoppingSetting

object (ShoppingSetting)

ההגדרה לשליטה בקמפיינים של שופינג.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

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

labels[]

string

שמות המשאבים של התוויות המצורפות לקמפיין הזה.

biddingStrategyType

enum (BiddingStrategyType)

הסוג של שיטת הבידינג.

כדי ליצור שיטת בידינג, מגדירים את סכימת הבידינג ליצירת שיטת בידינג רגילה, או את השדה biddingStrategy כדי ליצור שיטת בידינג כוללת.

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

accessibleBiddingStrategy

string

שם המשאב של AccessibleBiddingStrategy (שיטת הבידינג) – תצוגה לקריאה בלבד של המאפיינים הבלתי מוגבלים של שיטת הבידינג הכוללת המצורפת, שמזוהה על ידי 'BiddingStrategy'. ריק, אם לא הוגדרה בקמפיין שיטת בידינג כוללת. מאפיינים של שיטה לא מוגבלים זמינים לכל הלקוחות שהשיטה שותפה איתם, ונקראים אותם מהמשאב AccessibleBiddingStrategy. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח שמוגדר כבעלים של השיטה ולמנהלים שלו. אפשר לקרוא מאפיינים מוגבלים רק מהמשאב של שיטת הבידינג.

frequencyCaps[]

object (FrequencyCapEntry)

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

selectiveOptimization

object (SelectiveOptimization)

הגדרת אופטימיזציה סלקטיבית של הקמפיין הזה, שכוללת קבוצה של פעולות המרה שישמשו לאופטימיזציה של הקמפיין. התכונה הזו חלה רק על קמפיינים לקידום אפליקציות שנעשה בהם שימוש ב-MULTI_CHANNEL כ-AdvertisingChannelType וב-APP_CAMPAIGN או APP_CAMPAIGN_FOR_ENGAGEMENT כ-AdvertisingChannelSubType.

optimizationGoalSetting

object (OptimizationGoalSetting)

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

trackingSetting

object (TrackingSetting)

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

engineId

string

המזהה של הקמפיין בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבון שאינו חשבון Google Ads. לדוגמה, Yahoo Japan, Microsoft, Baidu וכו'. אם מדובר בישות Google Ads, יש לציין 'campaign.id' במקום זאת.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

createTime

string

חותמת הזמן של מועד יצירת הקמפיין. חותמת הזמן נמצאת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. הפורמט. הממשק createTime יוצא משימוש בגרסה 1. במקום זאת, אפשר להשתמש ב-createTime.

creationTime

string

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

lastModifiedTime

string

התאריך והשעה שבהם בוצע השינוי האחרון בקמפיין. התאריך והשעה מוצגים באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss.sssss'. הפורמט.

id

string (int64 format)

המזהה של הקמפיין.

name

string

השם של מסע הפרסום.

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

היא לא יכולה להכיל תווי null (נקודת קוד 0x0), פיד שורות NL (נקודת קוד 0xA) או תווי חזרה לתחילת השורה (נקודת קוד 0xD).

trackingUrlTemplate

string

תבנית כתובת ה-URL ליצירת כתובת URL למעקב.

campaignBudget

string

התקציב של הקמפיין.

startDate

string

התאריך שבו הקמפיין התחיל להציג מודעות באזור הזמן של הלקוח בפורמט YYYY-MM-DD.

endDate

string

היום האחרון של הקמפיין באזור הזמן של הצגת המודעות של הלקוח בפורמט YYYY-MM-DD. בזמן היצירה, ברירת המחדל היא 30.12.2037, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר שקמפיין קיים יפעל ללא הגבלת זמן, צריך להגדיר את השדה הזה ל-30.12.2037.

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

מייצג את ביטול ההסכמה לשימוש בהתאמת כתובת URL לכתובות URL ממוקדות יותר. אם מבטלים את ההסכמה לערך (TRUE), המערכת תטרגט רק את כתובות ה-URL הסופיות בקבוצת הנכסים או את כתובות ה-URL שצוינו ב-Google Merchant Center או בפידים של פרטי העסק של המפרסם. אם הבעתם הסכמה (false), כל הדומיין יטרגט. אפשר להגדיר את השדה הזה רק בקמפיינים למיקסום ביצועים שבהם ערך ברירת המחדל הוא False.

שדה איחוד campaign_bidding_strategy. שיטת הבידינג בקמפיין.

חייב להיות שיטת בידינג כוללת (שנוצרה באמצעות שירות שיטת בידינג) או רגילה, שמוטמעת בקמפיין. campaign_bidding_strategy יכול להיות רק אחת מהאפשרויות הבאות:

biddingStrategy

string

שיטת הבידינג הכוללת בקמפיין.

manualCpa

object (ManualCpa)

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

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

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

maximizeConversions

object (MaximizeConversions)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

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

targetCpm

object (TargetCpm)

שיטת בידינג שמבצעת אופטימיזציה אוטומטית של העלות לאלף חשיפות.

CampaignStatus

סטטוסים אפשריים של קמפיין.

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

CampaignServingStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

SERVING מוצג.
NONE ללא.
ENDED הסתיים.
PENDING בהמתנה.
SUSPENDED בהשעיה.

BiddingStrategySystemStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED אותות שאירעה שגיאה בלתי צפויה, למשל, לא נמצא סוג של שיטת בידינג או שלא נמצא פרטי סטטוס.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED אסטרטגיית הצעת המחיר פעילה, ו-AdWords אינו מוצא בעיות ספציפיות באסטרטגיה.
LEARNING_NEW שיטת הבידינג במצב למידה כי היא נוצרה או הופעלה מחדש לאחרונה.
LEARNING_SETTING_CHANGE שיטת הבידינג במצב למידה בגלל שינוי שבוצע לאחרונה בהגדרה.
LEARNING_BUDGET_CHANGE שיטת הבידינג במצב למידה בגלל שינוי בתקציב שבוצע לאחרונה.
LEARNING_COMPOSITION_CHANGE שיטת הבידינג במצב למידה בגלל שינויים שבוצעו לאחרונה במספר הקמפיינים, הקבוצות של המודעות או מילות המפתח שמקושרים אליה.
LEARNING_CONVERSION_TYPE_CHANGE שיטת הבידינג תלויה בדיווח על המרות ובלקוח שינה לאחרונה סוגי המרות שהיו רלוונטיים לשיטת הבידינג.
LEARNING_CONVERSION_SETTING_CHANGE שיטת הבידינג תלויה בדיווח על המרות, והלקוח שינה לאחרונה את הגדרות ההמרות שלו.
LIMITED_BY_CPC_BID_CEILING הסף המינימלי להצעות המחיר ששיטת הבידינג מוגבלת.
LIMITED_BY_CPC_BID_FLOOR שיטת הבידינג מוגבלת על ידי הסף המינימלי להצעות המחיר.
LIMITED_BY_DATA שיטת הבידינג מוגבלת כי לא הייתה מספיק תנועת המרות במהלך השבועות האחרונים.
LIMITED_BY_BUDGET חלק משמעותי ממילות המפתח בשיטת הבידינג הזו מוגבל על-ידי התקציב.
LIMITED_BY_LOW_PRIORITY_SPEND שיטת הבידינג לא יכולה להגיע ליעד ההוצאות שהוגדר לה, כי תעדוף ההוצאות שלה בוטל.
LIMITED_BY_LOW_QUALITY לחלק משמעותי ממילות המפתח בשיטת הבידינג הזו יש ציון איכות נמוך.
LIMITED_BY_INVENTORY שיטת הבידינג לא יכולה למצות את התקציב שלה במלואו בגלל טירגוט מצומצם.
MISCONFIGURED_ZERO_ELIGIBILITY מעקב המרות חסר (לא קיימים פינגים) ו/או רשימות רימרקטינג עבור קמפיינים חכמים לשופינג.
MISCONFIGURED_CONVERSION_TYPES שיטת הבידינג תלויה בדיווח על המרות, ואין ללקוח סוגי המרות שניתן לדווח עליהם בהתאם לשיטה הזו.
MISCONFIGURED_CONVERSION_SETTINGS שיטת הבידינג תלויה בדיווח על המרות והגדרות ההמרות של הלקוח מוגדרות באופן שגוי.
MISCONFIGURED_SHARED_BUDGET יש קמפיינים מחוץ לשיטת הבידינג שחולקים תקציבים עם הקמפיינים שנכללים בשיטת הבידינג.
MISCONFIGURED_STRATEGY_TYPE סוג השיטה של הקמפיין לא חוקי והוא לא מציג מודעות.
PAUSED שיטת הבידינג לא פעילה. אין קבוצות מודעות, מילות מפתח או קמפיינים פעילים שמצורפים לשיטת הבידינג. לחלופין, אין תקציבים פעילים שמקושרים לשיטת הבידינג.
UNAVAILABLE שיטת הבידינג הזו לא תומכת כרגע בדיווח על סטטוס.
MULTIPLE_LEARNING היו כמה סטטוסים של מערכת LEARNING_* לשיטת הבידינג הזו בתקופה הרלוונטית.
MULTIPLE_LIMITED במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת LIMITED_* לשיטת הבידינג הזו.
MULTIPLE_MISCONFIGURED היו מספר סטטוסים של מערכת MISCONFIGURED_* לשיטת הבידינג הזו בתקופה הרלוונטית.
MULTIPLE במהלך התקופה הרלוונטית, שיטת הבידינג הזו קיבלה כמה סטטוסים של המערכת.

AdServingOptimizationStatus

Enum שמתאר סטטוסים אפשריים של הצגת מודעות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

OPTIMIZE הצגת המודעות מתבצעת על סמך שיעור הקליקים של הקמפיין.
CONVERSION_OPTIMIZE הצגת המודעות עוברת אופטימיזציה על סמך שיעור הקליקים * ההמרות בקמפיין. אם הקמפיין לא מוגדר לשיטת הבידינג של כלי אופטימיזציית ההמרות, ברירת המחדל תהיה 'אופטימיזציה'.
ROTATE המודעות מוצגות בסבב באופן שווה במשך 90 יום, ולאחר מכן מתבצעת אופטימיזציה לקבלת יותר קליקים.
ROTATE_INDEFINITELY הצגת מודעות שמניבות ביצועים נמוכים יותר באופן שווה יותר במודעות שמניבות ביצועים טובים יותר, ולא לבצע אופטימיזציה.
UNAVAILABLE סטטוס האופטימיזציה של הצגת המודעות לא זמין.

AdvertisingChannelType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
SEARCH רשת החיפוש. כולל קמפיינים לרשת המדיה וקמפיינים לרשת החיפוש.
DISPLAY רשת המדיה של Google בלבד.
SHOPPING קמפיינים של שופינג מוצגים בנכס השופינג ובתוצאות החיפוש ב-google.com.
HOTEL קמפיינים של מודעות להזמנת חדרים.
VIDEO קמפיינים של מודעות וידאו.
MULTI_CHANNEL קמפיינים לקידום אפליקציות וקמפיינים לעידוד השימוש באפליקציה שפועלים בכמה ערוצים.
LOCAL קמפיינים של מודעות מקומיות.
SMART קמפיינים חכמים.
PERFORMANCE_MAX קמפיינים למיקסום הביצועים.
LOCAL_SERVICES קמפיינים של 'Google בעלי מקצוע'.
DISCOVERY קמפיינים מסוג Discovery.
TRAVEL קמפיינים ל-Google נסיעות.
SOCIAL קמפיינים ברשתות חברתיות.

AdvertisingChannelSubType

Enum שמתאר את סוגי המשנה השונים של הערוצים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש כערך החזרה בלבד. מייצג ערך לא ידוע בגרסה הזו.
SEARCH_MOBILE_APP קמפיינים של אפליקציות לנייד לרשת החיפוש.
DISPLAY_MOBILE_APP קמפיינים של אפליקציות לנייד לרשת המדיה.
SEARCH_EXPRESS קמפיינים של AdWords Express לרשת החיפוש.
DISPLAY_EXPRESS קמפיינים של AdWords Express לרשת המדיה.
SHOPPING_SMART_ADS קמפיינים חכמים לשופינג.
DISPLAY_GMAIL_AD קמפיינים של מודעות Gmail.
DISPLAY_SMART_CAMPAIGN קמפיינים חכמים לרשת המדיה. לא ניתן ליצור קמפיינים חדשים מהסוג הזה.
VIDEO_OUTSTREAM קמפיינים של מודעות וידאו Outstream.
VIDEO_ACTION קמפיינים של מודעות וידאו מסוג TrueView עם קריאה לפעולה.
VIDEO_NON_SKIPPABLE קמפיינים של מודעות וידאו עם מודעות וידאו שלא ניתן לדלג עליהן.
APP_CAMPAIGN קמפיין לקידום אפליקציה מאפשר לכם לקדם בקלות את האפליקציה שלכם ל-Android או ל-iOS בנכסים המובילים של Google, כולל חיפוש Google, Play, YouTube ורשת המדיה של Google.
APP_CAMPAIGN_FOR_ENGAGEMENT קמפיין לעידוד השימוש באפליקציה שמתמקד בעידוד לאינטראקציה חוזרת באפליקציה בכמה מהנכסים המובילים של Google, כולל חיפוש Google, YouTube ורשת המדיה של Google.
LOCAL_CAMPAIGN קמפיינים שמיועדים לפרסום מקומי.
SHOPPING_COMPARISON_LISTING_ADS קמפיינים של השוואת מחירים בשופינג.
SMART_CAMPAIGN קמפיינים חכמים רגילים.
VIDEO_SEQUENCE קמפיינים של מודעות וידאו עם מודעות וידאו בהמשכים.
APP_CAMPAIGN_FOR_PRE_REGISTRATION קמפיין להרשמה לקראת השקת אפליקציה, שמיועד לפרסום של רישום מראש לאפליקציה לנייד. הקמפיין הזה מטרגט כמה ערוצי פרסום ב-Google Play, ב-YouTube וברשת המדיה.
VIDEO_REACH_TARGET_FREQUENCY קמפיין וידאו להגדלת פוטנציאל החשיפה עם שיטת בידינג לתדירות טירגוט.
TRAVEL_ACTIVITIES קמפיינים של פעילויות ב-Google נסיעות.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook עוקב רק אחרי קמפיינים ברשתות חברתיות.

CustomParameter

מיפוי שבו יכולים להשתמש תגי פרמטרים מותאמים אישית ב-trackingUrlTemplate, ב-finalUrls או ב-mobile_final_urls.

ייצוג JSON
{
  "key": string,
  "value": string
}
שדות
key

string

המפתח שתואם לשם של תג הפרמטר.

value

string

הערך להחלפה.

RealTimeBiddingSetting

הגדרות של 'בידינג בזמן אמת'. תכונה זו זמינה רק בקמפיינים שמטרגטים את רשת Ad Exchange.

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

boolean

האם הקמפיין מצורף לבידינג בזמן אמת.

NetworkSettings

הגדרות הרשת לקמפיין.

ייצוג JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
שדות
targetSearchNetwork

boolean

האם המודעות יוצגו באתרים של שותפים ברשת החיפוש של Google (הפרמטר targetGoogleSearch צריך להיות גם true).

targetContentNetwork

boolean

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

targetPartnerSearchNetwork

boolean

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

DynamicSearchAdsSetting

ההגדרה לשליטה במודעות דינמיות לרשת החיפוש (DSA).

ייצוג JSON
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
שדות
domainName

string

חובה. שם הדומיין באינטרנט שההגדרה הזו מייצגת, לדוגמה, 'google.com' או www.google.com.

languageCode

string

חובה. קוד השפה שמציין את שפת הדומיין, לדוגמה, 'en'.

useSuppliedUrlsOnly

boolean

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

ShoppingSetting

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

ייצוג JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
שדות
feedLabel

string

תווית הפיד של המוצרים שייכללו בקמפיין. אפשר להגדיר רק ערך אחד מסוגfeedLabel או salesCountry. אם משתמשים במאפיין הזה במקום salesCountry, השדה feedLabel מקבל קודי מדינות באותו פורמט, לדוגמה: 'XX'. אחרת, הוא יכול להיות כל מחרוזת שמשמשת לתווית פיד ב-Google Merchant Center.

useVehicleInventory

boolean

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

merchantId

string (int64 format)

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

salesCountry

string

מדינת המכירה של המוצרים שייכללו בקמפיין.

campaignPriority

integer

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

enableLocal

boolean

האם לכלול מוצרים בחנויות מקומיות.

GeoTargetTypeSetting

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

ייצוג JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
שדות
positiveGeoTargetType

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

סוגי הטירגוט הגיאוגרפי החיובי האפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
PRESENCE_OR_INTEREST ההגדרה הזו מציינת שמודעה מופעלת אם המשתמש נמצא במיקומים הגיאוגרפיים המטורגטים של המפרסם או מביע בהם עניין.
SEARCH_INTEREST ההגדרה הזו מציינת שמודעה מופעלת אם המשתמש מחפש את המיקומים הגיאוגרפיים המטורגטים של המפרסם. אפשר להשתמש במדד הזה רק בקמפיינים לרשת החיפוש ובקמפיינים רגילים לשופינג.
PRESENCE ההגדרה הזו מציינת שמודעה מופעלת אם המשתמש נמצא במיקומים הגיאוגרפיים המטורגטים של המפרסם או נמצא בהם באופן קבוע.

NegativeGeoTargetType

סוגי היעדים הגיאוגרפיים השליליים האפשריים.

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

FrequencyCapEntry

אין שדות בסוג הזה.

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

SelectiveOptimization

הגדרת אופטימיזציה סלקטיבית של הקמפיין הזה, שכוללת קבוצה של פעולות המרה שישמשו לאופטימיזציה של הקמפיין. התכונה הזו חלה רק על קמפיינים לקידום אפליקציות שנעשה בהם שימוש ב-MULTI_CHANNEL כ-AdvertisingChannelType וב-APP_CAMPAIGN או APP_CAMPAIGN_FOR_ENGAGEMENT כ-AdvertisingChannelSubType.

ייצוג JSON
{
  "conversionActions": [
    string
  ]
}
שדות
conversionActions[]

string

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

OptimizationGoalSetting

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

ייצוג JSON
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
שדות
optimizationGoalTypes[]

enum (OptimizationGoalType)

רשימת הסוגים של יעדי האופטימיזציה.

OptimizationGoalType

הסוג של יעד האופטימיזציה

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

TrackingSetting

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

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

string

כתובת ה-URL שמשמשת למעקב דינמי.

ManualCpa

אין שדות בסוג הזה.

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

ManualCpc

בידינג ידני המבוסס על קליקים, שבו המשתמש משלם לפי קליק.

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

boolean

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

ManualCpm

אין שדות בסוג הזה.

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

PercentCpc

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

ייצוג JSON
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
שדות
cpcBidCeilingMicros

string (int64 format)

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

enhancedCpcEnabled

boolean

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

TargetCpm

אין שדות בסוג הזה.

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

CampaignAsset

קישור בין קמפיין לנכס.

ייצוג JSON
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
שדות
resourceName

string

שם המשאב של נכס הקמפיין. שמות המשאבים של CampaignAsset מופיעים בתבנית:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

הסטטוס של נכס הקמפיין.

campaign

string

הקמפיין שאליו הנכס מקושר.

asset

string

הנכס שמקושר לקמפיין.

CampaignAssetSet

CampaignAssetSet הוא הקישור בין קמפיין לקבוצת נכסים. הוספה של CampaignAssetSet מקשר בין קבוצת נכסים לקמפיין.

ייצוג JSON
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
שדות
resourceName

string

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

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

הקמפיין שאליו קבוצת הנכסים הזו מקושרת.

assetSet

string

קבוצת הנכסים שמקושרת לקמפיין.

status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

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

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

string

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

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

קריטריון של קמפיין.

ייצוג JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
שדות
resourceName

string

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

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

השם המוצג של הקריטריון.

המערכת מתעלמת מהשדה הזה עקב מוטציות.

type

enum (CriterionType)

סוג הקריטריון.

status

enum (CampaignCriterionStatus)

הסטטוס של הקריטריון.

lastModifiedTime

string

התאריך והשעה שבהם השתנה לאחרונה הקריטריון של הקמפיין. התאריך והשעה מוצגים באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss.sssss'. הפורמט.

criterionId

string (int64 format)

המזהה של הקריטריון.

המערכת מתעלמת מהשדה הזה במהלך השינוי.

bidModifier

number

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

negative

boolean

האם לטרגט (false) או להחריג (true) את הקריטריון.

שדה איחוד criterion. הקריטריון של הקמפיין.

יש להגדיר אחד בדיוק. criterion יכול להיות רק אחת מהאפשרויות הבאות:

keyword

object (KeywordInfo)

מילת מפתח.

location

object (LocationInfo)

מיקום.

device

object (DeviceInfo)

מכשיר.

ageRange

object (AgeRangeInfo)

טווח גילאים.

gender

object (GenderInfo)

מגדר.

userList

object (UserListInfo)

רשימת משתמשים.

language

object (LanguageInfo)

שפה.

webpage

object (WebpageInfo)

דף אינטרנט.

locationGroup

object (LocationGroupInfo)

קבוצה לפי מיקום

CampaignCriterionStatus

הסטטוסים האפשריים של CampaignCriterion.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

ENABLED הקריטריון של הקמפיין מופעל.
PAUSED הקריטריון של הקמפיין מושהה.
REMOVED הקריטריון של הקמפיין הוסר.

LanguageInfo

קריטריון שפה.

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

string

שם המשאב הקבוע של השפה.

LocationGroupInfo

רדיוס מסביב לרשימת מיקומים שצוינו בפיד.

ייצוג JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
שדות
geoTargetConstants[]

string

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

radiusUnits

enum (LocationGroupRadiusUnits)

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

feedItemSets[]

string

FeedItemSets שמטורגטים ל-FeedItems שלהם. אם מציינים כמה מזהים, המערכת תטרגט את כל הפריטים שמופיעים בקבוצה אחת לפחות. לא ניתן להשתמש בשדה הזה עם geoTargetConstants. ההגדרה הזו אופציונלית ואפשר להגדיר אותה רק בפעולות CREATE.

radius

string (int64 format)

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

LocationGroupRadiusUnits

יחידת המרחק של הרדיוס בקבוצת המיקומים (לדוגמה, MILES)

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
METERS מטרים
MILES מיילים
MILLI_MILES מילי מיילים

CampaignLabel

מייצג קשר בין קמפיין לבין תווית.

ייצוג JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string
}
שדות
resourceName

string

שם המשאב. שמות המשאבים של תוויות הקמפיין מופיעים בפורמט: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

הקמפיין שאליו מצורפת התווית.

label

string

התווית שהוקצתה לקמפיין.

CartDataSalesView

תצוגת מכירות של נתוני עגלות הקניות

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

string

שם המשאב בתצוגת המכירות של נתוני עגלות הקניות. שמות המשאבים של תצוגת נתוני עגלות הקניות מופיעים בפורמט: customers/{customerId}/cartDataSalesView

קהל

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

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
שדות
resourceName

string

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

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

המזהה של הקהל.

name

string

חובה. שם הקהל. השם צריך להיות ייחודי לכל הקהלים. האורך המינימלי הוא 1 והאורך המקסימלי הוא 255.

description

string

תיאור של הקהל הזה.

ConversionAction

פעולת המרה.

ייצוג JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
שדות
resourceName

string

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

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

חותמת הזמן של יצירת הפעילות ב-Floodlight, בפורמט ISO 8601.

status

enum (ConversionActionStatus)

הסטטוס של פעולת ההמרה הזו לצבירת אירועי המרה.

type

enum (ConversionActionType)

הסוג של פעולת ההמרה הזו.

category

enum (ConversionActionCategory)

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

valueSettings

object (ValueSettings)

הגדרות שקשורות לערך של אירועי ההמרה שמשויכים לפעולת ההמרה הזו.

attributionModelSettings

object (AttributionModelSettings)

הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.

floodlightSettings

object (FloodlightSettings)

הגדרות Floodlight לסוגי ההמרות של Floodlight.

id

string (int64 format)

המזהה של פעולת ההמרה.

name

string

השם של פעולת ההמרה.

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

primaryForGoal

boolean

אם הביט primaryForGoal של פעולת המרה מסוימת הוא False, פעולת ההמרה לא יכולה להגיש הצעות מחיר בכל הקמפיינים, ללא קשר ליעד ההמרה של הלקוח או ליעד ההמרה של הקמפיין. לעומת זאת, יעדי המרה בהתאמה אישית לא מתייחסים ל-PrimaryForGoal, לכן אם בקמפיין הוגדר יעד המרה מותאם אישית שהוגדר כ-PrimaryForGoal = false, אז פעולת ההמרה הזו עדיין יכולה להיות זמינה. כברירת מחדל, הערך של primaryForGoal הוא True אם לא מוגדר. ב-V9, ניתן להגדיר את primaryForGoal כ-False רק לאחר היצירה באמצעות 'עדכון' כי הוא לא מוגדר כאופציונלי.

ownerCustomer

string

שם המשאב של הלקוח שמוגדר כבעלים של פעולת ההמרה, או ערך null אם זו פעולת המרה שהוגדרה על ידי המערכת.

includeInClientAccountConversionsMetric

boolean

אם צריך לכלול את פעולת ההמרה הזו בעמודה clientAccountConversions מדד.

includeInConversionsMetric

boolean

האם צריך לכלול את פעולת ההמרה הזו בעמודה "המרות"? מדד.

clickThroughLookbackWindowDays

string (int64 format)

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

appId

string

מזהה האפליקציה של פעולת המרה באפליקציה.

ConversionActionStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED ההמרות יתועדו.
REMOVED ההמרות לא יתועדו.
HIDDEN ההמרות לא יתועדו ופעולת ההמרה לא תופיע בממשק המשתמש.

ConversionActionType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
AD_CALL המרות שמתרחשות כשמשתמש לוחץ על תוסף שיחה של מודעה.
CLICK_TO_CALL המרות שמתרחשות כשמשתמש בנייד לוחץ על מספר טלפון.
GOOGLE_PLAY_DOWNLOAD המרות שמתרחשות כשמשתמש מוריד אפליקציה לנייד מחנות Google Play.
GOOGLE_PLAY_IN_APP_PURCHASE המרות שמתרחשות כשמשתמש מבצע רכישה באפליקציה באמצעות חיוב ב-Android.
UPLOAD_CALLS המרות מסוג שיחה שהמפרסם עוקב אחריהן והועלו.
UPLOAD_CLICKS המרות שהמפרסם עוקב אחריהן והועלו עם קליקים משויכים.
WEBPAGE המרות שמתרחשות בדף אינטרנט.
WEBSITE_CALL המרות שמתרחשות כשמשתמש מתקשר למספר טלפון שנוצר באופן דינמי מאתר של מפרסם.
STORE_SALES_DIRECT_UPLOAD המרה למכירות בחנות הפיזית על סמך העלאות של נתוני מוכרים מאינטראקציה ישירה או מצד שלישי. רק לקוחות שמופיעים ברשימת ההיתרים יכולים להשתמש בהעלאה ישירה של מכירות בחנות הפיזית.
STORE_SALES המרות למכירות בחנות הפיזית שמבוססות על העלאות של נתוני מוכרים מאינטראקציה ישירה או מצד שלישי ו/או מרכישות בחנות באמצעות כרטיסים מרשתות תשלומים. רק לקוחות שמופיעים ברשימת ההיתרים יכולים להשתמש בסוגים של מכירות בחנות הפיזית. קריאה בלבד.
FIREBASE_ANDROID_FIRST_OPEN המרות מסוג פתיחה ראשונה של אפליקציה ל-Android שמתבצע מעקב אחריהן דרך Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE המרות מסוג רכישה באפליקציה ל-Android שמתבצע מעקב אחריהן דרך Firebase.
FIREBASE_ANDROID_CUSTOM מעקב אחר המרות מותאמות אישית באפליקציות ל-Android דרך Firebase.
FIREBASE_IOS_FIRST_OPEN המרות מסוג 'פתיחה ראשונה של אפליקציה' ל-iOS שמתבצע מעקב אחריהן דרך Firebase.
FIREBASE_IOS_IN_APP_PURCHASE המרות מסוג רכישה באפליקציה ל-iOS שמתבצע אחריהן מעקב דרך Firebase.
FIREBASE_IOS_CUSTOM מתבצע מעקב אחר המרות מותאמות אישית באפליקציות ל-iOS דרך Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN המרות בפתיחה ראשונה של אפליקציה ל-Android שמתבצע מעקב אחריהן באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE המרות מסוג רכישה באפליקציה ל-Android שמתבצע מעקב אחריהן באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM המרות מותאמות אישית באפליקציות ל-Android שמתבצע מעקב אחריהן באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN המרות בפתיחה ראשונה של אפליקציה ל-iOS שמתבצע מעקב אחריהן באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE המרות מסוג רכישה באפליקציה ל-iOS שמתבצעות במעקב באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM המרות מותאמות אישית באפליקציות ל-iOS שמתבצע מעקב אחריהן באמצעות ניתוח נתוני אפליקציות של צד שלישי.
ANDROID_APP_PRE_REGISTRATION המרות שמתרחשות כשמשתמש נרשם מראש לאפליקציה לנייד מחנות Google Play. קריאה בלבד.
ANDROID_INSTALLS_ALL_OTHER_APPS המרות שעוקבות אחרי כל ההורדות מ-Google Play שלא מתבצע אחריהן מעקב לפי סוג ספציפי לאפליקציה. קריאה בלבד.
FLOODLIGHT_ACTION פעילות ב-Floodlight שסופרת את מספר הפעמים שמשתמשים ביקרו בדף אינטרנט מסוים אחרי שראו או לחצו על אחת מהמודעות של מפרסם. קריאה בלבד.
FLOODLIGHT_TRANSACTION פעילות ב-Floodlight שעוקבת אחרי מספר המכירות שבוצעו או מספר הפריטים שנרכשו. היא יכולה גם לתעד את הערך הכולל של כל מכירה. קריאה בלבד.
GOOGLE_HOSTED המרות שעוקבות אחרי פעולות מקומיות ממוצרים ומשירותים של Google אחרי אינטראקציה עם מודעה. קריאה בלבד.
LEAD_FORM_SUBMIT המרות מדווחות כשמשתמש שולח טופס להשארת פרטים. קריאה בלבד.
SALESFORCE ההמרות שמגיעות מ-Salesforce. קריאה בלבד.
SEARCH_ADS_360 ההמרות מיובאות מנתוני Floodlight ב-Search Ads 360. קריאה בלבד.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL המרות מסוג שיחה שמתרחשות במודעות של קמפיינים חכמים בלי להגדיר מעקב אחר שיחות, באמצעות קריטריונים מותאמים אישית של קמפיין חכם. קריאה בלבד.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL המשתמש לוחץ על רכיב התקשרות במפות Google. קמפיין חכם בלבד. קריאה בלבד.
SMART_CAMPAIGN_MAP_DIRECTIONS המשתמש מבקש מסלול הגעה למיקום של עסק במפות Google. קמפיין חכם בלבד. קריאה בלבד.
SMART_CAMPAIGN_TRACKED_CALLS המרות מסוג שיחה שמתרחשות במודעות של קמפיינים חכמים שמוגדרת בהם מעקב שיחות, באמצעות קריטריונים מותאמים אישית של קמפיינים חכמים. קריאה בלבד.
STORE_VISITS המרות שמתרחשות כשמשתמש מבקר בחנות הקמעונאית של המפרסם. קריאה בלבד.
WEBPAGE_CODELESS המרות שנוצרו מאירועים באתר (כמו שליחות של טפסים או טעינות של דפים), שלא נעשה בהן שימוש בקטעי קוד של אירועים (event snippet) שמקודדים בנפרד. קריאה בלבד.
UNIVERSAL_ANALYTICS_GOAL המרות שמגיעות ממטרות עסקיות מקושרות של Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION המרות שמגיעות מעסקאות מקושרות ב-Universal Analytics.
GOOGLE_ANALYTICS_4_CUSTOM המרות שמגיעות מהמרות מקושרות מאירועים מותאמים אישית ב-Google Analytics 4.
GOOGLE_ANALYTICS_4_PURCHASE המרות שמגיעות מהמרות מסוג רכישה מקושרות ב-Google Analytics 4.

ConversionActionCategory

הקטגוריה של ההמרות שמשויכות לפעולת ההמרה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
DEFAULT קטגוריית ברירת מחדל.
PAGE_VIEW משתמש נכנס לדף מסוים.
PURCHASE רכישה, מכירות או "הזמנה" אירוע.
SIGNUP פעולת משתמש בהרשמה.
LEAD פעולה של יצירת לידים.
DOWNLOAD פעולת הורדת תוכנה (כמו אפליקציה).
ADD_TO_CART הוספת פריטים לעגלת קניות או לסל קניות באתר של מפרסם.
BEGIN_CHECKOUT כשמשתמש מתחיל בתהליך התשלום באתר של מפרסם.
SUBSCRIBE_PAID התחלה של מינוי בתשלום למוצר או לשירות.
PHONE_CALL_LEAD קריאה כדי לציין התעניינות בהצעה של מפרסם.
IMPORTED_LEAD המרת ליד שיובאה ממקור חיצוני אל Google Ads.
SUBMIT_LEAD_FORM שליחת טופס באתר של מפרסם שמעיד על עניין בעסק.
BOOK_APPOINTMENT קביעת פגישה עם עסק של מפרסם.
REQUEST_QUOTE בקשה להצעת מחיר או הערכת מחיר.
GET_DIRECTIONS חיפוש של מיקום העסק של מפרסם מתוך כוונה לבקר בו.
OUTBOUND_CLICK קליק למעבר לאתר של שותף.
CONTACT שיחה, SMS, אימייל, צ'אט או יצירת קשר מסוג אחר עם המפרסם.
ENGAGEMENT אירוע של התעניינות באתר, כמו זמן ארוך באתר או יעד חכם של Google Analytics (GA). מיועד לשימוש לצורך ייבוא מטרות עסקיות מ-Google Analytics, מ-Firebase ומ-Google Analytics.
STORE_VISIT ביקור במיקום של חנות פיזית.
STORE_SALE מכירה שמתרחשת בחנות פיזית.
QUALIFIED_LEAD המרה מסוג ליד שיובאה ממקור חיצוני אל Google Ads, שעברה התאמה נוספת על ידי המפרסם (צוות השיווק/המכירות). במסלול מהליד למכירה, המפרסמים מקבלים לידים, ואז פונים לצרכנים כדי לפעול בהתאם להם. אם הצרכן מעוניין וייתכן שבסופו של דבר יקנה את המוצר, המפרסם יסמן לידים כאלה כ'לידים כשירים'.
CONVERTED_LEAD המרה מסוג ליד שיובאה ממקור חיצוני ל-Google Ads והשלימה את השלב שנבחר, כפי שהוגדר על ידי המפרסם ליצירת לידים.

ValueSettings

הגדרות שקשורות לערך של אירועי ההמרה שמשויכים לפעולת ההמרה הזו.

ייצוג JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
שדות
defaultValue

number

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

defaultCurrencyCode

string

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

alwaysUseDefaultValue

boolean

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

AttributionModelSettings

הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.

ייצוג JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
שדות
attributionModel

enum (AttributionModel)

סוג מודל השיוך (Attribution) של פעולת ההמרה הזו.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

הסטטוס של מודל השיוך מבוסס-הנתונים של פעולת ההמרה.

AttributionModel

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EXTERNAL נעשה שימוש בשיוך חיצוני.
GOOGLE_ADS_LAST_CLICK המערכת משייכת את כל הקרדיט על המרה לקליק האחרון שלה.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK המערכת משייכת את כל הקרדיט על המרה לקליק הראשון שלה באמצעות השיוך ברשת החיפוש של Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR המערכת משייכת קרדיט על המרה באופן שווה בין כל הקליקים שבוצעו לה באמצעות השיוך (Attribution) בחיפוש Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY המערכת משייכת קרדיט רב יותר על המרה לקליקים שבוצעו לאחרונה באמצעות השיוך בחיפוש Google (חצי משך החיים הוא שבוע אחד).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED המערכת משייכת 40% מהקרדיט על ההמרה לקליק הראשון ולקליק האחרון שלה. 20% הנותרים מתחלקים באופן שווה בין כל הקליקים האחרים. ההגדרה הזו מבוססת על מודל השיוך של חיפוש Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN מודל גמיש שמשתמש בלמידת מכונה כדי לקבוע את חלוקת הקרדיט המתאימה בין הקליקים, באמצעות שיוך בחיפוש Google.

DataDrivenModelStatus

חישוב הסטטוסים של מודלים מבוססי-נתונים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
AVAILABLE המודל מבוסס-הנתונים זמין.
STALE המודל מבוסס-הנתונים לא פעיל. הוא לא עודכן במשך 7 ימים לפחות. החשבון עדיין נמצא בשימוש, אבל התוקף שלו יפוג אם לא יתבצע עדכון במשך 30 ימים.
EXPIRED התוקף של המודל מבוסס-הנתונים פג. החשבון לא עודכן במשך 30 יום לפחות, ואי אפשר להשתמש בו. בדרך כלל הסיבה לכך היא שלא היו מספר האירועים הנדרש בתקופה של 30 הימים האחרונים.
NEVER_GENERATED המודל מבוסס-הנתונים מעולם לא נוצר. בדרך כלל הסיבה לכך היא שאף פעם לא היה מספר האירועים הנדרש בתקופה של 30 יום.

FloodlightSettings

הגדרות שקשורות לפעולת המרה מ-Floodlight.

ייצוג JSON
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
שדות
activityGroupTag

string

מחרוזת שמשמשת לזיהוי קבוצת פעילות ב-Floodlight בדיווח על המרות.

activityTag

string

מחרוזת שמשמשת לזיהוי פעילות ב-Floodlight בזמן דיווח על המרות.

activityId

string (int64 format)

מזהה הפעילות של Floodlight ב-DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

משתנה מותאם אישית של המרה. מידע נוסף זמין במאמר 'מידע על מדדים ומאפיינים של Floodlight בממשק החדש של Search Ads 360' בכתובת https://support.google.com/sa360/answer/13567857

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
שדות
resourceName

string

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

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

המזהה של המשתנה המותאם אישית של ההמרה.

name

string

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

tag

string

חובה. התג של המשתנה המותאם אישית של ההמרה. התג צריך להיות ייחודי ולכלול u ולאחר מכן יש מספר קטן מ-ormequal עד 100. לדוגמה: 'u4'.

status

enum (ConversionCustomVariableStatus)

הסטטוס של המשתנה המותאם אישית של ההמרה לצבירת אירועי המרה.

ownerCustomer

string

שם המשאב של הלקוח שהוא הבעלים של המשתנה המותאם אישית של ההמרה.

family

enum (ConversionCustomVariableFamily)

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

cardinality

enum (ConversionCustomVariableCardinality)

העוצמה של המשתנה המותאם אישית של ההמרה.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

שדות של משתני המרות מותאמים אישית ב-Floodlight ב-Search Ads 360.

customColumnIds[]

string (int64 format)

המזהים של עמודות בהתאמה אישית שנעשה בהן שימוש במשתנה המותאם אישית של ההמרה.

ConversionCustomVariableStatus

סטטוסים אפשריים של משתנה מותאם אישית של המרה.

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

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

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

ENABLED המשתנה המותאם אישית של ההמרה מופעל ויצבור נתונים סטטיסטיים.
PAUSED המשתנה המותאם אישית של ההמרה מושהה ולא יצבור נתונים סטטיסטיים עד שיוגדר שוב כ'מופעל'.

ConversionCustomVariableFamily

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
STANDARD המשתנה המותאם אישית של ההמרה הרגילה. הלקוחות נדרשים להפעיל את המינוי לפני השימוש.
FLOODLIGHT משתנה ההמרה המותאם אישית שיובא ממשתנה מותאם אישית של Floodlight.

ConversionCustomVariableCardinality

העוצמה של משתנה מותאם אישית של המרה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BELOW_ALL_LIMITS העוצמה של משתנה ההמרה המותאם אישית נמוכה מכל המגבלות. ניתן להשתמש במשתנה לפילוח, ויכול להיות שנתונים סטטיסטיים יצטברו לגבי ערכים חדשים אם המשתנה מופעל.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT העוצמה (cardinality) של המשתנה המותאם אישית של ההמרה חורגת ממגבלת הפילוח, אבל לא חורגת ממגבלת הנתונים הסטטיסטיים. הפילוח יושבת, אבל אפשר לצבור נתונים סטטיסטיים לגבי ערכים חדשים אם המשתנה מופעל.
APPROACHES_STATS_LIMIT המשתנה המותאם אישית של ההמרה חרג ממגבלות הפילוח, והוא מתקרב למגבלת הנתונים הסטטיסטיים (יותר מ-90%). הפילוח יושבת, אבל אפשר לצבור נתונים סטטיסטיים לגבי ערכים חדשים אם המשתנה מופעל.
EXCEEDS_STATS_LIMIT המשתנה המותאם אישית של ההמרה חרג ממגבלות הפילוח וגם ממגבלות הנתונים הסטטיסטיים. הפילוח יושבת, והנתונים הסטטיסטיים של המשתנים הפעילים יכולים להצטבר רק אם הערכים הקיימים לא מגדילים עוד את העוצמה של המשתנה.

FloodlightConversionCustomVariableInfo

מידע על משתנים מותאמים אישית של המרות ב-Search Ads 360 Floodlight

ייצוג JSON
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
שדות
floodlightVariableType

enum (FloodlightVariableType)

סוג המשתנה ב-Floodlight שמוגדר ב-Search Ads 360.

floodlightVariableDataType

enum (FloodlightVariableDataType)

סוג הנתונים של המשתנים ב-Floodlight שמוגדר ב-Search Ads 360.

FloodlightVariableType

סוג המשתנה של Floodlight, כפי שמוגדר ב-Search Ads 360. מידע נוסף זמין בכתובת https://support.google.com/searchads/answer/4397154?hl=en.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
DIMENSION סוג המשתנה של המאפיין Floodlight.
METRIC סוג משתנה Floodlight של מדד.
UNSET סוג המשתנה של Floodlight לא מוגדר.

FloodlightVariableDataType

סוג הנתונים של משתנה Floodlight, כפי שמוגדר ב-Search Ads 360. מידע נוסף זמין בכתובת https://support.google.com/searchads/answer/4397154?hl=en.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
NUMBER מייצג משתנה Floodlight של "Number" מהסוג הזה. אפשר להקצות את המשתנה הזה למשתני Floodlight מסוג Dimensions או METRIC.
STRING מייצג משתנה Floodlight של "String" מהסוג הזה. אפשר להקצות את המשתנה הזה למשתני Floodlight מסוג מימד.

לקוח

לקוח.

ייצוג JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
שדות
resourceName

string

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

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

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

accountType

enum (AccountType)

סוג חשבון מנוע חיפוש. לדוגמה, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track וכו'.

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

הגדרת DoubleClick Campaign Manager (DCM) ללקוח הניהול.

accountStatus

enum (AccountStatus)

סטטוס החשבון, לדוגמה, 'מופעל', 'מושהה', 'הוסר' וכו'.

lastModifiedTime

string

התאריך והשעה שבהם הלקוח הזה השתנה לאחרונה. התאריך והשעה מוצגים באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss.sssss'. הפורמט.

engineId

string

המספר המזהה של החשבון בחשבון מנוע החיפוש החיצוני.

status

enum (CustomerStatus)

הסטטוס של הלקוח.

creationTime

string

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

id

string (int64 format)

המזהה של הלקוח.

descriptiveName

string

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

currencyCode

string

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

timeZone

string

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

trackingUrlTemplate

string

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

finalUrlSuffix

string

תבנית כתובת ה-URL לצירוף פרמטרים לכתובת ה-URL הסופית.

autoTaggingEnabled

boolean

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

manager

boolean

האם הלקוח הוא מנהל.

ConversionTrackingSetting

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

ייצוג JSON
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": 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 עושה זאת). השדה הזה הוא לקריאה בלבד.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

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

crossAccountConversionTrackingId

string (int64 format)

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

ConversionTrackingStatus

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

טיפוסים בני מנייה (enum)
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 של הבקשה.

AccountType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BAIDU חשבון Baidu.
ENGINE_TRACK חשבון Engine Track.
FACEBOOK חשבון Facebook.
FACEBOOK_GATEWAY חשבון Facebook מנוהל דרך שער.
GOOGLE_ADS חשבון Google Ads.
MICROSOFT חשבון Microsoft Advertising.
SEARCH_ADS_360 חשבון ניהול ב-Search Ads 360.
YAHOO_JAPAN חשבון ב-Yahoo Japan.

DoubleClickCampaignManagerSetting

הגדרת DoubleClick Campaign Manager (DCM) ללקוח הניהול.

ייצוג JSON
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
שדות
advertiserId

string (int64 format)

המזהה של המפרסם ב-Campaign Manager שמשויך ללקוח הזה.

networkId

string (int64 format)

המזהה של רשת Campaign Manager שמשויכת ללקוח הזה.

timeZone

string

אזור הזמן ברשת Campaign Manager שמשויכת ללקוח הזה בפורמט מסד נתונים של אזור זמן IANA, כמו America/New_York.

AccountStatus

סטטוסים אפשריים של חשבון.

טיפוסים בני מנייה (enum)
UNSPECIFIED ערך ברירת המחדל.
UNKNOWN ערך לא ידוע.
ENABLED החשבון יכול להציג מודעות.
PAUSED החשבון הושבת על ידי המשתמש.
SUSPENDED חשבון מושבת על ידי תהליך פנימי.
REMOVED החשבון מושבת באופן סופי.
DRAFT החשבון עדיין נמצא בתהליך ההגדרה, עדיין לא מופעל.

CustomerStatus

סטטוסים אפשריים של לקוח.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED מציין חשבון פעיל שיכול להציג מודעות.
CANCELED מעיד על כך שחשבון מבוטל לא יכול להציג מודעות. ניתן להפעיל מחדש על ידי משתמש עם הרשאת אדמין.
SUSPENDED מעיד על כך שחשבון מושעה לא יכול להציג מודעות. ניתן להפעיל רק על ידי התמיכה של Google.
CLOSED מצביע על חשבון שנסגר ולא ניתן להציג מודעות. גם הסטטוס של חשבון הבדיקה יהיה 'סגור'. הסטטוס הוא קבוע ולא ניתן לפתוח אותו מחדש.

CustomerAsset

קישור בין לקוח לנכס.

ייצוג JSON
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
שדות
resourceName

string

שם המשאב של נכס הלקוח. שמות המשאבים של CustomerAsset מופיעים בתבנית:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

חובה. הנכס שמקושר ללקוח.

status

enum (AssetLinkStatus)

הסטטוס של נכס הלקוח.

CustomerAssetSet

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

ייצוג JSON
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
שדות
resourceName

string

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

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

קבוצת הנכסים שמקושרת ללקוח.

customer

string

הלקוח שאליו קבוצת הנכסים הזו מקושרת.

status

enum (AssetSetLinkStatus)

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

AccessibleBiddingStrategy

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

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

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
שדות
resourceName

string

שם המשאב של שיטת הבידינג הנגישה. שמות של משאבים מסוג AccessibleBiddingStrategy:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

המזהה של שיטת הבידינג.

name

string

השם של שיטת הבידינג.

type

enum (BiddingStrategyType)

הסוג של שיטת הבידינג.

ownerCustomerId

string (int64 format)

מזהה הלקוח שבבעלותו שיטת הבידינג.

ownerDescriptiveName

string

descriptionName של הלקוח ששיטת הבידינג נמצאת בבעלותו.

שדה איחוד scheme. סכימת הבידינג.

אפשר להגדיר רק הצעה אחת. scheme יכול להיות רק אחת מהאפשרויות הבאות:

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

שיטת בידינג שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

ייצוג JSON
{
  "targetRoas": number
}
שדות
targetRoas

number

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

MaximizeConversions

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

ייצוג JSON
{
  "targetCpa": string,
  "targetCpaMicros": string
}
שדות
targetCpa

string (int64 format)

האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שברצונך להוציא על כל רכישה.

targetCpaMicros

string (int64 format)

האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שברצונך להוציא על כל רכישה.

TargetCpa

זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

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

string (int64 format)

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

TargetImpressionShare

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

ייצוג JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
location

enum (TargetImpressionShareLocation)

המיקום הגיאוגרפי המטורגט בדף תוצאות החיפוש.

locationFractionMicros

string (int64 format)

החלק הנבחר של המודעות שיוצגו במיקום הגיאוגרפי המטורגט במיליוניות השנייה. לדוגמה, 1% שווה 10,000.

cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

ייצוג JSON
{
  "targetRoas": number
}
שדות
targetRoas

number

ההכנסה שנבחרה (על סמך נתוני המרות) לכל יחידת הוצאה.

TargetSpend

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

ייצוג JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
targetSpendMicros
(deprecated)

string (int64 format)

יעד ההוצאות שבמסגרתו יש לקבל מקסימום קליקים. מגיש הצעות מחיר מסוג יעד הוצאת יעד ינסה להוציא את הסכום הנמוך יותר מהערך הזה או את סכום ההוצאה הטבעית. אם לא מציינים זאת, התקציב משמש בתור יעד ההוצאות. השדה הזה הוצא משימוש ולא צריך להשתמש בו יותר. פרטים נוספים זמינים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpcBidCeilingMicros

string (int64 format)

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

ManagerLinkStatus

סטטוסים אפשריים של קישור.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ACTIVE מציין את הקשר הנוכחי שבתוקף
INACTIVE מציין מערכת יחסים שהסתיימה
PENDING מעיד על כך שהמנהל ביקש את הקשר אבל הלקוח עדיין לא אישר את הקשר.
REFUSED המנהל ביקש לקשר אותו, אבל הלקוח סירב.
CANCELED מעיד על כך שהמנהל ביקש את הקשר, אבל המנהל ביטל אותו.

CustomerClient

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

ייצוג JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
שדות
resourceName

string

שם המשאב של הלקוח של הלקוח. שמות משאבי הלקוח מופיעים בפורמט: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

הסטטוס של הלקוח/ה. קריאה בלבד.

clientCustomer

string

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

hidden

boolean

מציינת אם החשבון הזה מוסתר.

קריאה בלבד.

level

string (int64 format)

המרחק בין הלקוח הנתון ללקוח. בקישור העצמי, ערך הרמה יהיה 0. קריאה בלבד.

timeZone

string

ייצוג מחרוזת נפוץ של נתוני מיקום (CLDR) של אזור הזמן של הלקוח, לדוגמה, America/Los_Angeles. קריאה בלבד.

testAccount

boolean

מזהה אם הלקוח הוא חשבון בדיקה. קריאה בלבד.

manager

boolean

מזהה אם הלקוח הוא מנהל. קריאה בלבד.

descriptiveName

string

שם תיאורי של הלקוח. קריאה בלבד.

currencyCode

string

קוד המטבע של הלקוח (לדוגמה, 'USD', 'EUR'). קריאה בלבד.

id

string (int64 format)

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

DynamicSearchAdsSearchTermView

תצוגת מונחי חיפוש של מודעות דינמיות לרשת החיפוש.

ייצוג JSON
{
  "resourceName": string,
  "landingPage": string
}
שדות
resourceName

string

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

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

כתובת דף הנחיתה של החשיפה שנבחרה באופן דינמי.

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

GenderView

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

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

string

שם המשאב בתצוגת המגדר. שמות המשאבים בתצוגת המגדר מופיעים בתבנית:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

קבוע של טירגוט גיאוגרפי.

ייצוג JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
שדות
resourceName

string

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

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

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

id

string (int64 format)

המזהה של קבוע הטירגוט הגיאוגרפי.

name

string

טירגוט גיאוגרפי לשם קבוע באנגלית.

countryCode

string

קוד המדינה בפורמט ISO-3166-1 alpha-2 שמשויך ליעד.

targetType

string

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

canonicalName

string

השם המלא באנגלית, הכולל את שם היעד ואת השם של ההורה והמדינה שבה הוא נמצא.

parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

ENABLED קבוע הטירגוט הגיאוגרפי תקין.
REMOVAL_PLANNED קבוע הטירגוט הגיאוגרפי מיושן והוא יוסר.

KeywordView

תצוגה של מילות מפתח.

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

string

שם המשאב בתצוגת מילות המפתח. שמות המשאבים של תצוגות מילות המפתח מופיעים בתבנית:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

תווית

תווית.

ייצוג JSON
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
שדות
resourceName

string

שם המשאב. שמות המשאבים של התוויות מופיעים בפורמט: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

סטטוס התווית. קריאה בלבד.

textLabel

object (TextLabel)

סוג של תווית שמציגה טקסט על רקע צבעוני.

id

string (int64 format)

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

name

string

שם התווית.

זהו שדה חובה ולא יכול להיות ריק כשיוצרים תווית חדשה.

האורך של המחרוזת הזו צריך להיות בין 1 ל-80, כולל.

LabelStatus

סטטוסים אפשריים של תווית.

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

TextLabel

סוג של תווית שמציגה טקסט על רקע צבעוני.

ייצוג JSON
{
  "backgroundColor": string,
  "description": string
}
שדות
backgroundColor

string

צבע הרקע של התווית בפורמט HEX. המחרוזת הזו חייבת להתאים לביטוי הרגולרי '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. הערה: יכול להיות שצבע הרקע לא יוצג בחשבונות ניהול.

description

string

תיאור קצר של התווית. האורך המרבי הוא 200 תווים.

LanguageConstant

שפה.

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
שדות
resourceName

string

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

languageConstants/{criterionId}

id

string (int64 format)

המזהה של קבוע השפה.

code

string

קוד השפה, לדוגמה, "en_US" , "en_AU" , "es" , "fr" וכו'.

name

string

השם המלא של השפה באנגלית, לדוגמה: "אנגלית (ארה"ב)", "ספרדית" וכו'.

targetable

boolean

האם ניתן לטרגט את השפה.

LocationView

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

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

string

שם המשאב בתצוגת המיקום. שמות משאבים בתצוגת מיקום מופיעים בתבנית:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

קטגוריה של בידינג לפי מוצר.

ייצוג JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
שדות
resourceName

string

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

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

הרמה של קטגוריית הבידינג של המוצר.

status

enum (ProductBiddingCategoryStatus)

הסטטוס של קטגוריית הבידינג של המוצר.

id

string (int64 format)

המזהה של קטגוריית הבידינג של המוצר.

המזהה הזה זהה למזהה במאפיין google_product_category, כפי שמתואר במאמר https://support.google.com/merchants/answer/6324436.

countryCode

string

קוד מדינה בן 2 אותיות באותיות רישיות של קטגוריית הבידינג של המוצר.

productBiddingCategoryConstantParent

string

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

languageCode

string

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

localizedName

string

הצגת הערך של קטגוריית הבידינג למוצר שמותאם לשוק המקומי בהתאם ל-languageCode.

ProductBiddingCategoryLevel

Enum שמתאר את הרמה של קטגוריית הבידינג למוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
LEVEL1 רמה 1.
LEVEL2 רמה 2.
LEVEL3 רמה 3.
LEVEL4 רמה 4.
LEVEL5 רמה 5.

ProductBiddingCategoryStatus

Enum שמתאר את הסטטוס של קטגוריית הבידינג של המוצר.

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

ProductGroupView

תצוגה של קבוצת מוצרים

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

string

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

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

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

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

string

שם המשאב בתצוגת הביצועים של שופינג. שמות המשאבים בתצוגת הביצועים של שופינג מופיעים בפורמט: customers/{customerId}/shoppingPerformanceView

UserList

רשימת משתמשים. זוהי רשימה של משתמשים שלקוחות יכולים לטרגט.

ייצוג JSON
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
שדות
resourceName

string

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

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

סוג הרשימה הזו.

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

id

string (int64 format)

המזהה של רשימת המשתמשים.

name

string

השם של רשימת המשתמשים הזו. בהתאם ל-access_reason, שם רשימת המשתמשים לא יכול להיות ייחודי (לדוגמה, אם access_reason=SHARED)

UserListType

ה-Enum מכיל את הסוגים האפשריים של רשימות המשתמשים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
REMARKETING רשימת משתמשים מיוצגת כאוסף של סוגי המרות.
LOGICAL רשימת משתמשים מיוצגת כשילוב של רשימות משתמשים/תחומי עניין אחרים.
EXTERNAL_REMARKETING רשימת משתמשים נוצרה בפלטפורמה של Google Ad Manager.
RULE_BASED רשימת משתמשים שמשויכת לכלל.
SIMILAR רשימת משתמשים עם משתמשים שדומים למשתמשים ב'רשימת משתמשים אחרת'.
CRM_BASED רשימת משתמשים של נתוני ניהול קשרי לקוחות (CRM) מאינטראקציה ישירה שסופקו על ידי המפרסם בצורת הודעות אימייל או פורמטים אחרים.

WebpageView

צפייה בדף אינטרנט.

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

string

שם המשאב של תצוגת דף האינטרנט. שמות של משאבים בתצוגות דפי אינטרנט מופיעים בתבנית:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

כניסה

ביקור.

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
שדות
resourceName

string

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

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

מזהה הביקור.

criterionId

string (int64 format)

מזהה מילת המפתח ב-Search Ads 360. הערך 0 מציין שאין למילת המפתח שיוך.

merchantId

string (int64 format)

מספר חשבון המלאי ב-Search Ads 360 שכולל את המוצר שעליו לחצו. מערכת Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי ב-Search Ads 360.

adId

string (int64 format)

מזהה מודעה. הערך 0 מציין שהמודעה ללא שיוך.

clickId

string

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

visitDateTime

string

חותמת הזמן של אירוע הביקור. חותמת הזמן נמצאת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. הפורמט.

productId

string

המזהה של המוצר שעליו בוצעה לחיצה.

productChannel

enum (ProductChannel)

ערוץ המכירות של המוצר שעליו המשתמש לחץ: אונליין או מקומי.

productLanguageCode

string

השפה (ISO-639-1) שהוגדרה עבור הפיד של Merchant Center שמכיל נתונים על המוצר.

productStoreId

string

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

productCountryCode

string

המדינה (בפורמט ISO-3166) הרשומה בפיד המלאי שמכיל את המוצר שעליו לחצו.

assetId

string (int64 format)

המזהה של הנכס שהייתה לו אינטראקציה במהלך אירוע הביקור.

assetFieldType

enum (AssetFieldType)

סוג שדה הנכס של אירוע הביקור.

ProductChannel

Enum שמתאר את הרשות המוניציפאלית למוצר מסוים.

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

המרה

המרה.

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
שדות
resourceName

string

שם המשאב של ההמרה. כך נראה השם של משאבי ההמרות:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

המזהה של ההמרה

criterionId

string (int64 format)

מזהה קריטריון ב-Search Ads 360. הערך 0 מציין שאין שיוך של הקריטריון.

merchantId

string (int64 format)

מספר חשבון המלאי ב-Search Ads 360 שכולל את המוצר שעליו לחצו. מערכת Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי ב-Search Ads 360.

adId

string (int64 format)

מזהה מודעה. הערך 0 מציין שהמודעה ללא שיוך.

clickId

string

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

visitId

string (int64 format)

מזהה הביקור ב-Search Ads 360 שאליו משויכת ההמרה.

advertiserConversionId

string

כשמדובר בהמרות אופליין, זהו המזהה שמסופק על ידי מפרסמים. אם מפרסם לא מציין מזהה כזה, מערכת Search Ads 360 יוצרת מזהה. כשמדובר בהמרות אונליין, הערך הזה זהה לעמודה id או לעמודה floodlightOrderId, בהתאם להוראות לדיווח על פעילות מ-Floodlight של המפרסם.

productId

string

המזהה של המוצר שעליו בוצעה לחיצה.

productChannel

enum (ProductChannel)

ערוץ המכירות של המוצר שעליו המשתמש לחץ: אונליין או מקומי.

productLanguageCode

string

השפה (ISO-639-1) שהוגדרה עבור הפיד של Merchant Center שמכיל נתונים על המוצר.

productStoreId

string

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

productCountryCode

string

המדינה (בפורמט ISO-3166) הרשומה בפיד המלאי שמכיל את המוצר שעליו לחצו.

attributionType

enum (AttributionType)

למה ההמרה משויכת: ביקור או מילת מפתח+מודעה.

conversionDateTime

string

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

conversionLastModifiedDateTime

string

חותמת הזמן של הפעם האחרונה שבה בוצע שינוי בהמרה.

conversionVisitDateTime

string

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

conversionQuantity

string (int64 format)

כמות הפריטים שתועדה על ידי ההמרה, כפי שנקבע על ידי הפרמטר qty url. המפרסם אחראי לאכלוס דינמי של הפרמטר (למשל, מספר הפריטים שנמכרו בהמרה), אחרת ברירת המחדל של הפרמטר היא 1.

conversionRevenueMicros

string (int64 format)

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

floodlightOriginalRevenue

string (int64 format)

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

floodlightOrderId

string

מזהה ההזמנה ב-Floodlight שסופק על ידי המפרסם עבור ההמרה.

status

enum (ConversionStatus)

הסטטוס של ההמרה, 'מופעלת' או 'הוסרה'.

assetId

string (int64 format)

מזהה הנכס שהייתה לו אינטראקציה במהלך אירוע ההמרה.

assetFieldType

enum (AssetFieldType)

סוג שדה הנכס של אירוע ההמרה.

AttributionType

סוג השיוך (Attribution) של ההמרות ב-Search Ads 360

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

ConversionStatus

סטטוסים אפשריים של המרה.

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

מדדים

נתוני מדדים.

ייצוג JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
שדות
allConversionsValueByConversionDate

number

הערך של כל ההמרות. אם בוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' מציינים את תאריך ההמרה. פרטים לגבי העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

המספר הכולל של המרות. זה כולל את כל ההמרות, ללא קשר לערך של IncludeInConversionsMetric. אם בוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' מציינים את תאריך ההמרה. פרטים לגבי העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

object (Value)

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

conversionsValueByConversionDate

number

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

conversionsByConversionDate

number

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

historicalCreativeQualityScore

enum (QualityScoreBucket)

ציון האיכות ההיסטורי של הקריאייטיב.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

האיכות של חוויית המשתמש בדף הנחיתה בעבר.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

שיעור הקליקים (CTR) הצפוי של החיפוש ההיסטורי.

interactionEventTypes[]

enum (InteractionEventType)

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

rawEventConversionMetrics[]

object (Value)

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

absoluteTopImpressionPercentage

number

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

allConversionsFromInteractionsRate

number

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

allConversionsValue

number

הערך של כל ההמרות.

allConversions

number

המספר הכולל של המרות. זה כולל את כל ההמרות, ללא קשר לערך של IncludeInConversionsMetric.

allConversionsValuePerCost

number

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

allConversionsFromClickToCall

number

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

המדד הזה רלוונטי רק לפריטים בפיד.

allConversionsFromDirections

number

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

המדד הזה רלוונטי רק לפריטים בפיד.

allConversionsFromInteractionsValuePerInteraction

number

הערך של כל ההמרות מאינטראקציות חלקי המספר הכולל של אינטראקציות.

allConversionsFromMenu

number

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

המדד הזה רלוונטי רק לפריטים בפיד.

allConversionsFromOrder

number

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

המדד הזה רלוונטי רק לפריטים בפיד.

allConversionsFromOtherEngagement

number

מספר ההמרות האחרות (למשל, פרסום ביקורת או שמירת מיקום החנות) שאירעו לאחר שאנשים לחצו על מודעה.

המדד הזה רלוונטי רק לפריטים בפיד.

allConversionsFromStoreVisit

number

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

המדד הזה רלוונטי רק לפריטים בפיד.

visits

number

קליקים שמערכת Search Ads 360 תיעדה והועברה לדף הנחיתה של המפרסם.

allConversionsFromStoreWebsite

number

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

המדד הזה רלוונטי רק לפריטים בפיד.

averageCost

number

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

averageCpc

number

העלות הכוללת של כל הקליקים חלקי המספר הכולל של הקליקים שהתקבלו. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

averageCpm

number

עלות ממוצעת לאלף חשיפות (CPM). המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

string (int64 format)

מספר הקליקים.

contentBudgetLostImpressionShare

number

אחוז הפעמים המשוער שהמודעה הייתה כשירה להצגה ברשת המדיה, אבל לא הוצגה כי התקציב היה נמוך מדי. הערה: נתח החשיפות שהוחמצו בתקציב תוכן מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

contentImpressionShare

number

מספר החשיפות שקיבלתם ברשת המדיה חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. הערה: נתח החשיפות ברשת התוכן מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

contentRankLostImpressionShare

number

האחוז המשוער של חשיפות ברשת המדיה שהמודעות שלכם לא קיבלו בגלל דירוג מודעה נמוך. הערה: נתח החשיפות שהוחמצו לפי דירוג תוכן מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

conversionsFromInteractionsRate

number

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

clientAccountConversionsValue

number

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

conversionsValuePerCost

number

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

conversionsFromInteractionsValuePerInteraction

number

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

clientAccountConversions

number

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

costMicros

string (int64 format)

סך העלויות לקליק (CPC) והעלות לאלף חשיפות (CPM) במהלך התקופה הזו. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

costPerAllConversions

number

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

costPerConversion

number

עלות ממוצעת של המרה שעומדת בדרישות לכל המרה שאפשר להגיש עליה הצעת מחיר.

costPerCurrentModelAttributedConversion

number

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

crossDeviceConversions

number

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

crossDeviceConversionsValue

number

סכום הערך של המרות חוצות-מכשירים.

ctr

number

מספר הקליקים שהמודעה מקבלת (קליקים) חלקי מספר הפעמים שהמודעה מוצגת (חשיפות).

conversions

number

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

conversionsValue

number

סכום ערכי ההמרות של ההמרות שכלולות בעמודה Conversions (המרות) השדה הזה. המדד הזה מועיל רק אם הזנת ערך לפעולות ההמרה.

averageQualityScore

number

ציון האיכות הממוצע.

historicalQualityScore

string (int64 format)

ציון האיכות ההיסטורי.

impressions

string (int64 format)

מספר הפעמים שבהן המודעה הופיעה בדף תוצאות חיפוש או באתר ברשת Google.

interactionRate

number

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

interactions

string (int64 format)

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

invalidClickRate

number

אחוז הקליקים שסוננו מתוך המספר הכולל של הקליקים (קליקים שסוננו + לא מסוננים) במהלך תקופת הדיווח.

invalidClicks

string (int64 format)

מספר הקליקים ש-Google מחשיבה כלא חוקיים ולא מחייבת אותך בגינם.

mobileFriendlyClicksPercentage

number

אחוז הקליקים בניידים שהובילו לדף שמותאם לנייד.

searchAbsoluteTopImpressionShare

number

אחוז החשיפות של מודעות שופינג או מודעות לרשת החיפוש של הלקוח שהופיעו במיקום הבולט ביותר בקמפיין שופינג. פרטים נוספים זמינים בכתובת https://support.google.com/sa360/answer/9566729. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

searchBudgetLostAbsoluteTopImpressionShare

number

המספר המשוער של התדירות שבה המודעה שלכם לא הייתה המודעה הראשונה בין המודעות העליונות בתוצאות החיפוש עקב תקציב נמוך. הערה: נתח החשיפות במיקום הראשון שהוחמצו בתקציב החיפוש מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchBudgetLostImpressionShare

number

אחוז הפעמים המשוער שהמודעה הייתה כשירה להצגה ברשת החיפוש אבל לא הוצגה כי התקציב היה נמוך מדי. הערה: נתח החשיפות שהוחמצו עקב תקציב חיפוש מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchBudgetLostTopImpressionShare

number

המספר המשוער של התדירות שבה המודעה לא הופיעה סמוך לחלק העליון של תוצאות החיפוש האורגני בגלל תקציב נמוך. הערה: נתח החשיפות בראש הדף שהוחמצו בתקציב החיפוש מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchClickShare

number

מספר הקליקים שקיבלתם ברשת החיפוש חלקי המספר המשוער של הקליקים שהייתם יכולים לקבל. הערה: המדד 'נתח קליקים בחיפוש' מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

searchExactMatchImpressionShare

number

מספר החשיפות שקיבלתם חלקי המספר המשוער של חשיפות שהייתם יכולים לקבל ברשת החיפוש, עבור מונחי חיפוש שתאמו למילות המפתח שלכם במדויק (או שהיו גרסאות קרובות של מילת המפתח), בלי קשר לסוגי ההתאמה למילות המפתח. הערה: נתח החשיפות בהתאמה מדויקת בחיפוש מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

searchImpressionShare

number

מספר החשיפות שקיבלתם ברשת החיפוש חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. הערה: נתח החשיפות ברשת החיפוש מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

searchRankLostAbsoluteTopImpressionShare

number

המספר שמשמש לביצוע הערכה של התדירות שבה המודעה לא הייתה המודעה הראשונה בין המודעות שהוצגו בראש תוצאות החיפוש בגלל דירוג מודעה נמוך. הערה: המדד 'נתח החשיפות במיקום הראשון בחיפוש שהוחמצו' מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchRankLostImpressionShare

number

האחוז המשוער של החשיפות ברשת החיפוש שהמודעות שלכם לא קיבלו עקב דירוג מודעה נמוך. הערה: נתח החשיפות שהוחמצו בדירוג החיפוש מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchRankLostTopImpressionShare

number

המספר המשוער של התדירות שבה המודעה לא הופיעה סמוך לחלק העליון של תוצאות החיפוש האורגני בגלל דירוג מודעה נמוך. הערה: המדד 'נתח החשיפות בראש הדף בחיפוש שהוחמצו' מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchTopImpressionShare

number

מספר החשיפות שהמודעות קיבלו בראש הדף בהשוואה למספר המשוער של החשיפות שהן היו כשירות לקבל בין המודעות העליונות. הערה: נתח החשיפות בראש הדף בחיפוש מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

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

topImpressionPercentage

number

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

valuePerAllConversions

number

הערך של כל ההמרות חלקי מספר כל ההמרות.

valuePerAllConversionsByConversionDate

number

הערך של כל ההמרות חלקי מספר כל ההמרות. אם בוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' מציינים את תאריך ההמרה. פרטים לגבי העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.

valuePerConversion

number

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

valuePerConversionsByConversionDate

number

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

clientAccountViewThroughConversions

string (int64 format)

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

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell) של ההזמנה היא $5. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell) של ההזמנה היא $5. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell)' בחשבון הלקוח מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellRevenueMicros

string (int64 format)

המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)' בחשבון הלקוח מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 80 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellRevenueMicros

string (int64 format)

המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 80 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellUnitsSold

number

המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)' בחשבון הלקוח מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

crossSellUnitsSold

number

המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

עלות המכר בעקבות לידים בחשבון הלקוח (COGS) היא העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותו מוצר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר קשור (פרטים נוספים על מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר בעקבות לידים בהזמנה הזו היא 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר בעקבות לידים' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר קשור (פרטים נוספים על מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר בעקבות לידים בהזמנה הזו היא 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו מלידים' בחשבון הלקוח מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותו מוצר, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. הרווח ברוטו מלידים בהזמנה הזו הוא 28 ש"ח = 40 ש"ח פחות 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו מלידים' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. הרווח ברוטו מלידים בהזמנה הזו הוא 28 ש"ח = 40 ש"ח פחות 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadRevenueMicros

string (int64 format)

המדד 'הכנסה מלידים בחשבון הלקוח' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 40 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadRevenueMicros

string (int64 format)

המדד 'הכנסה מלידים' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 40 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadUnitsSold

number

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

leadUnitsSold

number

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

ערך

מאגר נתונים גנרי.

ייצוג JSON
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
שדות
שדה איחוד value. ערך. value יכול להיות רק אחת מהאפשרויות הבאות:
booleanValue

boolean

ערך בוליאני.

int64Value

string (int64 format)

int64.

floatValue

number

צף.

doubleValue

number

דאבל.

stringValue

string

מחרוזת.

QualityScoreBucket

סיכום של הקטגוריות האפשריות של ציון האיכות.

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

InteractionEventType

Enum מתאר סוגים אפשריים של אינטראקציות בתשלום ואינטראקציות בחינם.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
CLICK קליק למעבר לאתר. ברוב המקרים, האינטראקציה הזו מובילה למיקום חיצוני, בדרך כלל לדף הנחיתה של המפרסם. זהו גם ערך ברירת המחדל InteractionEventType לאירועי קליק.
ENGAGEMENT כוונת המשתמש המפורשת של המשתמש לקיים אינטראקציה עם המודעה במקום.
VIDEO_VIEW משתמש צפה במודעת וידאו.
NONE ברירת המחדל של InteractionEventType לאירועי המרה של מודעה. משתמשים בפרמטר הזה כאשר שורת המרות במודעה לא מציינת שהאינטראקציות בחינם (לדוגמה, ההמרות ממודעות) צריכות להיות 'מקודמות'. והן מדווחות כחלק ממדדי הליבה. אלו פשוט המרות אחרות (ממודעות).

פלחים

שדות לפילוח בלבד.

ייצוג JSON
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
שדות
adNetworkType

enum (AdNetworkType)

סוג רשת המודעות.

conversionActionCategory

enum (ConversionActionCategory)

קטגוריית פעולת ההמרה.

conversionCustomDimensions[]

object (Value)

המאפיינים המותאמים אישית של ההמרות.

dayOfWeek

enum (DayOfWeek)

יום בשבוע, למשל, MONDAY.

device

enum (Device)

המכשיר שעליו יחולו המדדים.

keyword

object (Keyword)

קריטריון של מילת מפתח.

productChannel

enum (ProductChannel)

הערוץ של המוצר.

productChannelExclusivity

enum (ProductChannelExclusivity)

בלעדיות בערוץ של המוצר.

productCondition

enum (ProductCondition)

מצב המוצר.

productSoldCondition

enum (ProductCondition)

מצב המוצר שנמכר.

rawEventConversionDimensions[]

object (Value)

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

conversionAction

string

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

conversionActionName

string

שם פעולת המרה.

date

string

התאריך שעליו יחולו המדדים. בפורמט yyyy-MM-dd, למשל 2018-04-17.

geoTargetCity

string

שם המשאב של קבוע הטירגוט הגיאוגרפי שמייצג עיר.

geoTargetCountry

string

שם המשאב של קבוע הטירגוט הגיאוגרפי שמייצג מדינה.

geoTargetMetro

string

שם המשאב של קבוע הטירגוט הגיאוגרפי שמייצג מטרופולין.

geoTargetRegion

string

שם המשאב של קבוע הטירגוט הגיאוגרפי שמייצג אזור.

hour

integer

שעה ביום כמספר בין 0 ל-23, כולל.

month

string

חודש מיוצג על ידי התאריך של היום הראשון בחודש. בפורמט: yyyy-MM-dd.

productBiddingCategoryLevel1

string

קטגוריית הבידינג (רמה 1) של המוצר.

productBiddingCategoryLevel2

string

קטגוריית הבידינג (רמה 2) של המוצר.

productBiddingCategoryLevel3

string

קטגוריית הבידינג (רמה 3) של המוצר.

productBiddingCategoryLevel4

string

קטגוריית הבידינג (רמה 4) של המוצר.

productBiddingCategoryLevel5

string

קטגוריית הבידינג (רמה 5) של המוצר.

productBrand

string

המותג של המוצר.

productCountry

string

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

productCustomAttribute0

string

מאפיין מותאם אישית 0 של המוצר.

productCustomAttribute1

string

מאפיין מותאם אישית 1 של המוצר.

productCustomAttribute2

string

מאפיין מותאם אישית 2 של המוצר.

productCustomAttribute3

string

מאפיין מותאם אישית 3 של המוצר.

productCustomAttribute4

string

מאפיין מותאם אישית 4 של המוצר.

productItemId

string

מזהה הפריט של המוצר.

productLanguage

string

שם המשאב של קבוע השפה של שפת המוצר.

productSoldBiddingCategoryLevel1

string

קטגוריית הבידינג (רמה 1) של המוצר שנמכר.

productSoldBiddingCategoryLevel2

string

קטגוריית הבידינג (רמה 2) של המוצר שנמכר.

productSoldBiddingCategoryLevel3

string

קטגוריית הבידינג (רמה 3) של המוצר שנמכר.

productSoldBiddingCategoryLevel4

string

קטגוריית הבידינג (רמה 4) של המוצר שנמכר.

productSoldBiddingCategoryLevel5

string

קטגוריית הבידינג (רמה 5) של המוצר שנמכר.

productSoldBrand

string

המותג של המוצר שנמכר.

productSoldCustomAttribute0

string

מאפיין מותאם אישית 0 של המוצר שנמכר.

productSoldCustomAttribute1

string

מאפיין מותאם אישית 1 של המוצר שנמכר.

productSoldCustomAttribute2

string

מאפיין מותאם אישית 2 של המוצר שנמכר.

productSoldCustomAttribute3

string

מאפיין מותאם אישית 3 של המוצר שנמכר.

productSoldCustomAttribute4

string

מאפיין מותאם אישית 4 של המוצר שנמכר.

productSoldItemId

string

מזהה הפריט של המוצר שנמכר.

productSoldTitle

string

שם המוצר שנמכר.

productSoldTypeL1

string

סוג (רמה 1) של המוצר שנמכר.

productSoldTypeL2

string

סוג (רמה 2) של המוצר שנמכר.

productSoldTypeL3

string

סוג (רמה 3) של המוצר שנמכר.

productSoldTypeL4

string

סוג (רמה 4) של המוצר שנמכר.

productSoldTypeL5

string

סוג (רמה 5) של המוצר שנמכר.

productStoreId

string

מזהה החנות של המוצר.

productTitle

string

שם המוצר.

productTypeL1

string

סוג המוצר (רמה 1).

productTypeL2

string

סוג (רמה 2) של המוצר.

productTypeL3

string

סוג (רמה 3) של המוצר.

productTypeL4

string

סוג (רמה 4) של המוצר.

productTypeL5

string

סוג (רמה 5) של המוצר.

quarter

string

רבעון מיוצג על ידי התאריך של היום הראשון של רבעון. המערכת משתמשת בשנה הקלנדרית לרבעונים. לדוגמה, הרבעון השני של 2018 מתחיל ב-1 באפריל 2018. בפורמט: yyyy-MM-dd.

week

string

שבוע שמוגדר מיום שני עד ראשון, ומיוצג על ידי התאריך של יום שני. בפורמט: yyyy-MM-dd.

year

integer

שנה, בפורמט yyyy.

assetInteractionTarget

object (AssetInteractionTarget)

בשימוש רק עם מדדים של CustomerAsset, CampaignAsset ו- AdGroupAsset. מציין אם מדדי האינטראקציה הופיעו בנכס עצמו, או בנכס אחר או ביחידת מודעות אחרת. אינטראקציות (למשל, קליקים) נספרות בכל החלקים של המודעה המוצגת (לדוגמה, המודעה עצמה ורכיבים אחרים כמו קישורי Sitelink) כאשר הן מוצגות יחד. כשהערך של interactionsOnThisAsset הוא True, המשמעות היא שהאינטראקציות מתבצעות בנכס הספציפי הזה וכשהאינטראקציה OnThisAsset מוגדרת כ-False, המשמעות היא שהאינטראקציות לא מתבצעות בנכס הספציפי הזה אלא בחלקים אחרים של המודעה המוצגת בנכס הזה.

AdNetworkType

פירוט של סוגי הרשתות ב-Google Ads.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
SEARCH חיפוש Google.
SEARCH_PARTNERS שותפי חיפוש.
CONTENT רשת המדיה.
YOUTUBE_WATCH סרטונים ב-YouTube
MIXED כל הרשתות.

מילת מפתח

פלח של קריטריון של מילת מפתח.

ייצוג JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
שדות
info

object (KeywordInfo)

פרטי מילת המפתח.

adGroupCriterion

string

שם המשאב AdGroupCriterion.

ProductChannelExclusivity

Enum שמתאר את הזמינות של מוצר מסוים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
SINGLE_CHANNEL הפריט נמכר דרך ערוץ אחד בלבד, בחנויות מקומיות או באינטרנט, כפי שמצוין ב-ProductChannel שלו.
MULTI_CHANNEL הפריט תואם לפריט המקביל בחנויות הווירטואליות או בחנויות המקומיות שלו, כדי לציין שהוא זמין לרכישה בשני ערוצי ShoppingProductChannel.

ProductCondition

Enum שמתאר את המצב של מוצר מסוים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
OLD מצב המוצר ישן.
NEW מצב המוצר חדש.
REFURBISHED מצב המוצר מחודש.
USED מצב המוצר נמצא בשימוש.

AssetInteractionTarget

פלח AssetInteractionTarget.

ייצוג JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
שדות
asset

string

שם המשאב של הנכס.

interactionOnThisAsset

boolean

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