טעינת נתוני מודעות של פייסבוק ל-BigQuery

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

סקירה כללית של מחברים

שירות העברת הנתונים ל-BigQuery עבור המחבר של Facebook Ads תומך באפשרויות הבאות להעברת נתונים.

אפשרויות להעברת נתונים	תמיכה
דוחות נתמכים	שירות העברת הנתונים ל-BigQuery עבור Facebook Ads תומך בהעברה של הדוחות הבאים של Facebook Ads: AdAccounts AdInsights AdInsightsActions מידע על האופן שבו דוחות של Facebook Ads מומרים לטבלאות ולתצוגות ב-BigQuery זמין במאמר המרת דוחות של Facebook Ads.
תדירות החזרה	מחבר הנתונים של Facebook Ads תומך בהעברות נתונים יומיות. כברירת מחדל, העברות נתונים מתוזמנות לזמן שבו נוצרת העברת הנתונים. אפשר להגדיר את השעה של העברת הנתונים כשמגדירים את העברת הנתונים.
רענון החלון	מחבר Facebook Ads מאחזר נתוני מודעות מ-Facebook Ads מפרק זמן של עד 30 ימים בזמן הפעלת העברת הנתונים. אי אפשר להגדיר את חלון הרענון למחבר הזה. מידע נוסף זמין במאמר בנושא חלונות רענון.
זמינות של נתונים להשלמת חוסר (data backfill)	מריצים השלמת חוסר בנתונים כדי לאחזר נתונים שלא נכללים בהעברת הנתונים המתוזמנת. אפשר לאחזר נתונים עד לתקופה שמוגדרת במדיניות שמירת הנתונים במקור הנתונים.

מגבלות

העברות נתוני מודעות מ-Facebook Ads כפופות למגבלות הבאות:

• מרווח הזמן המינימלי בין העברות נתונים חוזרות מ-Facebook Ads הוא 24 שעות. כברירת מחדל, ההעברה של נתונים חוזרת מתבצעת כל 24 שעות.
• שירות העברת הנתונים ל-BigQuery עבור Facebook Ads תומך רק בקבוצה קבועה של טבלאות. אין תמיכה בדוחות בהתאמה אישית.
• ההעברות של נתוני מודעות מ-Facebook Ads נמשכות עד שש שעות. ההעברה תיכשל אם היא תימשך יותר מהמשך המקסימלי הזה.
• אין תמיכה בהעברות מצטברות של טבלאות AdInsights ו-AdInsightsActions. כשיוצרים העברת נתונים שכוללת את הטבלאות AdInsights ו-AdInsightsActions, ומציינים תאריך באפשרויות התזמון, כל הנתונים שזמינים לתאריך הזה מועברים.
• שירות העברת הנתונים ל-BigQuery תומך בחלון רענון של עד 30 ימים לטבלאות AdInsights ו-AdInsightsActions. חלון הרענון מתייחס למספר הימים שבהם העברת הנתונים תאחזר נתוני מקור. כשמריצים העברת נתונים בפעם הראשונה, העברת הנתונים מאחזרת את כל נתוני המקור שזמינים בחלון הרענון.

• התוקף של טוקן הגישה של המשתמש לטווח ארוך שנדרש להעברות של Facebook Ads יפוג אחרי 60 יום.

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

• כדי להשתמש בצירוף רשת בהעברת הנתונים הזו, צריך קודם ליצור צירוף רשת על ידי הגדרת כתובת IP סטטית.

• אם המכונה הווירטואלית (VM) והרשת המצורפת שהגדרתם נמצאות באזורים שונים, יכול להיות שתהיה תנועה של נתונים בין אזורים כשמעבירים נתונים מ-Facebook Ads.

הטמעת נתונים מ-Facebook Ads

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

בטבלאות AdInsights ו-AdInsightsActions, מחיצת הטבלה שאליה נטען המידע תואמת לתאריך ממקור הנתונים.

בטבלאות AdAccounts, מתבצעת יצירת תמונת מצב פעם ביום, והיא מאוחסנת במחיצה של התאריך האחרון של הרצת ההעברה. חלון הרענון לא חל על הטבלה AdAccounts.

רענון חלונות

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

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

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

לפני שמתחילים

בקטעים הבאים מפורטים השלבים שצריך לבצע לפני שיוצרים העברת נתוני מודעות מ-Facebook Ads.

דרישות מוקדמות לשימוש במודעות ב-Facebook

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

פרמטרים של מודעות ב-Facebook	תיאור
clientID	השם של מזהה האפליקציה של לקוח OAuth 2.0.
clientSecret	הסוד של האפליקציה עבור לקוח OAuth 2.0.
refreshToken	טוקן גישה למשתמש לטווח ארוך, שנקרא גם טוקן רענון.

