MetaAds

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

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

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

• בפרויקט שלכם ב-Google Cloud:
  • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
  • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
  • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

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

  • מפעילים את השירותים הבאים:
    • ‫secretmanager.googleapis.com (Secret Manager API)
    • ‫connectors.googleapis.com (Connectors API)

    במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

הגדרת המחבר

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

1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

   כניסה לדף Connections

2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
3. בקטע מיקום, בוחרים את המיקום של החיבור.
   1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      אזורים נתמכים למחברים:

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

   2. לוחצים על הבא.
4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
   1. כלי חיבור: בוחרים באפשרות Meta Ads מהרשימה הנפתחת של כלי החיבור הזמינים.
   2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
   3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
   4. אפשר גם להזין תיאור למופע החיבור.
   5. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
   6. אופציונלי: מגדירים את ההגדרות של צומת החיבור:
      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   7. ‫Account Id: המזהה של חשבון הפרסום. אם לא צוין מזהה, אנחנו משתמשים במזהה הראשון של חשבון הפרסום שמוחזר מ-Facebook Ads.
   8. פורמט מצטבר: הפורמט שבו עמודות מצטברות או עמודות של אוספים צריכות להחזיר ערכים.
   9. ‫Authenticate As Page: השם או המזהה של דף לאימות כששולחים בקשות אל פייסבוק.
   10. רמת הניסיון החוזר: הרמה הכי מפורטת של אובייקט המודעה שבה מנהל התהליכים ינסה לאחזר תוצאות בניסיון חוזר.
   11. יעד: יעד ברירת מחדל אם לא צוין יעד. העמודה הזו משמשת בחלק מהטבלאות, כמו Comments (תגובות), שבהן יכול להיות שצוין יעד.
   12. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
   13. לוחצים על הבא.
5. בקטע אימות, מזינים את פרטי האימות.
   1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Meta Ads תומך בסוגי האימות הבאים:

      • הרשאת קוד אימות OAuth 2.0

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

   2. לוחצים על הבא.
6. בדיקה: בודקים את פרטי החיבור והאימות.
7. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

• הרשאת קוד אימות OAuth 2.0
  • אסימון גישה: אסימון הגישה שמשמש לאימות בקשות עם חיבורים שמבוססים על תהליך הרשאה עם קוד.
  • מזהה לקוח: מזהה הלקוח שסופק על ידי כלי החיבור לאפליקציה שיצרתם.
  • סוד הלקוח: סוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.

הגדרות אישיות ב-Meta Ads

כדי ליצור אפליקציה שמשולבת עם מודעות Meta, צריך לבצע את המשימות הבאות:

• הגדרה ויצירה של חשבון אפליקציה ב-Meta
• הגדרת אימות לקוח OAuth2.0
• הגדרת פרטי ההיקף
• הגדרת כתובת URL להפניה אוטומטית

הגדרה ויצירה של חשבון אפליקציה ב-Meta

1. עוברים אל Facebook Business Manager.
2. לוחצים על יצירת חשבון וממלאים את פרטי העסק כדי ליצור את החשבון.
3. בתהליך ההגדרה, מאמתים את הזהות ואת פרטי העסק.
4. אחרי שמגדירים את חשבון Business Manager, עוברים להגדרות העסק ולוחצים על דפים בתפריט.
5. לוחצים על הוספה ובוחרים באפשרות הוספת דף. פועלים לפי ההנחיות האחרות כדי להוסיף את הדף בפייסבוק לחשבון שלכם ב-Business Manager.
6. בתפריט של הגדרות העסק, לוחצים על הוספת חשבונות. לוחצים על הוספה ובוחרים באפשרות הוספת חשבון פרסום.

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

