במדריך הזה מפורטים סוגים שונים של פעולות המרה שאפשר ליצור באמצעות Google Ads API, ומוסבר איך הם ממופים לממשק האינטרנט של Google Ads.
המרות אופליין
המרות אופליין עוזרות לכם לעקוב אחרי אירועי המרה שמתרחשים מחוץ לאינטרנט, למשל במשרד, במיקום העסק או בטלפון.
בטבלה הבאה מפורטים הפרמטרים המקבילים של ConversionActionType
API שבהם צריך להשתמש עבור כל מקור בממשק האינטרנט של Google Ads, וקישור לתיעוד של כל סוג ספציפי של פעולת המרה:
סוג פעולת ההמרה | המקור ב-Google Ads | API Setup Guide |
---|---|---|
UPLOAD_CLICKS |
מעקב אחרי המרות מקליקים והמרות משופרות לצורך שיוך ללידים | מדריך לניהול המרות אופליין של קליקים
מדריך להמרות משופרות לצורך שיוך ללידים |
UPLOAD_CALLS |
מעקב אחר המרות משיחות | מדריך לייבוא המרות מסוג שיחות |
STORE_SALES |
מעקב אחרי המרות למכירות בחנות הפיזית | מדריך לייבוא המרות של מכירות בחנות |
המרות אונליין (באתר)
המרות באתר מאפשרות לעקוב אחרי פעולות באתר, כמו מכירות אונליין, קליקים על קישורים, צפיות בדפים והרשמות.
כדי לעקוב אחרי המרות באתר, צריך ליצור ConversionAction
עם הערך WEBPAGE
של ConversionActionType
, ולהוסיף לדף ההמרה באתר קטע קוד שנקרא תג.
השדה ConversionAction
כולל כמה סוגים של המרות באתר, שמובחנים ב-API באמצעות השדה type
בכל TagSnippet
שמופיע בשדה tag_snippets של ConversionAction
.
TagSnippet
מספק את קוד המעקב שצריך לכלול באתר כדי לעקוב אחרי פעולות ההמרה.
המרות מסוג אתר וקליק על מספר טלפון דורשות את התגים
event_snippet
ו-
global_site_tag
. את התג 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 Setup Guide |
---|---|---|
UPLOAD_CLICKS |
המרות משופרות לצורך שיוך ללידים
שיפור המדידה של עסקאות אופליין שהגיעו מליד או ממבקר באתר |
מדריך להגדרת API |
WEBPAGE |
המרות משופרות לאינטרנט
שיפור המדידה של המרות אונליין |
מדריך להגדרת API |
סוגים נוספים של פעולות המרה
Google Ads API מאפשר לכם לראות בדוחות סוגים נוספים של פעולות המרה, אבל יכול להיות שהוא יגביל או יאסור על יצירה או שינוי של הפעולות האלה.
המרות ב-SKAdNetwork
אם אתם מפעילים קמפיינים לקידום אפליקציות ל-iOS והטמעתם את SKAdNetwork, תוכלו לגשת לנתוני SKAdNetwork שסופקו ל-Google ברמה של Customer
ו-Campaign
באמצעות המקורות הבאים:
השדה בדוח | תיאור |
---|---|
metrics.sk_ad_network_installs |
מספר ההתקנות שדווח על ידי Apple. אפשר לפלח את המדד הזה רק לפי כל שילוב של 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 |
איך הקרדיט על שיוך (Attribution) משויך להמרה מסוימת. |
segments.sk_ad_network_fine_conversion_value |
הערך של המרה שדווחה על ידי אפל. אי אפשר להחיל את הפלח הזה על מדדים אחרים מלבד מוחזר ערך של |
segments.sk_ad_network_coarse_conversion_value |
הערך המשוער של המרה ספציפית. |
segments.sk_ad_network_postback_sequence_index |
המיקום של הפוסטבק ברצף, עבור המרה מסוימת. |
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 שחולקו מחדש לערכי המרות. הפלח הזה מייצג את הסכום של ערכי ההמרות המפורטים שנמדדו והוחזרו על ידי Apple, וערכי Null לפי מודל מ-Google. |
segments.sk_ad_network_version |
הגרסה של iOS Store Kit Ad Network API שבה נעשה שימוש. |
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_FIRST_OPEN
FIREBASE_ANDROID_IN_APP_PURCHASE
FIREBASE_ANDROID_CUSTOM
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
.