קטגוריות של פעולות המרה

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

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

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

1. איפה מתרחש אירוע ההמרה?

   • מחוץ לאינטרנט (למשל במשרד, במיקום הפיזי של העסק או בטלפון): עוברים לשלב 2.
   • ישירות באתר (לדוגמה, רכישות באתר, הרשמות או שליחת טפסים): עוברים לשלב 3.
   • באפליקציה לנייד: עוברים אל שלב 4.
   • בשיחת טלפון שבוצעה ישירות מהמודעות: משתמשים בשיחות ממודעות (AD_CALL) (באמצעות CallAsset).

2. המרות אופליין:

   • זאת שיחת טלפון?

     • כן: משתמשים

       ייבוא המרות מסוג שיחה (UPLOAD_CALLS) כדי לעקוב אחרי תוצאות השיחות.

   • האם מדובר במכירה בחנות פיזית?

     • כן: משתמשים

       המרות למכירה בחנות הפיזית (STORE_SALES).

   • האם מדובר במכירה אופליין או בהתקדמות של ליד כתוצאה מביקור באתר?

     • כן: משתמשים בהמרות משופרות לצורך שיוך ללידים באמצעות Data Manager API (מומלץ), או מעיינים במאמר ניהול המרות אופליין מקליקים לגבי שילובים קיימים של Google Ads API. (הערה: החל מ-15 ביוני 2026, העלאת המרות מסוג קליקים באמצעות UploadClickConversions מוגבלת לטוקנים למפתחים שהעלו בעבר המרות אופליין מסוג קליקים).

3. המרות אונליין (באתר):

   • רוצים לעקוב אחרי טעינות דפים (רכישות, קבלות) או קליקים של משתמשים?
     • כן: משתמשים ב-Website Conversions (המרות באתר) ומגדירים את קוד התג לערך WEBPAGE או WEBPAGE_ONCLICK.

   • רוצים לעקוב אחרי שיחות שבוצעו למספר טלפון שמופיע באתר שלכם?

     • מעקב אחרי משך השיחות בפועל

       • כן: משתמשים

         שיחות מאתר (WEBSITE_CALL) עם מספר Google לניתוח נתוני שיחות והודעות (GFN) דינמי וקטע קוד של אירוע (event snippet) של תג.

       • לא (אני רוצה לעקוב רק אחרי קליקים על לחצנים או קישורים באתר לנייד) שימוש

         קליקים על מספר הטלפון הנייד שלכם (CLICK_TO_CALL).

4. המרות באפליקציה לנייד:

   • האם מספיק לעקוב אחרי התקנות או רכישות מחנות Google Play?
     • כן: משתמשים בהמרות באפליקציה (GOOGLE_PLAY_DOWNLOAD או GOOGLE_PLAY_IN_APP_PURCHASE).

   • האם אתם עוקבים אחרי פעולות באפליקציה באמצעות Google Analytics (GA4) או ניתוח נתוני אפליקציות של צד שלישי?

     • כן: משתמשים

       ניתוח נתונים ב-Firebase ובאפליקציות צד שלישי (על ידי הפעלת פעולות המרה מסוג FIREBASE_* או THIRD_PARTY_*).

המרות אופליין

אזהרה: החל מ-15 ביוני 2026, בקשות UploadClickConversions ייכשלו אם טוקן המפתח לא שלח בעבר בקשות להעלאת המרות אופליין או המרות משופרות לצורך שיוך ללידים. במקום זאת, צריך להשתמש ב-Data Manager API. פרטים נוספים זמינים במאמר תכונות שהוצאו משימוש.

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

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

בטבלה הבאה מפורטים הפרמטרים המקבילים של ה-API‏ ConversionActionType שבהם צריך להשתמש לכל מקור בממשק האינטרנט של Google Ads, וקישור למאמרי העזרה של כל אחד מסוגי פעולות ההמרה:

סוג פעולת ההמרה	המקור ב-Google Ads	מדריך להגדרת ה-API
UPLOAD_CLICKS	מעקב אחרי המרות מקליקים והמרות משופרות לצורך שיוך ללידים	משתמשים ב-Data Manager API (מומלץ) או מעיינים במאמר ניהול המרות אופליין מקליקים לשילובים קיימים של Google Ads API
UPLOAD_CALLS	מעקב אחר המרות משיחות	מדריך לייבוא המרות מסוג שיחה
STORE_SALES	מעקב אחרי המרות מסוג מכירות בחנות הפיזית	פרטים נוספים זמינים במאמר מכירות בחנות פיזית: ייבוא לפעולת המרה עם דיווח.

המרות אונליין (באתר)

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

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

‫ConversionAction כולל כמה סוגים של המרות באתר, שמובחנים ב-API באמצעות השדה type בכל TagSnippet שמופיע בשדה tag_snippets של ConversionAction.

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

בטבלה הבאה מפורטים הפרמטרים המקבילים של API שצריך להשתמש בהם לכל מקור בממשק האינטרנט של Google Ads:

סוג קוד המעקב	המקור ב-Google Ads
WEBPAGE	אתר, אתר (Google Analytics‏ (GA4))
WEBPAGE_ONCLICK	אתר, אתר (Google Analytics‏ (GA4))
CLICK_TO_CALL	קליקים על מספר טלפון

הערה: המקורות של WEBPAGE ו-WEBPAGE_ONCLICK זהים למקורות של האתר. ההבדל הוא באפשרות קטע קוד של אירוע (event snippet) בממשק האינטרנט. ‫WEBPAGE מתאים לטעינת דף באפשרות הזו, ו-WEBPAGE_ONCLICK מתאים לקליק. מידע נוסף זמין במאמר הזה במרכז העזרה.

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

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

בטבלה הבאה מפורטים הפרמטרים המקבילים של ConversionActionType API שצריך להשתמש בהם לכל מקור בממשק האינטרנט של Google Ads:

סוג פעולת ההמרה	המקור ב-Google Ads
GOOGLE_PLAY_DOWNLOAD	‫Google Play > התקנות
GOOGLE_PLAY_IN_APP_PURCHASE	‫Google Play > רכישות באפליקציה

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

הערה: אם מציינים גם את השדה category, צריך להגדיר אותו לערך DOWNLOAD רק אם סוג ההמרה הוא GOOGLE_PLAY_DOWNLOAD.

המרות מסוג שיחות טלפון

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

בטבלה הבאה מפורטים הפרמטרים המקבילים של ConversionActionType API שצריך להשתמש בהם לכל מקור בממשק האינטרנט של Google Ads:

סוג פעולת ההמרה	המקור ב-Google Ads
AD_CALL	שיחות ממודעות עם תוספי שיחה או ממודעות לשיחות בלבד
WEBSITE_CALL	שיחות אל מספר טלפון באתר
CLICK_TO_CALL	קליקים על מספר באתר לנייד

AD_CALL

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

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

WEBSITE_CALL

פעולה של WEBSITE_CALL מופיעה כהמרה מסוג שיחות מאתר בממשק האינטרנט של Google Ads.

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

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

CLICK_TO_CALL

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

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

המרות משופרות

אזהרה: החל מ-15 ביוני 2026, בקשות UploadClickConversions ייכשלו אם לא נשלחו בעבר בקשות באמצעות אסימון הפיתוח להעלאת המרות אופליין או המרות משופרות לצורך שיוך ללידים. במקום זאת, צריך להשתמש ב-Data Manager API. פרטים נוספים זמינים במאמר תכונות שהוצאו משימוש.

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

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

בטבלה הבאה מוצגים הפרמטרים המקבילים ב-API שצריך להשתמש בהם לכל סוג של המרה משופרת:

סוג פעולת ההמרה	סוג ההמרה המשופרת	מדריך להגדרת ה-API
UPLOAD_CLICKS	המרות משופרות לצורך שיוך ללידים שיפור המדידה של עסקאות אופליין שהגיעו מליד או ממבקר באתר	משתמשים ב-Data Manager API (מומלץ) או מעיינים במאמר ניהול המרות אופליין מקליקים כדי לראות שילובים קיימים של Google Ads API.
WEBPAGE	תיעוד המרות משופר באתרים שיפור המדידה של המרות אונליין	מדריך להגדרת ה-API

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

