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

טעינת נתוני מודעות מ-Google Ads ל-BigQuery

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

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

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

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

אפשרויות להעברת נתונים	תמיכה
דוחות נתמכים	מחבר Google Ads תומך בהעברת נתונים מהדוחות ב-Google Ads API גרסה 23. במאמר שינוי דוחות של Google Ads מוסבר איך דוחות של Google Ads משתנים לטבלאות ולתצוגות ב-BigQuery.
תדירות החזרה	מחבר Google Ads תומך בהעברות נתונים יומיות. כברירת מחדל, העברות נתונים מתוזמנות בזמן שבו נוצרת העברת הנתונים. ניתן להגדיר את זמן העברת הנתונים בעת הגדרת העברת הנתונים שלך.
רענון החלון	אתם יכולים לתזמן את העברות הנתונים כדי לאחזר נתוני מודעות מ-Google Ads מפרק זמן של עד 30 יום בזמן הפעלת העברת הנתונים. אתם יכולים להגדיר את משך חלון הרענון כשאתם מגדירים את העברת הנתונים. כברירת מחדל, חלון הרענון של כלי החיבור ל-Google Ads הוא 7 ימים. מידע נוסף זמין במאמר בנושא חלונות של רענון. תמונות מצב של טבלאות התאמה נוצרות פעם ביום ונשמרות בקטגוריה לפי התאריך של ההרצה האחרונה. תמונות מצב של טבלאות התאמה לא מתעדכנות לגבי מילוי חוסרים או לגבי ימים שנטענו באמצעות חלון הרענון.
זמינות של נתונים להשלמת חוסר (data backfill)	הפעל מילוי נתונים מחדש כדי לאחזר נתונים מחוץ להעברת הנתונים המתוזמנת שלך. באפשרותך לאחזר נתונים עד לתאריך היעד המותר על פי מדיניות שמירת הנתונים במקור הנתונים שלך. מידע על מדיניות שמירת הנתונים של Google Ads זמין במאמר מדיניות Google Ads בנושא שמירת נתונים.
מספר הלקוחות לכל חשבון ניהול	8,000 שירות העברת הנתונים ל-BigQuery תומך במקסימום 8,000 מספרי לקוחות לכל חשבון ניהול (MCC) ב-Google Ads.

כדי למפות דוחות Google Ads למה שאתם רואים בממשק המשתמש של Google Ads, ראו מיפוי דוחות לממשק המשתמש של Google Ads.

קליטת נתונים מהעברות של גוגל אדס

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

רענון החלונות

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

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

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

מגבלות

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

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

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

מוודאים שביצעתם את כל הפעולות שנדרשות כדי להפעיל את שירות העברת נתונים ל-BigQuery.
יוצרים מערך נתונים בשירות העברת הנתונים ל-BigQuery כדי לאחסן את נתוני המודעות של Google Ads.
אם אתם מתכוונים להגדיר התראות על הפעלת העברה ב-Pub/Sub, ודאו שיש לכם את ההרשאה 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.

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

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

כדי לתת הרשאה לחשבון שירות להעביר את נתוני המודעות שלכם ב-Google Ads, מומלץ להעניק לחשבון השירות גישה ישירה לחשבון Google Ads. למידע נוסף, ראו הרשאה עם גישה ישירה לחשבון. לא נדרשות הגדרות של אימות רב-שלבי (MFA), כמו אימות דו-שלבי, להגדרות העברה שמורשות באמצעות חשבונות שירות.

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

כדי ליצור העברת נתונים לדיווח ב-Google Ads, צריך לציין את מספר הלקוח ב-Google Ads או את חשבון הניהול (MCC). מידע על אחזור מספר הלקוח ב-Google Ads זמין במאמר איפה נמצא מספר הלקוח ב-Google Ads?

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

המסוף

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