כדי לקבל clientID ו-clientSecret, מבצעים את הפעולות הבאות:

1. יוצרים אפליקציה למפתחים בפייסבוק עם סוג האפליקציה Business.
2. בלוח הבקרה של אפליקציית פייסבוק, לוחצים על App Settings (הגדרות האפליקציה) > Basic (בסיסי) ומחפשים את מזהה האפליקציה ואת סוד האפליקציה שמתאימים לאפליקציה.

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

1. במסוף Google Cloud , ממשיכים בשלבים ליצירת העברה של נתונים מ-Facebook Ads.

2. בקטע פרטי מקור הנתונים, מעתיקים את ה-URI של ההפניה האוטומטית שמופיע אחרי השדה Refresh Token.

3. לוחצים על לוח הבקרה של אפליקציית פייסבוק ואז על הגדרה בקטע התחברות לפייסבוק לעסקים.

   

4. בדף הגדרות, מזינים את כתובת ה-URL להפניה אוטומטית בשדה כתובות URL תקינות להפניה אוטומטית של OAuth ולוחצים על שמירה.

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

   

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

7. בסיום, לוחצים על הבנתי כדי לחזור אל Google Cloud המסוף. טוקן הגישה של המשתמש לטווח ארוך מאוכלס עכשיו בהגדרת ההעברה.

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

חלופות לטוקן רענון

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

• איך יוצרים אסימון גישה למשתמש לטווח ארוך באמצעות Graph API כדי שהאסימון יהיה תקף להעברת הנתונים, צריך להעניק את ההרשאות ads_management, ‏ ads_read ו-business_management.
• יצירת טוקן של משתמש מערכת. אסימון של משתמש מערכת מאפשר להוסיף באופן ידני נכסים, כמו חשבונות פרסום, שייכללו בהעברת הנתונים. אם התוקף של אסימון משתמש במערכת פג, צריך לעדכן ידנית את הגדרות ההעברה עם פרטי כניסה חדשים. יש לכם גם אפשרות ליצור טוקן שלא יפוג כשאתם יוצרים טוקן של משתמש מערכת. מידע נוסף זמין במאמר בנושא אסימוני גישה נתמכים.

דרישות מוקדמות ל-BigQuery

• מוודאים שביצעתם את כל הפעולות שנדרשות כדי להפעיל את שירות העברת נתונים ל-BigQuery.
• יוצרים מערך נתונים ב-BigQuery לאחסון הנתונים.
• אם אתם מתכוונים להגדיר התראות על הפעלת העברה ב-Pub/Sub, ודאו שיש לכם הרשאה לניהול זהויות והרשאות גישה (IAM) pubsub.topics.setIamPolicy. אם מגדירים רק התראות באימייל, לא נדרשות הרשאות Pub/Sub. מידע נוסף זמין במאמר בנושא התראות על הפעלת שירות העברת נתונים ל-BigQuery.

התפקידים הנדרשים ב-BigQuery

כדי לקבל את ההרשאות שנדרשות ליצירת העברת נתונים באמצעות שירות העברת נתונים ל-BigQuery, צריך לבקש מהאדמין להקצות לכם את תפקיד BigQuery Admin ‏ (roles/bigquery.admin) ב-IAM בפרויקט. להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאות שנדרשות ליצירת העברת נתונים בשירות העברת נתונים ל-BigQuery. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי ליצור העברת נתונים באמצעות שירות העברת הנתונים ל-BigQuery, נדרשות ההרשאות הבאות:

• הרשאות של שירות העברת נתונים ל-BigQuery:
  • bigquery.transfers.update
  • bigquery.transfers.get
• הרשאות ב-BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.datasets.update
  • bigquery.datasets.setIamPolicy
  • bigquery.jobs.create

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

מידע נוסף מופיע במאמר בנושא מתן גישה ל-bigquery.admin.

יצירת העברת נתוני מודעות מ-Facebook Ads

בוחרים באחת מהאפשרויות הבאות:

המסוף

1. עוברים לדף 'העברות נתונים' במסוף Google Cloud .

   מעבר אל "העברות נתונים"

2. לוחצים על Create transfer (יצירת העברה).

3. בקטע סוג מקור, באפשרות מקור, בוחרים באפשרות מודעות פייסבוק.

