שינוי של דוח מודעות ב-Facebook

במאמר הזה מוסבר איך הדוחות שלכם ב-Facebook Ads עוברים טרנספורמציה כשאתם מריצים העברה של נתונים מ-Facebook Ads אל BigQuery.

מיפוי טבלאות בדוחות של מודעות פייסבוק

כשדוחות של Facebook Ads מועברים ל-BigQuery, הם משתנים לטבלאות ולתצוגות הבאות ב-BigQuery.

דוח AdAccounts

שם השדה ב-Meta API	שם השדה הממופה ב-BigQuery	סוג	תיאור
id	מזהה [KEY]	מחרוזת	המזהה של חשבון הפרסום.
	יעד	מחרוזת	היעד שממנו המערכת מאחזרת חשבונות פרסום. הערך הוא null – כדי לקבל את כל חשבונות Google Ads.
account_id	AccountId	מחרוזת	המזהה של חשבון הפרסום כשמציגים אותו ישירות בפייסבוק.
account_status	AccountStatus	מספר שלם	הסטטוס של החשבון. ‫1 = פעיל, 2 = מושבת, 3 = לא מוסדר, 7 = בהמתנה לבדיקה, 9 = בתקופת חסד, 101 = זמין באופן זמני, 100 = בהמתנה לסגירה.
age	גיל	כפול	משך הזמן שהחשבון הפרסומי פתוח, בימים.
amount_spent	AmountSpent	מספר שלם	הסכום הכולל הנוכחי שהוצא בחשבון. אפשר לאפס את ההגדרה הזו.
balance	יתרה	מספר שלם	הסכום לתשלום בחשבונית.
business_city	BusinessCity	מחרוזת	העיר שבה נמצאת כתובת העסק.
business_country_code	BusinessCountryCode	מחרוזת	קוד המדינה של כתובת העסק.
business_name	BusinessName	מחרוזת	שם העסק בחשבון.
business_state	BusinessState	מחרוזת	קיצור שם המדינה של כתובת העסק.
business_street	BusinessStreet	מחרוזת	השורה הראשונה של כתובת העסק בחשבון.
business_street2	BusinessStreet2	מחרוזת	השורה השנייה של כתובת העסק בחשבון.
business_zip	BusinessZip	מחרוזת	המיקוד של כתובת העסק.
capabilities	יכולות	מחרוזת	היכולות שמותרות בחשבון הפרסום הזה.
created_time	CreatedTime	תאריך ושעה	השעה שבה נוצר החשבון.
currency	מטבע	מחרוזת	המטבע שמוגדר בחשבון, על סמך הערך התואם בהגדרות החשבון.
min_campaign_group_spend_cap	MinCampaignGroupSpendCap	מחרוזת	תקרת ההוצאות המינימלית של קבוצת הקמפיינים.
name	שם	מחרוזת	שם החשבון. שימו לב: להרבה חשבונות אין שם, ולכן השדה הזה עשוי להיות ריק.
offsite_pixels_tos_accepted	OffsitePixelsTosAccepted	מחרוזת	השדה מציין אם נחתם חוזה התנאים וההגבלות של פיקסל מחוץ לאתר.
owner	OwnerId	מחרוזת	מזהה פייסבוק של הבעלים של חשבון הפרסום.
spend_cap	SpendCap	מספר שלם	הסכום המקסימלי שאפשר להוציא בחשבון הזה, שאחריו הקמפיינים יושהו. הערך 0 מציין שאין מגבלת הוצאות.
timezone_id	TimezoneId	מחרוזת	המזהה של אזור הזמן.
timezone_name	TimezoneName	מחרוזת	שם אזור הזמן.
timezone_offset_hours_utc	TimezoneOffsetHoursUTC	כפול	ההפרש בין אזור הזמן לבין UTC.

דוח AdInsights

שם השדה ב-Meta API	שם השדה הממופה ב-BigQuery	סוג	תיאור
	יעד	מחרוזת	המזהה של החשבון שעבורו רוצים לקבל תובנות.
date_start	DateStart	תאריך	תאריך ההתחלה לשליפת תובנות. בממשק המשתמש של פייסבוק, זהו השדה Report Start (תחילת הדוח).
date_stop	DateEnd	תאריך	תאריך הסיום של התקופה שרוצים לקבל לגביה תובנות. בממשק המשתמש של פייסבוק, זהו השדה Report End (סיום הדוח).
	TimeIncrement	מחרוזת	מספר הימים של צבירת הנתונים. הערך הזה מוגדר ל-1.
	רמה	מחרוזת	הרמה שבה התוצאות יוצגו. הערך הזה מוגדר כ-`ad`.