מעבר אל 'העברות נתונים'
לוחצים על Create transfer (יצירת העברה).
בקטע Source type (סוג המקור), בוחרים באפשרות Google Ads בשדה Source (מקור).
בקטע פרטי מקור הנתונים:
1. בשדה מספר לקוח, מזינים את מספר הלקוח ב-Google Ads.
2. בקטע סוג הדוח, בוחרים באפשרות רגיל או בהתאמה אישית.
  - אם בחרתם באפשרות רגיל, ההעברה כוללת את קבוצת הדוחות והשדות הרגילה, כפי שמפורט במאמר שינוי פורמט הדוחות של Google Ads.
    - אופציונלי: בוחרים באפשרויות להחרגת פריטים שהוסרו או שהושבתו ולכלול טבלאות חדשות ב-Google Ads.
    - אופציונלי: מזינים רשימה של טבלאות שרוצים לכלול, מופרדת בפסיקים. לדוגמה, Campaign, AdGroup. כדי להחריג טבלאות מסוימות, מוסיפים את התו - לפני הרשימה, למשל -Campaign, AdGroup. כל הטבלאות כלולות כברירת מחדל.
    - אופציונלי: בוחרים באפשרות לכלול טבלאות שספציפיות לדוחות של קמפיינים למיקסום הביצועים. מידע נוסף על התמיכה בקמפיינים למיקסום הביצועים זמין במאמר תמיכה בקמפיינים למיקסום הביצועים.
    - אופציונלי: בשדה חלון רענון, מזינים ערך בין 1 ל-30.
  - אם בחרתם באפשרות בהתאמה אישית, צריך להזין טבלת פלט ושאילתה ב-Google Ads לכל דוח בהתאמה אישית שרוצים לכלול בהעברה הזו.
    - אופציונלי: לוחצים על הוספת שאילתה כדי להוסיף דוח חדש בהתאמה אישית.
    - אופציונלי: בשדה חלון רענון, מזינים ערך בין 1 ל-30.
בקטע הגדרות יעד, בשדה מערך נתונים, בוחרים את מערך הנתונים שיצרתם לאחסון הנתונים.
בקטע שם הגדרת ההעברה, בשדה שם מוצג, מזינים שם להעברת הנתונים, כמו My Transfer. שם ההעברה יכול להיות כל ערך שיאפשר לכם לזהות את ההעברה אם תצטרכו לשנות אותה בהמשך.
בקטע אפשרויות תזמון:
- עבור תדירות חזרה, בחר אפשרות לתדירות ביצוע העברת הנתונים. אם תבחרו באפשרות ימים, ציינו שעה חוקית לפי UTC.
  - שעות
  - ימים
  - על פי דרישה
- אם רלוונטי, בוחרים באפשרות התחלה מיידית או התחלה בשעה שנקבעה, ומזינים תאריך התחלה ומשך הפעלה.
ב-חשבון שירות תפריט, בחר אחשבון שירות מחשבונות השירות המשויכים שלך Google Cloud פּרוֹיֶקט. אתם יכולים לשייך חשבון שירות להעברת הנתונים במקום להשתמש בפרטי הכניסה של המשתמש. מידע נוסף על שימוש בחשבונות שירות עם העברות נתונים זמין במאמר שימוש בחשבונות שירות.
- אם נכנסתם באמצעות זהות מאוחדת, תצטרכו ליצור חשבון שירות כדי ליצור העברה. אם נכנסתם באמצעות חשבון Google, חשבון שירות להעברה הוא אופציונלי.
- לחשבון השירות צריכות להיות ההרשאות הנדרשות.
אופציונלי: בקטע אפשרויות התראות:
- לוחצים על המתג כדי להפעיל את ההתראות באימייל. כאשר תפעיל אפשרות זו, מנהל ההעברה יקבל הודעת דוא"ל אם הפעלת העברה נכשלת.
- לוחצים על המתג כדי להפעיל התראות Pub/Sub. עבור בחר נושא Cloud Pub/Sub, בחר את שם הנושא שלך או לחץ על צור נושא. אפשרות זו מגדירה התראות של הפעלת Pub/Sub עבור ההעברה שלך.
לוחצים על Save.

BQ

הזן את הפקודה bq mk וציין את דגל יצירת ההעברה — --transfer_config. גם הדגלים הבאים נדרשים:

--data_source
--target_dataset
--display_name
--params

הדגלים הבאים הם אופציונליים:

