SearchAds360Row

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

ייצוג ב-JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "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)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "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)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
שדות
adGroup

object (AdGroup)

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

adGroupAd

object (AdGroupAd)

המודעה שאליה מתייחסת השאילתה.

adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

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

adGroupAdLabel

object (AdGroupAdLabel)

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

adGroupAsset

object (AdGroupAsset)

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

adGroupAssetSet

object (AdGroupAssetSet)

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

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

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

adGroupCriterion

object (AdGroupCriterion)

הקריטריון שאליו מתייחסת השאילתה.

adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

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

adGroupCriterionLabel

object (AdGroupCriterionLabel)

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

adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

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

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)

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

campaignEffectiveLabel

object (CampaignEffectiveLabel)

התווית האפקטיבית של הקמפיין שאליה מתייחסת השאילתה.

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)

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

userLocationView

object (UserLocationView)

התצוגה של מיקום המשתמש שאליה מתייחסת השאילתה.

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
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
שדות
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

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

effectiveLabels[]

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.ssssss.

id

string (int64 format)

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

name

string

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

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

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

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

trackingUrlTemplate

string

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

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

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

finalUrlSuffix

string

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

AdGroupStatus

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

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

הערך שהתקבל לא מוכר בגרסה הזו.

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

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

AdGroupType

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

טיפוסים בני מנייה (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 מודעות וידאו TrueView In-stream (שניתן לדלג עליהן).
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 קריטריונים של מילות מפתח, לדוגמה, 'שייט למאדים'. אפשר להשתמש במילת המפתח כמאפיין מותאם אישית של הצעת מחיר. מילות מפתח הן תמיד מאפיין טירגוט, ולכן אי אפשר להגדיר אותן כמאפיין טירגוט מסוג 'הכול' באמצעות TargetRestriction.
AUDIENCE קריטריונים לקהל, כולל רשימת משתמשים, תחומי עניין של משתמשים, קהלים בהתאמה אישית עם תחום עניין משותף וקהלים בהתאמה אישית עם כוונת רכישה.
TOPIC קריטריונים של נושאים לטירגוט קטגוריות של תוכן, לדוגמה, 'category::Animals>Pets'. משמש לטירגוט ברשת המדיה ובקמפיינים לווידאו.
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
  ],
  "effectiveLabels": [
    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

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

labels[]

string

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

effectiveLabels[]

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.ssssss.

AdGroupAdStatus

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

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

הערך שהתקבל לא מוכר בגרסה הזו.

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

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

FinalAppUrl

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

ייצוג ב-JSON
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
שדות
osType

enum (AppUrlOperatingSystemType)

מערכת ההפעלה שמטורגטת על ידי כתובת ה-URL הזו. חובה.

url

string

כתובת ה-URL של קישור העומק לאפליקציה. קישורי עומק מציינים את המיקום באפליקציה שבו נמצא התוכן שאליו רוצים להעביר את המשתמשים, והם צריכים להיות במבנה {scheme}://{host_path}. הסכמה מזהה את האפליקציה שצריך לפתוח. כשמגדירים סכמה, אפשר להשתמש בסכמה מותאמת אישית שמתחילה בשם של האפליקציה. המארח והנתיב מציינים את המיקום הייחודי באפליקציה שבו נמצא התוכן. לדוגמה: exampleapp://productid_1234. חובה.

AppUrlOperatingSystemType

מערכת הפעלה

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

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 הקריאייטיב הושהה כי קבוצת המודעות הושהתה.

AdGroupAdEffectiveLabel

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

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

string

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

adGroupAd

string

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

label

string

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

ownerCustomerId

string (int64 format)

המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית.

AdGroupAdLabel

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

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

string

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

adGroupAd

string

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

label

string

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

ownerCustomerId

string (int64 format)

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

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 הוא הקישור בין קבוצת מודעות לבין קבוצת נכסים. יצירת 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 עבור PreferredContent. כדי לבטל את ההסכמה לסוג מכשיר מסוים, משתמשים בערך 0.

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

נדרש בפעולות יצירה החל מגרסה 5. הערך 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
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "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)

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

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

qualityInfo

object (QualityInfo)

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

type

enum (CriterionType)

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

labels[]

string

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

effectiveLabels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

finalMobileUrls[]

string

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

urlCustomParameters[]

object (CustomParameter)

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

engineId

string

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

lastModifiedTime

string

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

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)
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 : Criterion pending review
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 הקריטריון מושהה כי החשבון מושהה.