account_currency	AccountCurrency	מחרוזת	המטבע שמוגדר בחשבון הפרסום.
action_attribution_windows	ActionAttributionWindows	מחרוזת	רשימה מופרדת בפסיקים שקובעת מהו חלון השיוך לפעולות. לדוגמה, 28d_click פירושו שה-API מחזיר את כל הפעולות שהתרחשו 28 ימים אחרי שמשתמש לחץ על המודעה. האפשרות הזו מוגדרת כ-‎[1d_view,28d_click]‎.
account_id	AdAccountId	מחרוזת	המזהה של חשבון הפרסום שמשויך לשורת הדוח.
account_name	AdAccountName	מחרוזת	השם של החשבון ב-Google Ads שמשויך לשורת הדוח.
campaign_id	CampaignId	מחרוזת	המזהה של הקמפיין שמשויך לשורת הדוח.
campaign_name	CampaignName	מחרוזת	שם הקמפיין שמשויך לשורה בדוח.
adset_id	AdSetId	מחרוזת	המזהה של קבוצת המודעות שמשויכת לשורת הדוח.
adset_name	AdSetName	מחרוזת	השם של קבוצת המודעות שמשויכת לשורה בדוח.
ad_id	AdId	מחרוזת	המזהה של המודעה שמשויכת לשורת הדוח.
ad_name	AdName	מחרוזת	השם של המודעה שמשויכת לשורה בדוח.
buying_type	BuyingType	מחרוזת	השיטה שבה משלמים על מודעות מטורגטות בקמפיינים.
clicks	קליקים	Long	מספר הקליקים הכולל על המודעה. בהתאם למה שמקדמים, זה יכול לכלול לייקים לדף, תגובות לאירועים או התקנות של אפליקציות. בממשק המשתמש של פייסבוק, זהו השדה 'קליקים (הכול)'.
conversion_rate_ranking	ConversionRateRanking	מחרוזת	הדירוג של שיעור ההמרה.
cost_per_estimated_ad_recallers	CostPerEstimatedAdRecallers	עשרוני	העלות הממוצעת לכל אדם נוסף שלפי ההערכה שלנו יזכור שראה את המודעה שלכם אם ישאלו אותו על כך תוך יומיים.
cost_per_inline_link_click	CostPerInlineLinkClick	עשרוני	העלות הממוצעת לקליק על קישורים במודעה.
cost_per_inline_post_engagement	CostPerInlinePostEngagement	עשרוני	העלות הממוצעת לאינטראקציה ראשונית (CPE) עם הפוסט.
cost_per_unique_click	CostPerUniqueClick	עשרוני	העלות הממוצעת לכל קליק ייחודי על המודעות האלה, שמחושבת כסכום ההוצאה חלקי מספר הקליקים הייחודיים שהתקבלו.
cost_per_unique_inline_link_click	CostPerUniqueInlineLinkClick	עשרוני	העלות הממוצעת ששילמתם על כל קליק ייחודי על קישור בתוך הטקסט.
cpc	עלות לקליק	עשרוני	העלות הממוצעת לקליק על המודעות האלה, שמחושבת לפי הנוסחה הבאה: הסכום שהוצא חלקי מספר הקליקים שהתקבלו.
cpm	CPM	עשרוני	העלות הממוצעת ששילמתם על 1,000 חשיפות של המודעה.
cpp	על"ט	עשרוני	העלות הממוצעת ששילמתם כדי שהמודעה תוצג ל-1,000 אנשים ייחודיים.
ctr	שיעור קליקים	כפול	מספר הקליקים שקיבלתם חלקי מספר החשיפות. בממשק המשתמש של פייסבוק, זהו השדה 'שיעור הקליקים (הכולל) %'.
estimated_ad_recall_rate	EstimatedAdRecallRate	כפול	מספר האנשים המשוער שזוכרים את המודעה חלקי מספר האנשים שהמודעה הגיעה אליהם.
estimated_ad_recallers	EstimatedAdRecallers	כפול	המספר הנוסף של אנשים שלפי ההערכה שלנו יזכרו שראו את המודעות שלכם אם ישאלו אותם על כך תוך יומיים.
frequency	תדירות	כפול	מספר הפעמים הממוצע שבהן המודעה הוצגה לכל אדם.
impressions	הופעות	Long	מספר הפעמים שהמודעה הוצגה. באפליקציות לנייד, מודעה נספרת כמודעה שהוצגה בפעם הראשונה שהיא מוצגת. בכל הממשקים האחרים של פייסבוק, מודעה מוצגת בפעם הראשונה שהיא מופיעה בפיד החדשות של משתמש או בכל פעם שהיא מופיעה בעמודה השמאלית.
inline_link_clicks	InlineLinkClicks	Long	מספר הקליקים הכולל על קישורים במודעה.
inline_link_click_ctr	InlineLinkClicksCounter	כפול	שיעור הקליקים על קישורים בתוך הטקסט.
inline_post_engagement	InlinePostEngagement	Long	המספר הכולל של האינטראקציות הראשוניות עם הפוסט.
instant_experience_clicks_to_open	InstantExperienceClicksToOpen	Long	תואם לשדה instant_experience_clicks_to_open מ-META API.
instant_experience_clicks_to_start	InstantExperienceClicksToStart	Long	תואם לשדה instant_experience_clicks_to_start מ-META API.
instant_experience_outbound_clicks	InstantExperienceOutboundClicks	Long	תואם לשדה instant_experience_outbound_clicks מ-META API.
objective	מטרה	מחרוזת	היעד שבחרתם לקמפיין. היעד משקף את המטרה שרוצים להשיג באמצעות הפרסום.
quality_ranking	QualityRanking	מחרוזת	דירוג האיכות.
reach	הגעה עד כה	Long	מספר האנשים שהמודעה הוצגה להם.
spend	הוצאה	עשרוני	הסכום הכולל שהוצאתם עד עכשיו.
	UniqueClicks	Long	המספר הכולל של אנשים ייחודיים שלחצו על המודעה. לדוגמה, אם 3 אנשים לוחצים על אותה מודעה 5 פעמים, המערכת סופרת 3 קליקים ייחודיים.
	UniqueCTR	כפול	מספר האנשים שלחצו על המודעה חלקי מספר האנשים שהמודעה הגיעה אליהם. לדוגמה, אם קיבלתם 20 קליקים ייחודיים והמודעה שלכם הוצגה ל-1,000 אנשים ייחודיים, שיעור הקליקים הייחודי יהיה 2%.
