הצטרפו אלינו בשידור חי ב-Discord בשרת של קהילת הפרסום והמדידה של Google וב-YouTube ב-15 באוקטובר בשעה 10:00 (שעון החוף המזרחי של ארה"ב). נדבר על התכונות החדשות שנוספו בגרסה 26 של Google Ads API.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

בחירת סוג פעולת ההמרה הנכון

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

איפה מתרחש אירוע ההמרה?
- בעולם האופליין (לדוגמה, במשרד, במיקום הפיזי של העסק או בטלפון): עוברים אל שלב 2.
- ישירות באתר (לדוגמה, רכישות באתר, הרשמות או שליחת טפסים): עוברים אל שלב 3.
- באפליקציה לנייד: עוברים אל שלב 4.
- בשיחת טלפון שבוצעה ישירות מהמודעות: משתמשים בשיחות ממודעות (AD_CALL) (באמצעות CallAsset).
המרות אופליין:
- האם זאת שיחת טלפון?
  - כן: משתמשים
    
    ייבוא המרות מסוג שיחה (UPLOAD_CALLS) כדי לעקוב אחרי תוצאות השיחות.
- האם מדובר במכירה בחנות פיזית?
  - כן: משתמשים
    
    ‫המרה למכירה בחנות פיזית (STORE_SALES).
- האם מדובר במכירה אופליין או בהתקדמות של ליד כתוצאה מביקור באתר?
  - כן: אתם יכולים להשתמש בתכונה המרות משופרות לצורך שיוך ללידים באמצעות Data Manager API (מומלץ), או לעיין במאמר ניהול המרות אופליין מקליקים לגבי שילובים קיימים של Google Ads API. (הערה: החל מ-15 ביוני 2026, העלאה של המרות מקליקים באמצעות UploadClickConversions מוגבלת לטוקנים למפתחים שבעבר העלו המרות אופליין מקליקים).
המרות אונליין (באתר):
- האם אתם רוצים לעקוב אחרי טעינות דפים (רכישות, קבלות) או אחרי קליקים של משתמשים?
  - כן: משתמשים בהמרות באתר עם קוד התג שהוגדר לערך WEBPAGE או WEBPAGE_ONCLICK.
- רוצים לעקוב אחרי שיחות שהתקבלו ממספר טלפון שמופיע באתר שלכם?
  - מעקב אחרי משך השיחות בפועל
    - כן: משתמשים
      
      שיחות מאתר (WEBSITE_CALL) עם מספר Google לניתוח נתוני שיחות והודעות (GFN) וקטע קוד של אירוע (event snippet).
    - לא (רק לעקוב אחרי קליקים על לחצן או על קישור באתר לנייד)? שימוש
      
      קליקים על מספר הטלפון בנייד (CLICK_TO_CALL).
המרות באפליקציה לנייד:
- האם מעקב אחרי התקנות או הרכישות מחנות Google Play מספיק?
  - כן: משתמשים בהמרות באפליקציה (GOOGLE_PLAY_DOWNLOAD או GOOGLE_PLAY_IN_APP_PURCHASE).
- האם אתם עוקבים אחרי פעולות באפליקציה באמצעות Google Analytics (GA4) או ניתוח נתוני אפליקציות של צד שלישי?
  - כן: משתמשים
    
    ניתוח נתונים ב-Firebase ובאפליקציות צד שלישי (על ידי הפעלת פעולות המרה מסוג FIREBASE_* או THIRD_PARTY_*).

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

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

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

סוג פעולת ההמרה	המקור ב-Google Ads	מדריך להגדרת ה-API
`UPLOAD_CLICKS`	מעקב אחרי המרות מקליקים והמרות משופרות לצורך שיוך ללידים	אם יש לכם שילובים קיימים של Google Ads API, מומלץ להשתמש ב-Data Manager 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`	קליקים על מספר טלפון

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

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

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

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

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

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

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

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

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

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

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

למרות שאי אפשר ליצור פעולות המרה מסוג 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.

סקירה כללית

איך מתחילים לעבוד עם המרות