‫--project_id: מציין באיזה פרויקט להשתמש. אם לא מציינים את הדגל, נעשה שימוש בפרויקט שמוגדר כברירת מחדל.
--table_filter: מציין אילו טבלאות לכלול בהעברת הנתונים. אם לא מציינים את הדגל, כל הטבלאות נכללות. כדי לכלול רק טבלאות ספציפיות, משתמשים ברשימת ערכים מופרדים בפסיקים (לדוגמה, Ad, Campaign, AdGroup). כדי להחריג טבלאות ספציפיות, מוסיפים מקף (-) לפני הערכים (לדוגמה, -Ad, Campaign, AdGroup).
--schedule: מציין באיזו תדירות השאילתה פועלת. אם לא מציינים את --schedule, ברירת המחדל היא every 24 hours. למידע על תחביר לוח הזמנים, ראה עיצוב לוח הזמנים.
--refresh_window_days: מציין את חלון הרענון עבור תצורת העברה בימים. ערך ברירת המחדל הוא 7.
‫--service_account_name: מציין חשבון שירות שישמש לאימות ההעברה של Google Ads במקום חשבון המשתמש.
‫--include_pmax: מציינים true כדי לכלול טבלאות שספציפיות לדוחות של קמפיינים למיקסום הביצועים. ערך ברירת המחדל הוא false. מידע נוסף על התמיכה בקמפיינים למיקסום הביצועים זמין במאמר תמיכה בקמפיינים למיקסום הביצועים

bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--params='PARAMETERS' \
--data_source=DATA_SOURCE \
--table_filter=TABLES \
--schedule=SCHEDULE \
--refresh_window_days=REFRESH_DAYS \
--service_account_name=SERVICE_ACCOUNT_NAME \
--include_pmax=PMAX_ENABLE

כאשר:

‫PROJECT_ID הוא מזהה הפרויקט.
‫DATASET הוא מערך הנתונים של היעד להגדרת העברת הנתונים.
‫NAME הוא השם המוצג של הגדרת העברת הנתונים. שם ההעברה יכול להיות כל ערך שיאפשר לכם לזהות את ההעברה אם תצטרכו לשנות אותה בהמשך.
‫PARAMETERS מכיל את פרמטרי ה-JSON הבאים להגדרת ההעברה: --params='{"param":"param_value"}'.
- customer_id: הזן את מזהה הלקוח שלך ב-Google Ads בפורמט 1231231234 או 123-123-1234. חובה למלא את השדה הזה.
- custom_report_table_names (אופציונלי): רשימה של שמות טבלאות עבור דוחות מותאמים אישית הכלולים בהעברה זו. הרשימה הזו תואמת לשאילתות ב-custom_report_queries. אורך הרשימה חייב להיות תואם לאורך הרשימה ב-custom_report_queries.
- ‫custom_report_queries (אופציונלי): רשימה של שאילתות בשפת השאילתות של Google Ads‏ (GAQL) עבור הדוחות בהתאמה אישית שכלולים בהעברה הזו. הרשימה הזו תואמת לשמות ב-custom_report_table_names. אורך הרשימה חייב להיות תואם לאורך הרשימה ב-custom_report_table_names.
- ‫exclude_removed_items (אופציונלי): מגדירים את הפרמטר הזה ל-true כדי למנוע העברה של ישויות ומדדים שהוסרו או הושבתו.
‫DATA_SOURCE הוא מקור הנתונים – google_ads.
‫TABLES היא רשימה מופרדת בפסיקים של טבלאות לכלול או להחריג מהעברת הנתונים.
‫SCHEDULE היא התדירות שבה רוצים שהשאילתה תפעל. אם לא צוין --schedule, ברירת המחדל היא כל 24 שעות, החל מרגע יצירת ההעברה.
‫REFRESH_DAYS הוא מספר שלם שמציין את חלון הרענון של הגדרת העברה בימים. ערך ברירת המחדל הוא 7.
‫SERVICE_ACCOUNT_NAME הוא השם של חשבון השירות שמשמש לאימות ההעברה. חשבון השירות חייב להיות בבעלות אותו project_id ששימש ליצירת ההעברה, ועליו להיות בעלי כל הההרשאות הנדרשות.
‫PMAX_ENABLE: מציינים true כדי לכלול טבלאות שספציפיות לדוחות של קמפיינים למיקסום הביצועים. ערך ברירת המחדל הוא false. מידע נוסף על התמיכה בקמפיינים למיקסום הביצועים זמין במאמר תמיכה בקמפיינים למיקסום הביצועים