‫Google Ads API מציג בדוחות סוגים נוספים של פעולות המרה, אבל יכול להיות שהיצירה או השינוי של הפעולות האלה יהיו אסורות או מוגבלות. אפשר לשלוח שאילתה לגבי פעולות ההמרה והסוגים שלהן באמצעות GoogleAdsService:

SELECT
  conversion_action.id,
  conversion_action.name,
  conversion_action.type,
  conversion_action.status
FROM conversion_action

המרות ב-SKAdNetwork

אם אתם מפעילים קמפיינים לקידום אפליקציות ל-iOS והטמעתם את SKAdNetwork, תוכלו לגשת לנתוני SKAdNetwork שסופקו ל-Google ברמה של Customer ו-Campaign דרך המקורות הבאים:

השדה בדוח	תיאור
metrics.sk_ad_network_installs	מספר ההתקנות שדווח על ידי חברת אפל. אפשר לפלח את המדד הזה רק לפי שילוב של segments.sk_ad_network_conversion_value ופלחים שקשורים לתאריך.
metrics.sk_ad_network_total_conversions	המספר הכולל של ההמרות, עם התקנות וסוגים אחרים של המרות שדווחו על ידי אפל. אפשר לפלח את המדד הזה רק לפי פלחים שקשורים ל-SKAdNetwork ולפי פלחים שקשורים לתאריכים.
segments.sk_ad_network_ad_event_type	סוג האירוע שהתרחש בהמרה מסוימת.
segments.sk_ad_network_attribution_credit	איך השיוך ניתן להמרה מסוימת.
segments.sk_ad_network_fine_conversion_value	הערך של המרה שדווחה על ידי אפל. אי אפשר להחיל את הפלח הזה על מדדים אחרים מלבד metrics.sk_ad_network_installs‏ ו-metrics.sk_ad_network_total_conversions, ואפשר לשלב אותו רק עם פלחים שקשורים לתאריך. רק אם אפל מדווחת על ערך של 0, מוחזר ערך של 0. אחרת לא מוחזר ערך. כדי להבחין בין שני המקרים, צריך לבדוק אם יש נוכחות של השדה.
segments.sk_ad_network_coarse_conversion_value	הערך הגס של המרה ספציפית.
segments.sk_ad_network_postback_sequence_index	המיקום של הדיווח החוזר על המרה (PostBack) ברצף, להמרה מסוימת.
segments.sk_ad_network_source_app.sk_ad_network_source_app_id	מזהה האפליקציה שבה הוצגה המודעה שהובילה להתקנה של iOS Store Kit Ad Network.
segments.sk_ad_network_source_domain	האתר שבו הוצגה המודעה שהובילה להתקנה של iOS Store Kit Ad Network. ערך null מציין שהפלח הזה לא רלוונטי – למשל, אם מדובר בקמפיין שלא מיועד למשתמשי iOS – או שהוא לא הופיע באף אחד מהדיווחים החוזרים שאפל שלחה.
segments.sk_ad_network_source_type	סוג המקור שבו הוצגה המודעה שהובילה להתקנה של iOS Store Kit Ad Network. ערך null מציין שהפלח הזה לא רלוונטי – למשל, אם מדובר בקמפיין שלא מיועד למשתמשי iOS – או שאף אחד מהדומיין של המקור או מהאפליקציה של המקור לא הופיעו באף אחד מהדיווחים החוזרים שאפל שלחה.
segments.sk_ad_network_user_type	סוג המשתמש שיצר המרה מסוימת.
segments.sk_ad_network_redistributed_fine_conversion_value	ערכי ההמרות בפלח הזה כוללים ערכי null שחולקו מחדש לערכי המרות. הפלח הזה מייצג את הסכום של ערכי ההמרות המפורטים שנמדדו והוחזרו על ידי אפל, וערכי Null לפי מודל מ-Google.
segments.sk_ad_network_version	גרסת ה-API של iOS Store Kit Ad Network שבה נעשה שימוש.

