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)

הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.
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

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

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

ייצוג 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 המערכת משייכת קרדיט גבוה יותר על המרה לקליקים שהתקבלו בתקופה האחרונה באמצעות שיוך בחיפוש 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

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

string (int64 format)

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