לדוגמה, הפקודה הבאה יוצרת העברת נתונים של Google Ads בשם My Transfer באמצעות מספר הלקוח 123-123-1234 ומערך נתוני היעד mydataset. העברת הנתונים נוצרת בפרויקט ברירת המחדל:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"customer_id":"123-123-1234","exclude_removed_items":"true"}' \
--data_source=google_ads

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

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

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

API

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

Java

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

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

import com.google.api.gax.rpc.ApiException;
import com.google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest;
import com.google.cloud.bigquery.datatransfer.v1.DataTransferServiceClient;
import com.google.cloud.bigquery.datatransfer.v1.ProjectName;
import com.google.cloud.bigquery.datatransfer.v1.TransferConfig;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

// Sample to create ads(formerly AdWords) transfer config
public class CreateAdsTransfer {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    final String projectId = "MY_PROJECT_ID";
    String datasetId = "MY_DATASET_ID";
    // the customer_id only allows digits and hyphen ('-').
    String customerId = "012-345-6789";
    String refreshWindow = "100";
    Map<String, Value> params = new HashMap<>();
    params.put("customer_id", Value.newBuilder().setStringValue(customerId).build());
    params.put("refreshWindow", Value.newBuilder().setStringValue(refreshWindow).build());
    TransferConfig transferConfig =
        TransferConfig.newBuilder()
            .setDestinationDatasetId(datasetId)
            .setDisplayName("Your Ads Transfer Config Name")
            .setDataSourceId("adwords")
            .setParams(Struct.newBuilder().putAllFields(params).build())
            .build();
    createAdsTransfer(projectId, transferConfig);
  }

  public static void createAdsTransfer(String projectId, TransferConfig transferConfig)
      throws IOException {
    try (DataTransferServiceClient client = DataTransferServiceClient.create()) {
      ProjectName parent = ProjectName.of(projectId);
      CreateTransferConfigRequest request =
          CreateTransferConfigRequest.newBuilder()
              .setParent(parent.toString())
              .setTransferConfig(transferConfig)
              .build();
      TransferConfig config = client.createTransferConfig(request);
      System.out.println("Ads transfer created successfully :" + config.getName());
    } catch (ApiException ex) {
      System.out.print("Ads transfer was not created." + ex.toString());
    }
  }
}

הפעלת העברה של נתונים אל Google Ads באופן ידני

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

מודעה
AdGroup
AdGroupAudience
AdGroupBidModifier
AdGroupAdLabel
AdGroupCriterion
AdGroupCriterionLabel
AdGroupLabel
AgeRange
נכס
AssetGroup
AssetGroupAsset
AssetGroupListingGroupFilter
AssetGroupSignal
קהל
BidGoal
תקציב
מסע פרסום
CampaignAudience
CampaignCriterion
CampaignLabel
לקוח/ה
מגדר
מילת מפתח
LocationBasedCampaignCriterion
ParentalStatus
מיקום
וידאו

דוחות מותאמים אישית

מחבר שירות העברת הנתונים של BigQuery עבור Google Ads תומך גם בשימוש בדוחות מותאמים אישית באמצעות שאילתות GAQL (Google Ads Query Language) בתצורת ההעברה של Google Ads. הנתונים בדוחות המותאמים אישית האלה מגיעים מכל המקורות שזמינים בגרסת Google Ads API שנתמכת על ידי שירות העברת הנתונים ל-BigQuery. למידע נוסף על שימוש ואימות של שאילתת GAQL, ראו הכלי של Google Ads ליצירת שאילתות.

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

מגבלות על דוחות בהתאמה אישית

דוחות מותאמים אישית עם מחבר Google Ads כפופים למגבלות הבאות:

המחבר של Google Ads לא תומך בסעיפים WHERE, ORDER BY, LIMIT ו-PARAMETERS. שאילתת GAQL צריכה להיות בפורמט שדומה לזה: SELECT FIELD_NAME, FIELD_NAME,... FROM RESOURCE_NAME.
מחבר Google Ads מוסיף אוטומטית את הערך WHERE segments.date = run_date כשיש פלח תאריכים מרכזי (לדוגמה, segments.date, ‏ segments.week, ‏ segments.month, ‏ segments.quarter,‏ segments.year) בשאילתה. פעולה זו עלולה לגרום ל-מאמת השאילתות של Google Ads להחזיר שגיאה, לדוגמה, The filtering conditions in the WHERE clause must combine to form a valid, finite date range composed of the core date segments .... ניתן להתעלם בבטחה משגיאות אלו.
שאילתות GAQL ללא שדה segments.date פועלות כטבלאות התאמה, המתעדכנות פעם ביום בלבד ואינן נתמכות בהרצות מילוי חוזר. אם רוצים למלא נתונים חסרים, צריך לכלול שדה segments.date בשאילתת GAQL.
מחבר Google Ads תומך בהעברה של עד 100 דוחות מותאמים אישית בבת אחת.
כשמשתמשים בשדות מפולחים (לדוגמה, segments.ad_network_type או segments.device) בשאילתה מותאמת אישית, Google Ads API לא כולל קמפיינים שאין להם חשיפות.

קמפיינים למיקסום ביצועים (PMax)

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

הכללת נתונים מקמפיינים למיקסום הביצועים מסירה ad_group שדות מטבלאות מסוימות וכוללת טבלאות חדשות. אי אפשר לכלול את השדות [ad_group] כי Google Ads API מסנן את הנתונים של הקמפיין למיקסום הביצועים.

הטבלאות הבאות לא כוללות עמודות שקשורות לad_group כשמסומנת תיבת הסימון Include PMax Campaign Tables:

GeoStats
GeoConversionStats
ShoppingProductConversionStats
ShoppingProductStats
LocationsUserLocationsStats

הטבלאות הבאות מתווספות כשמסמנים את התיבה Include PMax Campaign Tables (הכללת טבלאות של קמפיינים למיקסום הביצועים):

נכס
AssetGroup
AssetGroupAsset
AssetGroupListingGroupFilter
AssetGroupSignal
קהל
AssetGroupProductGroupStats
CampaignAssetStats

תמיכה בחשבונות ניהול ב-Google Ads

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

לשימוש בחשבונות ניהול ב-Google Ads יש כמה יתרונות בהשוואה לשימוש במספרי לקוח פרטיים:

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

מידע נוסף על חשבונות ניהול ב-Google Ads ‏ (MCC) זמין במאמרים עבודה עם חשבונות מנוהלים ומידע על קישור חשבונות לחשבון הניהול.

דוגמה

הרשימה הבאה מציגה את מזהי הלקוחות המקושרים לחשבונות ניהול ספציפיים ב-Google Ads:

‫1234567890 – חשבון ניהול ראשי
- ‫1234 – חשבון ניהול משני
  - ‫1111 – מספר לקוח
  - ‫2222 – מספר לקוח
  - ‫3333 – מספר לקוח
  - ‫4444 – מספר לקוח
  - 567 - חשבון ניהול משנה
    - 5555 - מספר לקוח
    - ‫6666 – מספר לקוח
    - ‫7777 – מספר לקוח
- ‫89 – חשבון ניהול משני
  - 8888 - מספר לקוח
  - ‫9999 – מספר לקוח
- 0000 — מספר לקוח

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

העברת ההגדרה של מספר הלקוח 1234567890

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

‫1111 (דרך חשבון ניהול משני 1234)
‫2222 (דרך חשבון ניהול משני 1234)
‫3333 (דרך חשבון ניהול משני 1234)
4444 (דרך חשבון מנהל משנה 1234)
5555 (דרך חשבון מנהל משנה 567 וחשבון מנהל משנה 1234)
‫6666 (דרך חשבון ניהול משני 567 וחשבון ניהול משני 1234)
‫7777 (דרך חשבון ניהול משני 567 וחשבון ניהול משני 1234)
‫8888 (דרך חשבון ניהול משני מספר 89)
‫9999 (דרך חשבון ניהול משני מספר 89)
0000 (מספר לקוח אישי)

