ConversionAction

פעולת המרה.

ייצוג JSON 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
שדות
resourceName

string

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

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

הסטטוס של פעולת ההמרה הזו לצבירת אירועי המרה.
type

enum (ConversionActionType)

לא משתנה. הסוג של פעולת ההמרה הזו.
origin

enum (ConversionOrigin)

פלט בלבד. מקור ההמרה של פעולת ההמרה הזו.
category

enum (ConversionActionCategory)

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

object (ValueSettings)

הגדרות שקשורות לערך של אירועי ההמרה שמשויכים לפעולת ההמרה הזאת.
countingType

enum (ConversionActionCountingType)

איך לספור אירועי המרה עבור פעולת ההמרה.
attributionModelSettings

object (AttributionModelSettings)

הגדרות שקשורות למודל השיוך (Attribution) של פעולת ההמרה הזו.
tagSnippets[]

object (TagSnippet)

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

enum (MobileAppVendor)

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

object (FirebaseSettings)

פלט בלבד. הגדרות Firebase לסוגי המרות של Firebase.
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

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

object (GoogleAnalytics4Settings)

פלט בלבד. הגדרות של Google Analytics 4 לסוגי המרות של Google Analytics 4.
id

string (int64 format)

פלט בלבד. המזהה של פעולת ההמרה.
name

string

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

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

boolean

אם הביט primaryForGoal של פעולת ההמרה מוגדר כ-False, לא ניתן להגיש הצעות מחיר לפעולת ההמרה הזו בכל הקמפיינים, ללא קשר ליעד ההמרה של הלקוח או ליעד ההמרה שהוגדר לקמפיין. עם זאת, יעדי המרה מותאמים אישית לא מצייתים ל-primaryForGoal, כך שאם לקמפיין יש יעד המרה מותאם אישית שמוגדר עם פעולת המרה primaryForGoal = false, עדיין אפשר להגיש הצעת מחיר על פעולת ההמרה הזו. כברירת מחדל, הערך primaryForGoal יהיה TRUE אם הוא לא מוגדר. ב-V9, ניתן להגדיר את primaryForGoal כ-false רק לאחר יצירה באמצעות פעולת 'עדכון', מאחר שאינה מוצהרת כאופציונלית.
ownerCustomer

string

פלט בלבד. שם המשאב של הלקוח שמוגדר כבעלים של פעולת ההמרה. אם זו פעולת המרה בהגדרת המערכת, הערך יכול להיות null.
includeInConversionsMetric

boolean

אם צריך לכלול את פעולת ההמרה הזו במדד 'המרות'.
clickThroughLookbackWindowDays

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

הערך חייב להיות בין 0 ל-10,000, כולל.
appId

string

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

ConversionActionStatus

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

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

ConversionActionType

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

טיפוסים בני מנייה (enums)
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 באפליקציה ל-iOS באמצעות Firebase.
FIREBASE_IOS_CUSTOM מתבצע מעקב אחר המרות מותאמות אישית באפליקציה ל-iOS באמצעות Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN המרות בפתיחת אפליקציה ל-Android שמתבצע אחריהן מעקב באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE מעקב אחר המרות מסוג רכישה מתוך אפליקציה ל-Android מתבצע באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM מעקב אחר המרות מותאמות אישית באפליקציות ל-Android מתבצע באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN המרות בפתיחה ראשונה באפליקציה ל-iOS שמתבצע אחריהן מעקב באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE מעקב אחר המרות מסוג רכישה מתוך אפליקציה ל-iOS מתבצע באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM מעקב אחר המרות מותאמות אישית באפליקציות ל-iOS מתבצע באמצעות ניתוח נתוני אפליקציות של צד שלישי.
ANDROID_APP_PRE_REGISTRATION המרות שמתרחשות כאשר משתמש מבצע רישום מראש לאפליקציה לנייד מחנות Google Play. קריאה בלבד.
ANDROID_INSTALLS_ALL_OTHER_APPS המרות שעוקבות אחר כל ההורדות ב-Google Play שלא מתבצע אחריהן מעקב לפי סוג ספציפי של אפליקציה. קריאה בלבד.
FLOODLIGHT_ACTION פעילות ב-Floodlight שסופרת את מספר הפעמים שמשתמשים ביקרו בדף אינטרנט מסוים אחרי שראו או לחצו על אחת מהמודעות של המפרסם. קריאה בלבד.
FLOODLIGHT_TRANSACTION פעילות ב-Floodlight שעוקבת אחרי מספר המכירות או מספר הפריטים שנרכשו. יכול גם לכלול את הערך הכולל של כל מכירה. קריאה בלבד.
GOOGLE_HOSTED המרות שמשמשות למעקב אחרי פעולות מקומיות ממוצרים ומשירותים של Google אחרי אינטראקציה עם מודעה. קריאה בלבד.
LEAD_FORM_SUBMIT ההמרות שמדווחות כשמשתמשים שולחים טופס להשארת פרטים. קריאה בלבד.
SALESFORCE המרות שמגיעות מ-Salesforce. קריאה בלבד.
SEARCH_ADS_360 המרות שיובאו מנתוני Floodlight ב-Search Ads 360. קריאה בלבד.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL המרות מסוג שיחה שמתרחשות במודעות בקמפיין חכם בלי להגדיר מעקב אחר שיחות, באמצעות קריטריונים בהתאמה אישית של קמפיין חכם. קריאה בלבד.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL המשתמש לוחץ על רכיב התקשרות במפות Google. קמפיין חכם בלבד. קריאה בלבד.
SMART_CAMPAIGN_MAP_DIRECTIONS המשתמש מבקש מסלול למיקום של עסק במפות Google. קמפיין חכם בלבד. קריאה בלבד.
SMART_CAMPAIGN_TRACKED_CALLS המרות מסוג שיחה שמתרחשות במודעות של קמפיין חכם עם הגדרת מעקב אחר שיחות, על סמך קריטריונים מותאמים אישית של קמפיין חכם. קריאה בלבד.
STORE_VISITS המרות שמתרחשות כשמשתמש מבקר בחנות הקמעונאית של המפרסם. קריאה בלבד.
WEBPAGE_CODELESS המרות שנוצרו מאירועים באתר (כמו שליחת טפסים או טעינות של דפים), שלא נעשה בהן שימוש בקטעי קוד של אירועים שהוגדרו בנפרד. קריאה בלבד.
UNIVERSAL_ANALYTICS_GOAL המרות שמגיעות ממטרות עסקיות מקושרות ב-Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION המרות שמגיעות מעסקאות מקושרות ב-Universal Analytics.
GOOGLE_ANALYTICS_4_CUSTOM המרות שמגיעות מהמרות מקושרות מסוג אירועים מותאמים אישית ב-Google Analytics 4.
GOOGLE_ANALYTICS_4_PURCHASE המרות שמגיעות מהמרות מקושרות מסוג רכישה ב-Google Analytics 4.