4. בקטע Data source details (פרטים של מקור הנתונים):

   • בקטע Network attachment (חיבור לרשת), בוחרים חיבור לרשת מהתפריט. כדי להשתמש בצירוף רשת בהעברת הנתונים הזו, צריך ליצור צירוף רשת על ידי הגדרת כתובת IP סטטית.
   • בשדה מזהה לקוח, מזינים את מזהה האפליקציה.
   • בקטע Client secret (סוד לקוח), מזינים את סוד האפליקציה.
   • בקטע טוקן רענון, מזינים את מזהה טוקן הגישה של המשתמש לטווח ארוך. כדי לעשות זאת, לוחצים על הרשאה. לחלופין, אם כבר יש לכם אסימון רענון או אסימון של משתמש מערכת, אתם יכולים להזין את אסימון הרענון ישירות בשדה הזה. מידע על אחזור אסימון גישה למשתמש עם משך חיים ארוך זמין במאמר דרישות מוקדמות לשימוש ב-Facebook Ads.
   • כדי להעביר אובייקטים של Facebook Ads: מציינים דוחות או אובייקטים של Facebook Ads שרוצים לכלול בהעברה הזו.
   • בוחרים באפשרות שליפת נתונים רק מחשבונות פרסום מורשים כדי לשלוף נתונים רק מחשבונות פרסום שהורשו לאפליקציית פייסבוק שלכם. אפשר למצוא את חשבונות הפרסום המורשים בקטע חשבונות פרסום שבהגדרות האפליקציה > מתקדם.
   • בקטע ActionsCollections, מציינים אוסף פעולות אחד או יותר.
   • בקטע פירוטים כלליים, בוחרים את הפירוטים הכלליים של נתוני התובנות. הפירוטים האלה קובעים את הסדר שבו הנתונים המועברים מוצגים בטבלאות AdInsights וAdInsightsActions. ב-Facebook Ads מותר להשתמש רק בשילובים מסוימים של פילוחים. מידע נוסף על שילובי פירוט מותרים זמין במאמר שילוב של פירוטים
   • בקטע פירוט הפעולות, בוחרים את פירוט הפעולות של נתוני התובנות. הפירוטים האלה קובעים את הסדר שבו הנתונים המועברים מוצגים בטבלה AdInsightsActions. מידע על שילוב של פירוטים מופיע במאמר שילוב של פירוטים.
   • בקטע חלון רענון, מציינים את משך חלון הרענון.

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

6. בקטע Transfer config name, בשדה Display name, מזינים שם להעברת הנתונים.

7. בקטע Schedule options:

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

8. אופציונלי: בקטע אפשרויות התראות, מבצעים את הפעולות הבאות:

   • כדי להפעיל התראות באימייל, לוחצים על המתג התראות באימייל. כשמפעילים את האפשרות הזו, האדמין של ההעברה מקבל התראה באימייל אם ההעברה נכשלת.
   • כדי להפעיל התראות על הרצת העברה ב-Pub/Sub להעברת הנתונים הזו, לוחצים על המתג התראות Pub/Sub. אפשר לבחור את שם הנושא או ללחוץ על יצירת נושא כדי ליצור נושא.

9. לוחצים על Save.

כשמריצים את העברת הנתונים הזו, שירות העברת הנתונים ל-BigQuery מאכלס אוטומטית את הטבלאות הבאות.

שם טבלה	תיאור
AdAccounts	חשבונות הפרסום שזמינים למשתמש.
AdInsights	דוח תובנות לגבי מודעות לכל חשבונות הפרסום.
AdInsightsActions	דוח פעולות התובנות לגבי מודעות זמין לכל החשבונות הפרסומיים.

BQ

מזינים את הפקודה bq mk ומספקים את דגל יצירת ההעברה --transfer_config:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=DISPLAY_NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

כאשר:

• ‫PROJECT_ID (אופציונלי): מזהה הפרויקט ב- Google Cloud . אם לא מציינים את --project_id כדי לציין פרויקט מסוים, המערכת משתמשת בפרויקט ברירת המחדל.
• ‫DATA_SOURCE: מקור הנתונים (לדוגמה, facebook-ads).
• ‫DISPLAY_NAME: השם המוצג של הגדרת העברת הנתונים. שם ההעברה יכול להיות כל ערך שיעזור לכם לזהות את ההעברה אם תצטרכו לשנות אותה בהמשך.
• ‫DATASET: מערך הנתונים של היעד להגדרת העברת הנתונים.
• ‫PARAMETERS: הפרמטרים של הגדרת העברת הנתונים שנוצרה בפורמט JSON. לדוגמה: --params='{"param":"param_value"}'. אלה הפרמטרים להעברה של מודעות Facebook:
  • ‫connector.authentication.oauth.clientId: השם של מזהה האפליקציה של לקוח OAuth 2.0.
  • ‫connector.authentication.oauth.clientSecret: הסוד של האפליקציה עבור לקוח OAuth 2.0.
  • ‫connector.authentication.oauth.refreshToken: המזהה של האסימון לטווח ארוך.
  • ‫connector.authorizedAdAccountsOnly: אם הערך מוגדר כ-true, המחבר מאחזר נתונים רק מחשבונות פרסום שיש להם הרשאה לאפליקציית פייסבוק שלכם. אפשר למצוא את חשבונות הפרסום המורשים בקטע Advanced accounts (חשבונות מתקדמים) שבהגדרות האפליקציה (App Settings) > Advanced (מתקדם).
  • ‫connector.actionCollections: אוספי פעולות הם אובייקטים שמציינים את הסוגים השונים של פעולות שאנשים ביצעו בתגובה למודעה שלכם. רשימה מלאה של הערכים של actionCollections מופיעה במאמר בנושא אוספי פעולות.
    • מידע נוסף זמין במאמר תובנות לגבי מודעות.
  • ‫connector.genericBreakdowns: ציון הפירוטים הכלליים של נתוני התובנות הפירוטים האלה קובעים את הסדר שבו הנתונים המועברים מוצגים בטבלאות AdInsights וAdInsightsActions. ב-Facebook Ads מותר להשתמש רק בשילובים מסוימים של פילוחים. מידע נוסף על שילובי פירוט מותרים מופיע במאמר שילוב של פירוטים.
  • ‫actionBreakdowns: מציינים את פירוטי הפעולות של נתוני התובנות. הפירוטים האלה קובעים את הסדר שבו הנתונים המועברים מוצגים בטבלאות AdInsights וAdInsightsActions. מידע על שילוב של פירוטים מופיע במאמר שילוב של פירוטים.

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

bq mk
--transfer_config
--target_dataset=mydataset
--data_source=facebook_ads
--display_name='My Transfer'
--params='{"connector.authentication.oauth.clientId": "1650000000",
    "connector.authentication.oauth.clientSecret":"TBA99550",
    "connector.authentication.oauth.refreshToken":"abcdef",
    "connector.authorizedAdAccountsOnly":true,
    "connector.actionCollections":["Actions", "Conversions"],
    "connector.genericBreakdowns":["PublisherPlatform", "PlatformPosition"],
    "connector.actionBreakdowns":["ActionDevice", "ActionType"]}'

API

משתמשים בשיטה projects.locations.transferConfigs.create ומספקים מופע של המשאב TransferConfig.

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

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

מידע על המיפוי של הנתונים המועברים לשדות ב-Meta API זמין במאמר שינוי של דוחות Facebook Ads.

אוספים של פעולות

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

אוספי פעולות מייצגים את השדות של list<AdsActionStats> type שנמצאים בתשובה של Ad Account, Insights endpoint.

בסיום ההעברה, אוספי הפעולות האלה יאוכלסו בטבלה AdInsightsActions.

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

בהמשך מופיעה רשימה של אוספי פעולות שנתמכים בהעברת נתונים מ-Facebook Ads:

• ActionValues
• Actions
• AdClickActions
• AdImpressionActions
• CatalogSegmentActions
• CatalogSegmentValue
• CatalogSegmentValueMobilePurchaseRoas
• CatalogSegmentValueOmniPurchaseRoas
• CatalogSegmentValueWebsitePurchaseRoas
• ConversionValues
• Conversions
• ConvertedProductQuantity
• ConvertedProductValue
• CostPer15_secVideoView
• CostPer2SecContinuousVideoView
• CostPerActionType
• CostPerAdClick
• CostPerConversion
• CostPerOneThousandAdImpression
• CostPerOutboundClick
• CostPerThruplay
• CostPerUniqueActionType
• CostPerUniqueConversion
• CostPerUniqueOutboundClick
• InteractiveComponentTap
• MobileAppPurchaseRoas
• OutboundClicks
• OutboundClicksCtr
• PurchaseRoas
• UniqueActions
• UniqueConversions
• UniqueOutboundClicks
• UniqueOutboundClicksCtr
• UniqueVideoView15_sec
• Video15_secWatchedActions
• Video30_secWatchedActions
• VideoAvgTimeWatchedActions
• VideoContinuous2SecWatchedActions
• VideoP100_watchedActions
• VideoP25WatchedActions
• VideoP50WatchedActions
• VideoP75WatchedActions
• VideoP95WatchedActions
• VideoPlayActions
• VideoPlayCurveActions
• VideoPlayRetentionGraphActions
• VideoTimeWatchedActions
• WebsiteCtr
• WebsitePurchaseRoas