CustomParameter

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

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

string

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

value

string

הערך שיוחלף.

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)

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

השדה הזה נדרש לפעולות 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 הארגומנט web condition הוא חלק מהתנאי web condition שמושווה.

LocationInfo

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

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

string

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

AdGroupCriterionEffectiveLabel

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

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

string

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

adGroupCriterion

string

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

label

string

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

ownerCustomerId

string (int64 format)

המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית.

AdGroupCriterionLabel

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

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

string

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

adGroupCriterion

string

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

label

string

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

ownerCustomerId

string (int64 format)

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

AdGroupEffectiveLabel

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

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

string

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

adGroup

string

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

label

string

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

ownerCustomerId

string (int64 format)

המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית.

AdGroupLabel

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

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

string

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

adGroup

string

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

label

string

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

ownerCustomerId

string (int64 format)

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

AgeRangeView

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

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

string

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

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

נכס

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

ייצוג ב-JSON
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": 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 סופיות אפשריות אחרי כל ההפניות האוטומטיות בין דומיינים.

finalMobileUrls[]

string

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

urlCustomParameters[]

object (CustomParameter)

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

status

enum (AssetStatus)

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

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

מזהה הנכס.

name

string

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

trackingUrlTemplate

string

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

finalUrlSuffix

string

תבנית כתובת 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)
UNSPECIFIED לא צוין.
UNKNOWN הפרמטר הזה משמש רק להחזרת ערך. מייצג ערך לא ידוע בגרסה הזו.
YOUTUBE_VIDEO נכס וידאו ב-YouTube.
MEDIA_BUNDLE נכס של חבילת מדיה.
IMAGE נכס תמונות.
TEXT נכס טקסט.
LEAD_FORM נכס השארת פרטים.
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

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

טיפוסים בני מנייה (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 של image/jpeg.
IMAGE_GIF סוג MIME של image/gif.
IMAGE_PNG סוג MIME של image/png.
FLASH סוג ה-MIME של application/x-shockwave-flash.
TEXT_HTML סוג MIME של text/html.
PDF סוג MIME של application/pdf.
MSWORD סוג MIME של application/msword.
MSEXCEL סוג ה-MIME של application/vnd.ms-excel.
RTF סוג MIME של application/rtf.
AUDIO_WAV סוג MIME של audio/wav.
AUDIO_MP3 סוג MIME של audio/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

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

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

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

ייצוג ב-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

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
ZERO אפס דקות אחרי השעה.
FIFTEEN רבע שעה אחרי השעה.
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_RESOURCE_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)

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

locationOwnershipType

enum (LocationOwnershipType)

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

BusinessProfileLocation

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

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

string

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

storeCode

string

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

listingId

string (int64 format)

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

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 הנכס מקושר לשימוש כמלון בקמפיין למיקסום הביצועים לענף התיירות והאירוח.
LONG_DESCRIPTION הנכס מקושר לשימוש כתיאור ארוך.
CALL_TO_ACTION הנכס מקושר לשימוש כקריאה לפעולה.

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)

המזהה של ListingGroupFilter.

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, כפי שמתואר במאמר הזה: 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