ValueSettings

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

ייצוג JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
שדות
defaultValue

number

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

string

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

boolean

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

ConversionActionCountingType

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

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

AttributionModelSettings

הגדרות שקשורות למודל השיוך (Attribution) של פעולת ההמרה הזו.

ייצוג JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
שדות
attributionModel

enum (AttributionModel)

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

enum (DataDrivenModelStatus)

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

AttributionModel

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EXTERNAL נעשה שימוש בשיוך (Attribution) חיצוני.
GOOGLE_ADS_LAST_CLICK המערכת משייכת את כל הקרדיט על המרה לקליק האחרון שהיא עברה.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK המערכת משייכת את כל הקרדיט להמרה לקליק הראשון על ההמרה באמצעות שיוך (Attribution) בחיפוש Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR המערכת משייכת את הקרדיט על ההמרה באופן שווה לכל הקליקים שלה באמצעות שיוך (Attribution) של חיפוש Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY המערכת משייכת קרדיט גבוה יותר על המרה לקליקים שהתקבלו בזמן האחרון על ידי שיוך (Attribution) בחיפוש Google (מחצית החיים היא שבוע אחד).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED המערכת משייכת 40% מהקרדיט על ההמרה לקליק הראשון ולקליק האחרון שהוביל להמרה. 20% הנותרים מתחלקים באופן שווה בין כל שאר הקליקים. נעשה שימוש בשיוך (Attribution) של חיפוש Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN מודל גמיש שמשתמש בלמידת מכונה כדי לקבוע את החלוקה המתאימה של הקרדיט בין קליקים, באמצעות שיוך בחיפוש Google.

DataDrivenModelStatus

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
AVAILABLE המודל מבוסס-הנתונים זמין.
STALE המודל מבוסס-הנתונים לא פעיל. לא עודכן במשך 7 ימים לפחות. המידע עדיין נמצא בשימוש, אבל התוקף שלו יפוג אם הוא לא יעודכן במשך 30 יום.
EXPIRED פג התוקף של המודל מבוסס-הנתונים. היא לא עודכנה במשך 30 ימים לפחות, ואי אפשר להשתמש בה. בדרך כלל הסיבה לכך היא שלא היה מספר האירועים הנדרש בתקופה של 30 הימים האחרונים.
NEVER_GENERATED המודל מבוסס-הנתונים מעולם לא נוצר. בדרך כלל הסיבה לכך היא שמעולם לא היה מספר האירועים הנדרש בפרק זמן של 30 יום.

FirebaseSettings

הגדרות שקשורות לפעולת המרה ב-Firebase.

ייצוג JSON 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
שדות
propertyId

string (int64 format)

פלט בלבד. מזהה הנכס של ההמרה ב-Google Analytics.
propertyName

string

פלט בלבד. שם הנכס של ההמרה ב-Google Analytics.
eventName

string

פלט בלבד. שם האירוע של המרה ב-Firebase.
projectId

string

פלט בלבד. מזהה הפרויקט ב-Firebase של ההמרה.

ThirdPartyAppAnalyticsSettings

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

ייצוג JSON 
{
  "providerName": string,
  "eventName": string
}
שדות
providerName

string

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

string

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

GoogleAnalytics4Settings

הגדרות שקשורות לפעולת המרה ב-Google Analytics 4.

ייצוג JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
שדות
eventName

string

פלט בלבד. שם האירוע של GA 4.
propertyName

string

פלט בלבד. השם של נכס GA 4.
propertyId

string (int64 format)

פלט בלבד. המזהה של נכס GA 4.