inline_link_clicks	UniqueInlineLinkClicks	Long	מספר הקליקים הייחודיים על קישור מוטבע שהמודעה קיבלה. בממשק המשתמש של פייסבוק, זהו השדה 'קליקים ייחודיים על קישור'.
	UniqueInlineLinkClickCounter	כפול	שיעור הקליקים הייחודיים על קישור בתוך הטקסט.
	UniqueLinkClicksCounter	כפול	שיעור הקליקים הייחודיים על קישור. מספר האנשים שלחצו על הקישור במודעה שלכם שמפנה אנשים אל מחוץ לפייסבוק, חלקי מספר האנשים שהמודעה הגיעה אליהם. לדוגמה, אם קיבלתם 20 קליקים ייחודיים על קישור והמודעה שלכם הוצגה ל-1,000 אנשים ייחודיים, שיעור הקליקים הייחודי יהיה 2%.
	צ'ק-אין	Int	מספר הצ'ק-אין שמשויכים למודעה.
	EventResponses	Int	מספר התגובות לאירועים ששויכו למודעה.
inline_link_clicks	LinkClicks	Int	מספר הקליקים על הקישור שמשויכים למודעה.
	OfferSaves	Int	מספר ההצעות לקבלת מודעות שמשויכות למודעה.
outbound_clicks	OutboundClicks	Int	מספר הקליקים היוצאים שמשויכים למודעה.
	PageEngagements	Int	מספר האינטראקציות עם הדף שמשויכות למודעה.
	PageLikes	Int	מספר הלייקים לדף שמשויכים למודעה.
	PageMentions	Int	מספר האזכורים של הדף שמשויכים למודעה.
	PagePhotoViews	Int	מספר הצפיות בתמונות שמשויכות למודעה.
	PostComments	Int	מספר התגובות לפוסט שמשויכות למודעה.
	PostEngagements	Int	מספר האינטראקציות הראשוניות עם הפוסט ששויכו למודעה.
	PostShares	Int	מספר השיתופים של הפוסט ששויכו למודעה.
	PostReactions	Int	מספר האינטראקציות עם הפוסט ששויכו למודעה.
	PageTabViews	Int	מספר הצפיות בכרטיסייה שמשויכות למודעה.
	אזור	מחרוזת	האזור שבו המשתמש צפה במודעה. זהו שדה פירוט.
	Video3SecondViews	Int	מספר הצפיות בסרטון שמשויכות למודעה. צפיות נספרות אם הסרטון הופעל למשך 3 שניות לפחות, או אם הסרטון קצר מ-3 שניות והוא הופעל כולו.