7. לוחצים על אמצעי תשלום בהגדרות העסק.
8. לוחצים על הוספה כדי להוסיף אמצעי תשלום כמו כרטיס אשראי או חשבון PayPal. מזינים את פרטי התשלום לפי ההנחיות האחרות.
9. לוחצים על הוספת אנשים ומזינים את כתובות האימייל של האנשים שרוצים להעניק להם גישה לחשבון ב-Business Manager. הקצאת תפקידים והרשאות מתאימים לכל אדם בהתאם לאחריות שלו.
10. עוברים אל המרכז לניהול מודעות, לוחצים על סמל התפריט ב-Business Manager ובוחרים באפשרות המרכז לניהול מודעות. לוחצים על יצירה כדי ליצור את הקמפיין הפרסומי.
11. פועלים לפי ההנחיות כדי להגדיר את יעד הקמפיין, קהל היעד, פורמט המודעה, התקציב ולוח הזמנים.
12. מעלים את המודעה שיצרתם, ובודקים את הפרטים לפני ששולחים את קמפיין הפרסום לבדיקה.
13. אחרי שהקמפיין יתחיל לפעול, תוכלו לעקוב אחריו ואחרי הביצועים שלו במרכז ניהול המודעות. כדאי לנתח מדדים מרכזיים כמו פוטנציאל חשיפה, מעורבות ושיעורי המרה. משנים את הקמפיינים לפי הצורך כדי לשפר את הביצועים ולהשיג את יעדי הפרסום.
14. נכנסים לחשבון האישי בפייסבוק או נרשמים ליצירת חשבון חדש אם אין לכם חשבון. מתחברים אל Facebook developer.
15. לוחצים על התפריט הנפתח האפליקציות שלי ובוחרים באפשרות יצירת אפליקציה.
16. בוחרים את הפלטפורמה של האפליקציה, למשל iOS, ‏ Android, אינטרנט וכו'.
17. מספקים מידע בסיסי על האפליקציה, כמו שם, כתובת אימייל וקטגוריה.
18. אחרי שמזינים את המידע הנדרש, לוחצים על יצירת מזהה אפליקציה כדי ליצור מזהה ייחודי לאפליקציה.
19. מגדירים הגדרות נוספות לאפליקציה, כמו הוספת פרטים ספציפיים לפלטפורמה שכוללים מזהה חבילה ל-iOS, שם חבילה ל-Android והגדרת דומיינים של אפליקציות וכתובות URL של מדיניות הפרטיות.
20. בוחרים את מוצרי פייסבוק שרוצים לשלב באפליקציה, כמו Facebook Login,‏ Analytics או Ads.
21. פועלים לפי ההוראות שמופיעות כדי להגדיר את סביבת הפיתוח ולשלב את ערכות ה-SDK של פייסבוק בקוד האפליקציה.
22. אחרי שמגדירים את האפליקציה, אפשר להתחיל לפתח ולבדוק את התכונות שלה באמצעות הכלים והמקורות למפתחים של פייסבוק.

מידע על יצירת אפליקציה זמין במאמר יצירת אפליקציה.

הגדרת פרטי אימות של לקוח OAuth2.0

1. עוברים אל Meta for developers באמצעות פרטי הכניסה שלכם ל-Facebook.
2. לוחצים על האפליקציות שלי, בוחרים בכרטיסייה 'אפליקציות' ואז בוחרים באפליקציית Meta שיצרתם קודם.
3. לוחצים על הגדרות האפליקציה > בסיסי.
4. מציגים את סוד האפליקציה, שהוא סוד הלקוח. לוחצים על הצגה, מזינים את הסיסמה לחשבון, מעתיקים אותה ושומרים אותה לשימוש בהמשך.
5. לוחצים על הגדרות האפליקציה > מתקדם. מחפשים את טוקן הלקוח, שהוא מזהה הלקוח. אם צריך, אפשר לאפס אותו.

הגדרת פרטי ההיקף

ההיקף של המחבר Meta Ads הוא ads_management.

הגדרת פרטים של כתובת URL להפניה אוטומטית

1. עוברים אל Meta for developers באמצעות פרטי הכניסה שלכם ל-Facebook.
2. לוחצים על הכרטיסייה אפליקציות ובוחרים את אפליקציית Meta שיצרתם קודם.
3. לוחצים על facebook כניסה > הגדרות.
4. מדביקים את כתובת ה-URL להפניה אוטומטית שנוצרה בקטע Valid OAuth Redirect URIs ומזינים את הפרטים בשדות החובה האחרים.

כשמגדירים את אפליקציית ה-OAuth של הצד השלישי, צריך להשתמש בכתובת ה-URI המורשית להפניה אוטומטית (כתובת ה-URL של הקריאה החוזרת):

https://console.cloud.google.com//connectors/oauth?project=PROJECT_ID

מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

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

דוגמאות להגדרת חיבור

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

סוג החיבור לאינטרנט ב-Meta Ads

שם השדה	פרטים
מיקום	us-central1
מחבר	facebookads
גרסת המחבר	1
שם החיבור	google-cloud-meta-ads-conn
חשבון השירות	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
מזהה לקוח	CLIENT_ID
היקפים	ads_management
סוד לקוח	CLIENT_SECRET
גרסה של סוד	2

ישויות, פעולות ופעולות

כל Integration Connectors מספקים שכבת הפשטה לאובייקטים של האפליקציה המחוברת. אפשר לגשת לאובייקטים של אפליקציה רק דרך ההפשטה הזו. ההפשטה מוצגת לכם כישויות, פעולות ופעילויות.