שילוב של פירוטים

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

מידע נוסף על שילוב של פילוחים זמין במאמר שילוב של פילוחים.

פתרון בעיות בהגדרת ההעברה

אם נתקלתם בבעיות בהגדרת העברת נתונים מ-Facebook Ads, נסו את השלבים הבאים לפתרון בעיות:

• בודקים אם תוקף אסימון הגישה של המשתמש פג באמצעות כלי הניפוי באגים של אסימון הגישה של פייסבוק. התוקף של אסימוני גישה למשתמשים לטווח ארוך יפוג אחרי 60 יום. אם תוקף האסימון שלכם לגישת משתמש לטווח ארוך פג, צריך לעבור לפרטי ההעברה וללחוץ על עריכה כדי לשנות את הגדרות ההעברה. בדף העריכה של ההעברה, פועלים לפי אותם השלבים שמפורטים במאמר דרישות מוקדמות לשימוש ב-Facebook Ads כדי ליצור חדש.

• מוודאים שטוקן הגישה של המשתמש לטווח ארוך נוצר עם ההרשאות הנדרשות – ads_management, ads_read ו-business_management. כדי לבדוק את ההרשאות של טוקן הגישה של המשתמש לטווח ארוך, מזינים את הקישור הבא בדפדפן:

  https://graph.facebook.com/me/permissions?access_token=TOKEN
  

  כאשר TOKEN הוא הערך של טוקן הגישה של המשתמש לטווח ארוך.

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

• בכרטיסייה Required Actions במרכז הבקרה של האפליקציה של פייסבוק אפשר לבדוק אם יש פריטים שנדרשת התייחסות אליהם.

יכול להיות שיופיעו הודעות השגיאה הבאות שקשורות לשגיאות של הגבלת קצב של יצירת בקשות ב-Meta API:

שגיאה: There have been too many calls from this ad-account. Wait a bit and try again.

פתרון: בודקים שאין תהליכי עבודה מקבילים שמשתמשים באותן אפליקציות או באותם פרטי כניסה. אם השגיאות האלה נמשכות, כדאי לשדרג את ההרשאות לגישה מתקדמת כדי לקבל מכסת הגבלת קצב של יצירת בקשות גדולה יותר. מידע נוסף מופיע במאמר בנושא הגבלת קצב הבקשות ב-Marketing API.

הודעות נפוצות של מדדי מעקב

אפשר גם לבדוק את מדדי המעקב של שירות העברת הנתונים ל-BigQuery כדי לזהות את הסיבה לכשל בהעברת הנתונים. בטבלה הבאה מפורטות כמה הודעות נפוצות של ERROR_CODE לגבי העברות נתוני מודעות של פייסבוק.

שגיאה	תיאור
INVALID_ARGUMENT	ההגדרה שסופקה לא חוקית. יכול להיות שתיתקלו בשגיאה הזו גם עם ההודעה This combination of action and generic breakdowns is not allowed. למידע על שילובים תקינים של פירוטים, אפשר לעיין במאמר בנושא שילוב של פירוטים.
PERMISSION_DENIED	פרטי הכניסה לא תקינים
UNAUTHENTICATED	נדרש אימות
SERVICE_UNAVAILABLE	השירות לא יכול לטפל בהעברת הנתונים הזו באופן זמני
DEADLINE_EXCEEDED	העברת הנתונים לא הסתיימה תוך שש שעות, שהוא משך הזמן המקסימלי
NOT_FOUND	משאב מבוקש לא נמצא
INTERNAL	משהו אחר גרם לכשל במחבר
FAILED_PRECONDITION	השגיאה הזו יכולה להופיע עם ההודעה There was an issue connecting to Facebook Ads API. השגיאה הזו יכולה להתרחש כשמצרפים קובץ מהרשת להעברה אבל לא מגדירים נכון את תרגום כתובות הרשת (NAT) הציבוריות. כדי לפתור את השגיאה, צריך לבצע את השלבים ליצירת קובץ מצורף לרשת על ידי הגדרת כתובת IP סטטית.
RESOURCE_EXHAUSTED	מכסה או מגבלה של מקור נתונים מוצו

תמחור

מידע על תמחור של העברות נתונים מ-Facebook Ads זמין במאמר בנושא תמחור של שירות העברת נתונים.

המאמרים הבאים

• מידע נוסף על שירות העברת נתונים ל-BigQuery
• מידע נוסף על עבודה עם העברות, כולל צפייה בהגדרות ובהיסטוריית ההפעלה
• איך טוענים נתונים באמצעות פעולות בין עננים