Google Analytics

בהמרות מנכס מקושר ב-Google Analytics יש אחד מהערכים הבאים של type:

• המרה בנכס GA4:

  • GOOGLE_ANALYTICS_4_CUSTOM
  • GOOGLE_ANALYTICS_4_PURCHASE

  אפשר גם לאחזר את מזהה הנכס ב-GA4, את שם הנכס ואת שם האירוע מהשדה google_analytics_4_settings.

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

• לייבא את ההמרה מנכס GA4 לחשבון Google Ads. כדי לעשות את זה, משנים את הערך בשדה status מ-HIDDEN ל-ENABLED.
• לשנות את השדות primary_for_goal ו-category כדי לציין איך היא תשפיע על הצעות המחיר והדוחות ב-Google Ads.
• לעדכן את name או את value_settings.
• להסיר את ההמרה מחשבון Google Ads עם פעולת remove.

כל ניסיון לשנות מאפיינים אחרים של המרה שיובאה מ-GA4 או מאפיינים כלשהם של המרה שיובאה מ-Universal Analytics יגרום לשגיאת MUTATE_NOT_ALLOWED. אפשר לבצע את השינויים האלה רק בממשק המשתמש של Google Ads.

ניתוח נתונים ב-Firebase ובאפליקציות צד שלישי

כדי לייבא המרות מניתוח נתוני אפליקציות של צד שלישי או מ-Firebase, משנים את הערך של status של ConversionAction מ-HIDDEN ל-ENABLED באמצעות השיטה mutate של ConversionActionService. אי אפשר לעדכן את app_id בפעולות ההמרה האלה.

• FIREBASE_ANDROID_APP_AD_IMPRESSION
• FIREBASE_ANDROID_FIRST_OPEN
• FIREBASE_ANDROID_IN_APP_PURCHASE
• FIREBASE_ANDROID_CUSTOM
• FIREBASE_IOS_APP_AD_IMPRESSION
• FIREBASE_IOS_FIRST_OPEN
• FIREBASE_IOS_IN_APP_PURCHASE
• FIREBASE_IOS_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

מכירות בחנות פיזית: ייבוא לפעולת המרה עם דיווח

חשוב: שדרגו את תהליכי העבודה של המכירות בחנות הפיזית ל-Data Manager API כדי ליהנות מחוויית פיתוח משופרת ומגישה לתכונות נוספות. אנחנו לא ממליצים להטמיע תהליכי עבודה חדשים של מכירות בחנות הפיזית באמצעות Google Ads API.

למרות שאי אפשר ליצור פעולות המרה מסוג STORE_SALES או STORE_SALES_DIRECT_UPLOAD באמצעות Google Ads API, ‏ ה-API תומך בייבוא של עסקאות מכירה בחנות פיזית.

• STORE_SALES
• STORE_SALES_DIRECT_UPLOAD

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

סוגי פעולות ההמרה הבאים הם לקריאה בלבד ב-Google Ads API, והם מיועדים למטרות דיווח.

• ANDROID_APP_PRE_REGISTRATION
• ANDROID_INSTALLS_ALL_OTHER_APPS
• FLOODLIGHT_ACTION
• FLOODLIGHT_TRANSACTION
• GOOGLE_HOSTED
• LEAD_FORM_SUBMIT
• SALESFORCE
• SEARCH_ADS_360
• SMART_CAMPAIGN_AD_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_DIRECTIONS
• SMART_CAMPAIGN_TRACKED_CALLS
• STORE_VISITS
• WEBPAGE_CODELESS

לא ידוע

אם החשבון שלכם ב-Google Ads כולל סוגים אחרים של פעולות המרה, יכול להיות שהשאילתות והדוחות יחזירו פעולות המרה שבהן הערך של ConversionAction.type הוא UNKNOWN. ה-API לא תומך בניהול פעולות ההמרה האלה, אבל הוא מחזיר אותן בדוחות כדי לספק תוצאות מלאות למדדי המרה מרכזיים כמו metrics.conversions ו-metrics.conversions_value.