הערה: אפשר לראות את הישויות, הפעולות והפעולות של מחבר במשימת המחברים.

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

  עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

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

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

• פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

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

מגבלות המערכת

מחבר MetaAds יכול לעבד 6 טרנזקציות בשנייה, לכל צומת, ומגביל את מספר הטרנזקציות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

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

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

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

פעולות

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

הערה: התוצאות של כל הפעולות יהיו זמינות כתשובת JSON בפרמטר התשובה connectorOutputPayload של המשימה Connectors אחרי שתפעילו את השילוב.

פעולת CreateAdPreview

יוצר קובץ סכימה לתובנות לגבי אפליקציה.

פרמטרים של קלט לפעולה CreateAdPreview

שם הפרמטר	סוג הנתונים	חובה	תיאור
AdFormat	String	True	פורמט המודעה לשימוש.הערכים האפשריים הם: AUDIENCE_NETWORK_INSTREAM_VIDEO, ‏ AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE, ‏ AUDIENCE_NETWORK_OUTSTREAM_VIDEO, ‏ AUDIENCE_NETWORK_REWARDED_VIDEO, ‏ DESKTOP_FEED_STANDARD, ‏ FACEBOOK_STORY_MOBILE, ‏ INSTAGRAM_STANDARD, ‏ INSTAGRAM_STORY, ‏ INSTANT_ARTICLE_STANDARD, ‏ INSTREAM_VIDEO_DESKTOP, ‏ INSTREAM_VIDEO_MOBILE, ‏ MARKETPLACE_MOBILE, ‏ MESSENGER_MOBILE_INBOX_MEDIA, ‏ MOBILE_BANNER, ‏ MOBILE_FEED_BASIC, ‏ MOBILE_FEED_STANDARD, ‏ MOBILE_FULLWIDTH, ‏ MOBILE_INTERSTITIAL, ‏ MOBILE_MEDIUM_RECTANGLE, ‏ MOBILE_NATIVE, ‏ RIGHT_COLUMN_STANDARD, ‏ SUGGESTED_VIDEO_DESKTOP, ‏ SUGGESTED_VIDEO_MOBILE, ‏ WATCH_FEED_MOBILE.
AdCreativeId	String	True	מזהה של נכס קריאייטיב של מודעה שמשמש ליצירת התצוגה המקדימה.

דוגמאות להגדרת הפעולה CreateAdPreview מופיעות במאמר דוגמאות לפעולות.

דוגמאות לפעולות

בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.

דוגמה – יצירת תצוגה מקדימה של מודעה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה CreateAdPreview ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

   {
   "AdCreativeId": "120208552947120478",
   "AdFormat": "AUDIENCE_NETWORK_INSTREAM_VIDEO"
   }

אם הפעולה מצליחה, לפרמטר התגובה CreateAdPreview של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
  "Url": "https://business.facebook.com/ads/api/preview_iframe.php?d=AQL_quk8kLm_6z2oZ14q9A0led9llzr981NPv-zUHhwZ5IXjO07s7ngrI2y0qI0VZCRH2w9hgCwy5xrbFQlWCy0g-uRpRHvFS0dS0erj2Lg4HI7ZfIRm8h3nZLhJygM",
  "@affectedrows": null
}, {
  "Url": null,
  "@affectedrows": null
}]

דוגמאות לפעולות על ישויות

בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.

דוגמה – רשימה של כל החשבונות ב-Google Ads

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות AdAccounts מהרשימה Entity.
3. בוחרים את הפעולה List ולוחצים על סיום.

דוגמה – הצגת רשימה של כל הקמפיינים

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Campaigns מהרשימה Entity.
3. בוחרים את הפעולה List ולוחצים על סיום.
4. אופציונלי: בקטע Task Input במשימה Connectors, אפשר לסנן את קבוצת התוצאות על ידי ציון filter clause. תמיד מציינים את הערך של סעיף המסנן בתוך גרשיים בודדים (').

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Adsets מהרשימה Entity.
3. בוחרים את הפעולה Get ולוחצים על סיום.
4. בקטע Task Input (קלט של המשימה) במשימה Connectors (מחברים), לוחצים על EntityId (מזהה הישות) ואז מזינים 120206747969710053 בשדה Default Value (ערך ברירת המחדל).

   כאן, 120206747969710053 הוא מזהה רשומה ייחודי בישות User.

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

שימוש בחיבור MetaAds בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור באינטגרציה באמצעות המשימה Connectors.

• כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
• מידע על יצירה ושימוש במשימת Connectors ב-Application Integration זמין במאמר משימת Connectors.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

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

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