פירוטים כלליים
	גיל	מחרוזת	טווח הגילאים של המדדים בשורה הזו.
	מגדר	מחרוזת	המגדר של המדדים בשורה הזו.
	מדינה	מחרוזת	המדינה שבה נמדדים המדדים בשורה הזו.
	אזור	מחרוזת	האזור שבו המשתמש צפה במודעה.
	FrequencyValue	מחרוזת	מספר הפעמים שבהן מודעה בקמפיין להגדלת היקף החשיפה ותדירות הצפייה הוצגה לכל אדם.
	HStatsByAdvertiserTZ	מחרוזת	תקופת הזמן שבה נאספו הנתונים הסטטיסטיים של המפרסם.
	HStatsByAudienceTZ	מחרוזת	תקופת הזמן שבה נאספו הנתונים הסטטיסטיים לגבי הקהל.
	ImpressionDevice	מחרוזת	המכשירים שבהם המודעה הוצגה.
	PlatformPosition	מחרוזת	המיקום בפלטפורמה.
	PublisherPlatform	מחרוזת	הפלטפורמות שבהן פורסמו המודעות.
	ProductId	מחרוזת	מזהה המוצר שפורסם במודעה.

דוח AdInsightsActions

ACTION_COLLECTION מתייחס לסוגי הפעולות שאנשים ביצעו בתגובה למודעה שלכם. רשימה מלאה של אוספי פעולות מופיעה במאמר אוספי פעולות.

שם השדה ב-Meta API	שם השדה הממופה ב-BigQuery	סוג	תיאור
	יעד	מחרוזת	מזהה החשבון שעבורו רוצים לקבל תובנות.
date_start	DateStart	תאריך	תאריך ההתחלה לשליפת תובנות. בממשק המשתמש של פייסבוק, זהו השדה Report Start (תחילת הדוח).
date_stop	DateEnd	תאריך	תאריך הסיום של התקופה שרוצים לקבל לגביה תובנות. בממשק המשתמש של פייסבוק, זהו השדה Report End (סיום הדוח).
	TimeIncrement	מחרוזת	מספר הימים של צבירת הנתונים. הערך הזה מוגדר כ-1.
	רמה	מחרוזת	הרמה שבה התוצאות יוצגו. הערך שנקבע הוא ad.
action_attribution_windows	ActionAttributionWindows	מחרוזת	רשימה מופרדת בפסיקים שקובעת מהו חלון השיוך לפעולות. לדוגמה, 28d_click פירושו שה-API מחזיר את כל הפעולות שהתרחשו 28 ימים אחרי שמשתמש לחץ על המודעה. אפשרות ברירת המחדל היא [1d_view,7d_click]. הערכים האפשריים כוללים: 1d_view, ‏ 7d_view, ‏ 28d_view, ‏ 1d_click, ‏ 7d_click, ‏ 28d_click, ‏ default.
	ActionCollection	מחרוזת	הנתון הזה מגיע מבחירת אוספי הפעולות בהעברה.