שם המשאב של התצוגה של השילובים המובילים של קבוצת הנכסים. שמות המשאבים של התצוגה 'השילובים המובילים של קבוצת נכסים' הם בפורמט: ‎`"customers/{customerId}/assetGroupTopCombinationViews/{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 הנכס שימש בכותרת. משתמשים במאפיין הזה רק אם יש רק כותרת אחת במודעה. אחרת, משתמשים בערכי ה-enum ‏HEADLINE_1, ‏HEADLINE_2 או HEADLINE_3.
HEADLINE_IN_PORTRAIT הנכס שימש ככותרת בתמונה לאורך.
LONG_HEADLINE הנכס שימש בכותרת ארוכה (במודעה רספונסיבית לרשת המדיה מרובת נכסים).
DESCRIPTION הנכס שימש בתיאור. משתמשים במאפיין הזה רק אם יש רק תיאור אחד במודעה. אחרת, משתמשים בערכי ה-enum‏ DESCRIPTION_1 או DESCRIPTION_@
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 הנכס משמש כטופס להשארת פרטים.
DESCRIPTION_PREFIX הנכס משמש כקידומת לתיאור.

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

status

enum (AssetGroupStatus)

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

path1

string

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

path2

string

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

adStrength

enum (AdStrength)

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

AssetGroupStatus

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

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

AdStrength

רשימת Enum שמפרטת את חוזק המודעה האפשרי.

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

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

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

id

string (int64 format)

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

name

string

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

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

effectiveCurrencyCode

string

המטבע שבו משתמשים בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן 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

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

טיפוסים בני מנייה (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 תוכנית לקידום הצעות מחיר בדף הראשון, שמגדירה הצעות מחיר מקסימליות לקליק כדי לטרגט חשיפות בדף הראשון או במשבצות המקודמות בדף הראשון ב-google.com. הערך הזה ב-enum הוצא משימוש.
PERCENT_CPC בידינג לפי אחוז מהמחיר לקליק הוא שיטת בידינג שבה הצעות המחיר הן חלק קטן מהמחיר המפורסם של מוצר או שירות מסוימים.
TARGET_CPA 'יעד עלות להמרה' היא שיטת בידינג אוטומטית שבה המערכת מגדירה הצעות מחיר במטרה להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
TARGET_CPM יעד עלות לאלף חשיפות היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר חשיפות במסגרת יעד העלות לאלף חשיפות (CPM) שהגדרתם.
TARGET_IMPRESSION_SHARE שיטת בידינג אוטומטית שמגדירה הצעות מחיר כך שאחוז מסוים של מודעות לרשת החיפוש יוצגו בראש הדף הראשון (או במיקום אחר שמטרגטים).
TARGET_OUTRANK_SHARE שיטת הבידינג 'מיקוד לפי נתח הובלה בדירוג' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר על סמך היעד של חלק המכירות הפומביות שבהן המפרסם צריך לעקוף מתחרה ספציפי בדירוג. ערך ה-enum הזה הוצא משימוש.
TARGET_ROAS יעד החזר על הוצאות פרסום (ROAS) היא שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך שמירה על יעד החזר ממוצע על הוצאות פרסום (ROAS) ספציפי.
TARGET_SPEND 'יעד הוצאות' היא שיטת בידינג אוטומטית שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

EnhancedCpc

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

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

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

MaximizeConversionValue

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

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

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

targetRoas

number

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

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 ל-1,000.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 שרת התקציב יגביל את הצגת המודעות באופן שווה לאורך כל תקופת הזמן.
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)
  },
  "effectiveLabels": [
    string
  ],
  "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,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "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)

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

effectiveLabels[]

string

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

labels[]

string

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

biddingStrategyType

enum (BiddingStrategyType)

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

אפשר ליצור שיטת בידינג על ידי הגדרת תוכנית הבידינג ליצירת שיטת בידינג רגילה, או על ידי הגדרת השדה biddingStrategy ליצירת שיטת בידינג כוללת.

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

accessibleBiddingStrategy

string

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

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 יוצא משימוש בגרסה v1. במקומו, צריך להשתמש במאפיין creationTime.

creationTime

string

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

lastModifiedTime

string

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

feedTypes[]

enum (AssetSetType)

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

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 בדצמבר 2037, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים לפעולה ללא הגבלת זמן, צריך להגדיר את השדה הזה ל-2037-12-30.

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

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

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

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

biddingStrategy

string

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

manualCpa

object (ManualCpa)

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

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

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

maximizeConversions

object (MaximizeConversions)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

שיטת בידינג רגילה לפי יעד החזר על הוצאות פרסום (ROAS) שממקסמת באופן אוטומטי את ההכנסות תוך שמירה על יעד ספציפי ממוצע של החזר על הוצאות פרסום (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 האופטימיזציה של הצגת המודעות מבוססת על שיעור הקליקים כפול ההמרה בקמפיין. אם הקמפיין לא מוגדר לשיטת הבידינג 'אופטימיזציית המרות', ברירת המחדל תהיה OPTIMIZED.
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 קמפיינים לקידום עסקים מקומיים.
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 קמפיינים לקידום פעילויות בענף התיירות והאירוח.
SOCIAL_FACEBOOK_TRACKING_ONLY מעקב של פייסבוק מתבצע רק בקמפיינים ברשתות החברתיות.

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. אם משתמשים בשדה feedLabel במקום בשדה salesCountry, צריך להזין בו קודי מדינה באותו פורמט, למשל: 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 שמשמשת למעקב דינמי.

AssetSetType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הפרמטר הזה משמש רק להחזרת ערך. מייצג ערך לא ידוע בגרסה הזו.
PAGE_FEED קבוצת נכסים של דפים.
DYNAMIC_EDUCATION קבוצת נכסים דינמיים לפרסום שקשור ללימודים.
MERCHANT_CENTER_FEED נכסים ב-Google Merchant Center.
DYNAMIC_REAL_ESTATE קבוצת נכסים דינמית שקשורה לנדל"ן.
DYNAMIC_CUSTOM חבילת נכסים דיגיטליים דינמיים בהתאמה אישית.
DYNAMIC_HOTELS_AND_RENTALS קבוצת נכסים דינמית שקשורה למלונות וליחידות נופש להשכרה.
DYNAMIC_FLIGHTS קבוצת נכסים דינמיים שקשורים לפרקי זמן של פרסום פעיל.
DYNAMIC_TRAVEL קבוצת נכסי נסיעות דינמיים.
DYNAMIC_LOCAL קבוצת נכסים מקומיים דינמיים.
DYNAMIC_JOBS קבוצת נכסים דינמיים שקשורים למשרות.
LOCATION_SYNC קבוצת נכסים ברמת סנכרון המיקום.
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP קבוצת נכסים של קבוצת מיקומים בפרופיל העסק.
CHAIN_DYNAMIC_LOCATION_GROUP קבוצת נכסים של מיקומי סניפים של רשת שאפשר להשתמש בה גם למיקומים בבעלות וגם למיקומי מפיצים.
STATIC_LOCATION_GROUP קבוצה סטטית של נכסי מיקום שאפשר להשתמש בה גם למיקומים בבעלות וגם למיקומים של מפיצים.
HOTEL_PROPERTY קבוצת נכסים מסוג 'מלון' שמשמשת לקישור פיד של מלונות לקמפיינים למיקסום הביצועים לענף התיירות והאירוח.
TRAVEL_FEED סוג קבוצת נכסי פיד נסיעות. יכול לייצג פיד של מלונות או פיד של פעילויות.

ManualCpa

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

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

ManualCpc

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

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

boolean

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

ManualCpm

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

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

PercentCpc

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

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

string (int64 format)

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

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.ssssss.

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

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

radius

string (int64 format)

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

LocationGroupRadiusUnits

יחידת המרחק של הרדיוס בקבוצה לפי מיקום (לדוגמה, מיילים)

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

CampaignEffectiveLabel

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

ייצוג ב-JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב. הפורמט של שמות המשאבים של CampaignEffectivelabel הוא: customers/{ownerCustomerId}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

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

label

string

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

ownerCustomerId

string (int64 format)

המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית.

CampaignLabel

מייצג קשר בין קמפיין לתווית.

ייצוג ב-JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב. שמות המשאבים של תוויות הקמפיינים הם מהצורה: customers/{ownerCustomerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

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

label

string

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

ownerCustomerId

string (int64 format)

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

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, עדיין אפשר להגיש הצעות מחיר על פעולת ההמרה הזו. אם לא מגדירים את הפרמטר, ברירת המחדל שלו היא true. בגרסה 9, אפשר להגדיר את primaryForGoal כ-false רק אחרי היצירה באמצעות פעולת update, כי היא לא מוצהרת כאופציונלית.

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 ונחליף אותו בשיטה משופרת לייבוא המרות מ-Salesforce. – אפשר לעיין במאמר https://support.google.com/google-ads/answer/14728349

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

הקטגוריה של ההמרות שמשויכות ל-ConversionAction.

טיפוסים בני מנייה (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). מיועד לשימוש ב-GA, ב-Firebase ובייבוא יעדים של GA Gold.
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)

סוג מודל השיוך של פעולת ההמרה הזו.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

הסטטוס של מודל השיוך מבוסס-הנתונים של פעולת ההמרה.

AttributionModel

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הפרמטר הזה משמש רק להחזרת ערך. מייצג ערך לא ידוע בגרסה הזו.
EXTERNAL נעשה שימוש בשיוך חיצוני.
GOOGLE_ADS_LAST_CLICK המערכת משייכת את כל הקרדיט על ההמרה לקליק האחרון.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK המערכת משייכת את כל הקרדיט על ההמרה לקליק הראשון באמצעות שיוך בחיפוש Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR משייך קרדיט על המרה באופן שווה לכל הקליקים שלה באמצעות ייחוס בחיפוש 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 שאחריו מופיע מספר שהוא 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

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

אי אפשר להשתמש בסטטוס הזה בבקשות CREATE ו-UPDATE.

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

ConversionCustomVariableFamily

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

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

ConversionCustomVariableCardinality

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הפרמטר הזה משמש רק להחזרת ערך. מייצג ערך לא ידוע בגרסה הזו.
BELOW_ALL_LIMITS העוצמה של המשתנה המותאם אישית להמרה נמוכה מכל המגבלות. אפשר להשתמש במשתנה לפילוח, ואם המשתנה מופעל, המערכת יכולה לצבור נתונים סטטיסטיים לערכים חדשים.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT המשתנה המותאם אישית של ההמרה כולל מספר ערכים ייחודיים שחורג מהמגבלה של הפילוח, אבל לא מהמגבלה של הנתונים הסטטיסטיים. הפילוח יושבת, אבל אם המשתנה מופעל, המערכת יכולה לצבור נתונים לגבי ערכים חדשים.
APPROACHES_STATS_LIMIT המשתנה המותאם אישית של ההמרה חורג ממגבלות הפילוח, ומתקרב למגבלות הנתונים הסטטיסטיים (> 90%). הפילוח יושבת, אבל אם המשתנה מופעל, המערכת יכולה לצבור נתונים לגבי ערכים חדשים.
EXCEEDS_STATS_LIMIT המשתנה המותאם אישית של ההמרה חורג ממגבלות הפילוח וממגבלות הנתונים הסטטיסטיים. הפילוח יושבת, והנתונים הסטטיסטיים של המשתנים המופעלים יצטברו רק אם הערכים הקיימים לא יגדילו עוד את הקרדינליות של המשתנה.

FloodlightConversionCustomVariableInfo

מידע על משתנים מותאמים אישית של המרות Floodlight ב-Search Ads 360.

ייצוג ב-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 מסוג 'מספר'. אפשר להקצות את המשתנה הזה למשתני Floodlight מסוג DIMENSION או METRIC.
STRING מייצג משתנה Floodlight מסוג String. יכול להיות שהמשתנה הזה יוקצה למשתני Floodlight מסוג DIMENSION.

לקוח

לקוח.

ייצוג ב-JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "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.ssssss.

engineId

string

מזהה החשבון בחשבון החיצוני של מנוע החיפוש.

status

enum (CustomerStatus)

הסטטוס של הלקוח.

creationTime

string

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

managerId

string (int64 format)

מספר הלקוח של חשבון הניהול. הערך 0 מציין שללקוח אין חשבון ניהול ב-SA360.

managerDescriptiveName

string

השם התיאורי של חשבון הניהול.

subManagerId

string (int64 format)

מספר הלקוח של חשבון הניהול המשני. ערך של 0 מציין שללקוח אין חשבון ניהול משני ב-SA360.

subManagerDescriptiveName

string

השם התיאורי של חשבון הניהול המשני.

associateManagerId

string (int64 format)

מספר הלקוח של חשבון הניהול המשני. ערך של 0 מציין שללקוח אין חשבון ניהול שותף ב-SA360.

associateManagerDescriptiveName

string

השם התיאורי של חשבון הניהול המשני.

accountLevel

enum (AccountLevelType)

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

id

string (int64 format)

מזהה הלקוח.

descriptiveName

string

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

currencyCode

string

המטבע שבו מתנהל החשבון. מערכת Google תומכת בחלק מקודי המטבע בתקן 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_GATEWAY חשבון פייסבוק שמנוהל דרך שער.
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 החשבון עדיין בתהליך ההגדרה, והוא עדיין לא במצב ENABLED.

CustomerStatus

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

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

AccountLevelType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הפרמטר הזה משמש רק להחזרת ערך. מייצג ערך לא ידוע בגרסה הזו.
CLIENT_ACCOUNT_FACEBOOK חשבון לקוח (פייסבוק)
CLIENT_ACCOUNT_GOOGLE_ADS חשבון לקוח (Google Ads)
CLIENT_ACCOUNT_MICROSOFT חשבון לקוח (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN חשבון לקוח (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK חשבון לקוח (Engine Track)
MANAGER חשבון ניהול ברמה העליונה.
SUB_MANAGER חשבון ניהול משני.
ASSOCIATE_MANAGER חשבון ניהול משני לשותפים.

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

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

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

ייצוג ב-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

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

שדה איחוד 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

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

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

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

ייצוג ב-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

שם המשאב של לקוח הלקוח. שמות המשאבים של CustomerClient הם בפורמט: 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

ייצוג מחרוזת של אזור הזמן של הלקוח במאגר Common Locale Data Repository ‏ (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/{ownerCustomerId}/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

צבע הרקע של התווית בפורמט הקסדצימלי. המחרוזת הזו צריכה להתאים לביטוי הרגולרי '^#([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

השם המלא של השפה באנגלית, לדוגמה, 'English (US)',‏ 'Spanish' וכו'.

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, כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436.

countryCode

string

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

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=SHARED), בהתאם ל-access_reason.

UserListType

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הפרמטר הזה משמש רק להחזרת ערך. מייצג ערך לא ידוע בגרסה הזו.
REMARKETING רשימת משתמשים שמיוצגת כאוסף של סוגי המרות.
LOGICAL רשימת משתמשים שמייצגת שילוב של רשימות משתמשים אחרות או תחומי עניין אחרים.
EXTERNAL_REMARKETING רשימת משתמשים שנוצרה בפלטפורמת Google Ad Manager.
RULE_BASED רשימת משתמשים שמשויכת לכלל.
SIMILAR רשימת משתמשים שכוללת משתמשים שדומים למשתמשים ברשימת משתמשים אחרת.
CRM_BASED רשימת משתמשים של נתוני CRM מאינטראקציה ישירה שהמפרסם מספק בצורה של כתובות אימייל או פורמטים אחרים.

UserLocationView

תצוגת מיקום של משתמש.

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

ייצוג ב-JSON
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
שדות
resourceName

string

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

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

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

targetingLocation

boolean

מציין אם המיקום היה מיקום גיאוגרפי למיקוד או לא.

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

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

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)

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

conversionRevenueMicros

string (int64 format)

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

floodlightOriginalRevenue

string (int64 format)

ההכנסה המקורית שלא השתנתה שמשויכת לאירוע ב-Floodlight (במטבע של הדוח הנוכחי), לפני השינויים בהוראות המטבע ב-Floodlight.

floodlightOrderId

string

מזהה ההזמנה ב-Floodlight שסופק על ידי המפרסם לצורך ההמרה.

status

enum (ConversionStatus)

הסטטוס של ההמרה, ENABLED או REMOVED.

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,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": 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,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": 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

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

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

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

conversionsValuePerCost

number

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

conversionsFromInteractionsValuePerInteraction

number

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

clientAccountConversions

number

מספר ההמרות בחשבון הלקוח. הערך הזה כולל רק פעולות המרה שהמאפיין includeInClientAccountConversionsMetric שלהן מוגדר כ-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

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

crossDeviceConversionsByConversionDate

number

מספר ההמרות חוצות-המכשירים לפי תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.

crossDeviceConversionsValue

number

סכום הערכים של המרות חוצות-מכשירים.

crossDeviceConversionsValueByConversionDate

number

סכום הערך של המרות חוצות-מכשירים לפי תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.

ctr

number

מספר הקליקים שהמודעה קיבלה (קליקים) חלקי מספר הפעמים שהמודעה הוצגה (חשיפות).

conversions

number

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

conversionsValue

number

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

averageQualityScore

number

ציון האיכות הממוצע.

historicalQualityScore

string (int64 format)

ציון האיכות בעבר.

impressions

string (int64 format)

מספר הפעמים שהמודעה הופיעה בדף תוצאות חיפוש או באתר ברשת Google.

interactionRate

number

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

interactions

string (int64 format)

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

invalidClickRate

number

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

invalidClicks

string (int64 format)

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

generalInvalidClickRate

number

אחוז הקליקים שסוננו מתוך כלל הקליקים (קליקים מסוננים + קליקים לא מסוננים) כי הם קליקים פסולים כלליים. אלה קליקים ש-Google מחשיבה כפסולים, והם מזוהים בעזרת אמצעי סינון שגרתיים (כלומר תנועה פסולה ידועה ממרכזי נתונים, בוטים וספיידרים או סורקים אחרים, דפוסים חריגים וכו'). אתה לא משלם עליהם, והם לא משפיעים על הסטטיסטיקה של החשבון. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/campaignmanager/answer/6076504.

generalInvalidClicks

string (int64 format)

מספר הקליקים הפסולים הכלליים. אלה קליקים פסולים שזוהו באמצעות אמצעי סינון שגרתיים (למשל תנועה פסולה ידועה ממרכזי נתונים, בוטים וספיידרים או סורקים אחרים, דפוסים חריגים וכו'). אתה לא משלם עליהם, והם לא משפיעים על הסטטיסטיקה של החשבון. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/campaignmanager/answer/6076504.

mobileFriendlyClicksPercentage

number

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

searchAbsoluteTopImpressionShare

number

אחוז החשיפות של מודעות שופינג או מודעות לרשת החיפוש של הלקוח שהופיעו במיקום הבולט ביותר בחיפוש Google. פרטים נוספים זמינים בכתובת 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) בחשבון לקוח' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המערכת מחשיבה את זה כמכירת מוצר או שירות לא קשור. עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. ערך עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 5$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המערכת מחשיבה את זה כמכירת מוצר או שירות לא קשור. עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. ערך עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 5$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (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). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המערכת מחשיבה את זה כמכירת מוצר או שירות לא קשור. הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר החולצה הוא 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) בחשבון לקוח' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המערכת מחשיבה את זה כמכירת מוצר או שירות לא קשור. ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 20$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellRevenueMicros

string (int64 format)

המדד "הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)" מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המערכת מחשיבה את זה כמכירת מוצר או שירות לא קשור. ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 20$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellUnitsSold

number

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

crossSellUnitsSold

number

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

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

עלות המכר בעקבות לידים (COGS) בחשבון לקוח היא העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותו מוצר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר משויך (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. עלות המכר בעקבות לידים בהזמנה הזו היא 3$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר בעקבות לידים' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר משויך (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. עלות המכר בעקבות לידים בהזמנה הזו היא 3$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו מלידים בחשבון לקוח' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 10$ וערך עלות המכר שלו הוא 3$. הרווח ברוטו מלידים בהזמנה הזו הוא 7$ = 10$ פחות 3$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו מלידים' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 10$ וערך עלות המכר שלו הוא 3$. הרווח ברוטו מלידים בהזמנה הזו הוא 7$ = 10$ פחות 3$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadRevenueMicros

string (int64 format)

ההכנסה מלידים בחשבון לקוח היא הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום המוצרים האלה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 10$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadRevenueMicros

string (int64 format)

המדד "הכנסה מלידים" מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מהפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 10$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר metrics_currency זמין בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadUnitsSold

number

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

leadUnitsSold

number

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

uniqueUsers

string (int64 format)

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

averageImpressionFrequencyPerUser

number

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

ערך

מאגר נתונים כללי.

ייצוג ב-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 של קטגוריות ציון האיכות האפשריות.

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

InteractionEventType

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

טיפוסים בני מנייה (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 מתחיל ב-2018-04-01. הפורמט הוא yyyy-MM-dd.

week

string

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

year

integer

השנה, בפורמט yyyy.

assetInteractionTarget

object (AssetInteractionTarget)

המאפיין הזה משמש רק עם מדדים של CustomerAsset, ‏ CampaignAsset ו-AdGroupAsset. השדה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעה אחרת. אינטראקציות (למשל, קליקים) נספרות בכל חלקי המודעה שמוצגת (למשל, המודעה עצמה ורכיבים אחרים כמו נכסי Sitelink) כשהם מוצגים יחד. כשהערך של interactionOnThisAsset הוא true, המשמעות היא שהאינטראקציות מתרחשות בנכס הספציפי הזה. כשהערך הוא 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 הפריט נמכר רק בערוץ אחד, בחנויות מקומיות או אונליין, כפי שמצוין בערך של מאפיין ערוץ המוצר.
MULTI_CHANNEL הפריט תואם לפריט המקביל בחנויות המקומיות או באינטרנט, מה שמצביע על כך שהוא זמין לרכישה בשני ערוצי המוצרים בשופינג.

ProductCondition

סוג Enum שמתאר את מצב המוצר.

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

AssetInteractionTarget

פלח של יעד אינטראקציה עם נכס.

ייצוג ב-JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
שדות
asset

string

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

interactionOnThisAsset

boolean

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