הגדרות העברה עבור מזהה לקוח 1234

הגדרת העברה לחשבון ניהול משני מספר 123 (מספר לקוח 1234) תיצור הרצות של העברת נתונים שיכללו את מספרי הלקוחות הבאים:

1111
2222
3333
4444
5555 (דרך חשבון מנהל משנה 567)
‫6666 (דרך חשבון ניהול משני 567)
‫7777 (דרך חשבון ניהול משני 567)

תצורת העברה עבור מזהה לקוח 567

הגדרת העברה לחשבון ניהול משני מספר 567 (מספר לקוח 567) תיצור הרצות של העברת נתונים שיכללו את מספרי הלקוחות הבאים:

5555
6666
7777

תצורת העברה עבור מזהה לקוח 89

תצורת העברה עבור חשבון תת-מנהל 89 (מזהה לקוח 89) תיצור הפעלות העברת נתונים הכוללות את מזהי הלקוחות הבאים:

8888
9999

תצורת העברה עבור מזהה לקוח 0000

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

0000

העברת נתוני Google Ads לחשבונות MCC

כדי להעביר את נתוני Google Ads הקיימים שלך בשירות העברת הנתונים של BigQuery למבנה של MCC, תוכל להגדיר מילוי חוזר (backfill) כדי להוסיף את הנתונים הקיימים שלך לטבלאות שנוצרו על ידי תצורת ההעברה המקושרת לחשבון הניהול. שים לב שכאשר אתה מתזמן מילוי חוזר, טבלאות ההתאמה אינן מתעדכנות.

פתרון בעיות בהגדרת ההעברה של גוגל אדס

אם אתם נתקלים בבעיות בהגדרת העברת הנתונים, עיינו בבעיות העברה ב-Google Ads בפתרון בעיות בתצורות העברה.

שאילת הנתונים שלך

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

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

שאילתות לדוגמה של גוגל אדס

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

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

ביצועים ברמת הקמפיין

שאילתת הדוגמה הבאה מנתחת את ביצועי קמפיין Google Ads ב-30 הימים האחרונים.

המסוף

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_impressions) AS Impressions,
  SUM(cs.metrics_interactions) AS Interactions,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
FROM
  `DATASET.ads_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.ads_CampaignBasicStats_CUSTOMER_ID` cs
ON
  (c.campaign_id = cs.campaign_id
  AND cs._DATA_DATE BETWEEN
  DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

BQ

  bq query --use_legacy_sql=false '
  SELECT
    c.customer_id,
    c.campaign_name,
    c.campaign_status,
    SUM(cs.metrics_impressions) AS Impressions,
    SUM(cs.metrics_interactions) AS Interactions,
    (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
  FROM
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  LEFT JOIN
    `DATASET.ads_CampaignBasicStats_CUSTOMER_ID` cs
  ON
    (c.campaign_id = cs.campaign_id
    AND cs._DATA_DATE BETWEEN
    DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
  WHERE
    c._DATA_DATE = c._LATEST_DATE
  GROUP BY
    1, 2, 3
  ORDER BY
    Impressions DESC'

מחליפים את מה שכתוב בשדות הבאים:

DATASET: שם מערך הנתונים שיצרת לאחסון הטבלה שהועברה
‫CUSTOMER_ID: מספר הלקוח שלכם ב-Google Ads.

מספר מילות המפתח

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

המסוף

  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.ads_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.ads_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4

BQ

  bq query --use_legacy_sql=false '
  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.ads_Keyword_CUSTOMER_ID` k
  JOIN
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.ads_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4'

מחליפים את מה שכתוב בשדות הבאים:

DATASET: שם מערך הנתונים שיצרת לאחסון הטבלה שהועברה
‫CUSTOMER_ID: מספר הלקוח שלכם ב-Google Ads.