account_id	AdAccountId	מחרוזת	המזהה של החשבון הפרסומי שמשויך לשורת הדוח.
account_name	AdAccountName	מחרוזת	השם של החשבון הפרסומי שמשויך לשורת הדוח.
campaign_id	CampaignId	מחרוזת	המזהה של הקמפיין שמשויך לשורת הדוח.
campaign_name	CampaignName	מחרוזת	השם של הקמפיין שמשויך לשורת הדוח.
adset_id	AdSetId	מחרוזת	המזהה של קבוצת המודעות שמשויכת לשורת הדוח.
adset_name	AdSetName	מחרוזת	השם של קבוצת המודעות שמשויכת לשורת הדוח.
ad_id	AdId	מחרוזת	המזהה של המודעה שמשויכת לשורת הדוח.
ad_name	AdName	מחרוזת	השם של המודעה שמשויכת לשורה בדוח.
ACTION_COLLECTION.value	ActionValue	מספר שלם	ערך המדד של חלון השיוך שמוגדר כברירת מחדל.
ACTION_COLLECTION.1d_click	Action1dClick	מחרוזת	ערך המדד של חלון השיוך יום אחד אחרי הקליק על המודעה.
ACTION_COLLECTION.1d_view	Action1dView	מחרוזת	ערך המדד של חלון השיוך יום אחד אחרי הצפייה במודעה.
ACTION_COLLECTION.7d_click	Action7dClick	מחרוזת	ערך המדד של חלון השיוך 7 ימים אחרי הקליק על המודעה.
ACTION_COLLECTION.7d_view	Action7dView	מחרוזת	ערך המדד של חלון השיוך 7 ימים אחרי הצפייה במודעה.
ACTION_COLLECTION.28d_click	Action28dClick	מחרוזת	ערך המדד של חלון השיוך 28 ימים אחרי הקליק על המודעה.
ACTION_COLLECTION.28d_view	Action28dView	מחרוזת	ערך המדד של חלון השיוך 28 ימים אחרי הצפייה במודעה.
ACTION_COLLECTION.dda	ActionDDA	מחרוזת	ערך המדד של חלון השיוך שמבוסס על מודל מבוסס-נתונים.
פירוטים כלליים
	גיל	מחרוזת	טווח הגילאים של המדדים בשורה הזו.
	מגדר	מחרוזת	המגדר של המדדים בשורה הזו.
	מדינה	מחרוזת	המדינה שבה נמדדים המדדים בשורה הזו.
	אזור	מחרוזת	האזור שבו המשתמש צפה במודעה.
	FrequencyValue	מחרוזת	מספר הפעמים שבהן מודעה בקמפיין להגדלת היקף החשיפה ותדירות הצפייה הוצגה לכל אדם.
	HStatsByAdvertiserTZ	מחרוזת	תקופת הזמן שבה נאספו הנתונים הסטטיסטיים של המפרסם.
	HStatsByAudienceTZ	מחרוזת	תקופת הזמן שבה נאספו הנתונים הסטטיסטיים לגבי הקהל.
	ImpressionDevice	מחרוזת	המכשירים שבהם המודעה הוצגה.
	PlatformPosition	מחרוזת	המיקום בפלטפורמה.
	PublisherPlatform	מחרוזת	הפלטפורמות שבהן פורסמו המודעות.
	ProductId	מחרוזת	מזהה המוצר שפורסם במודעה.
פירוט הפעולות
	ActionType	מחרוזת	סוג הפעולות שבוצעו במודעה אחרי שהיא הוצגה למשתמש, גם אם הוא לא לחץ עליה.
	ActionCanvasComponentName	מחרוזת	השם של רכיב במודעת Canvas.
	ActionCarouselCardId	מחרוזת	המזהה של כרטיס הקרוסלה הספציפי שאנשים יצרו איתו אינטראקציה כשהם ראו את המודעה.
	ActionCarouselCardName	מחרוזת	הכרטיס הספציפי בקרוסלה שאנשים יצרו איתו אינטראקציה כשהם ראו את המודעה. אפשר לזהות את הכרטיסים לפי הכותרות שלהם.
	ActionDestination	מחרוזת	היעד שאליו מגיעים משתמשים אחרי שהם לוחצים על המודעה.
	ActionDevice	מחרוזת	המכשיר שבו התרחש אירוע ההמרה שאתם עוקבים אחריו.
	ActionReaction	מחרוזת	מספר התגובות על המודעות או על הפוסטים המקודמים.
	ActionTargetId	מחרוזת	מזהה היעד שאליו אנשים מגיעים אחרי שהם לוחצים על המודעה.
	ActionVideoSound	מחרוזת	סטטוס הצליל (מופעל או מושבת) כשמשתמש צופה במודעת הווידאו.
	ActionVideoType	מחרוזת	פירוט של מדדים שמתייחסים לסרטונים.
	ActionConvertedProductId	מחרוזת	מזהי מוצרים שעברו המרה – לשימוש במודעות שיתופיות.