מדריך להעברת נתונים (מיגרציה) ב-Search Ads 360

המחבר של Search Ads 360 (לשעבר DoubleClick Search) מסתמך על Search Ads 360 Reporting API החדש. הגרסה הישנה של Search Ads 360 Reporting API כבר לא נתמכת, ולכן צריך להעביר את תהליכי העבודה של שירות העברת הנתונים ל-BigQuery כדי שיתאימו לממשק החדש של Search Ads 360 Reporting API. במסמך הזה מפורטים השינויים בממשק החדש של Search Ads 360 בהשוואה לממשק הישן של Search Ads 360, ומוצג מידע על מיפוי לצורך העברת המשאבים הקיימים לממשק החדש של Search Ads 360.

מה חדש ב-Search Ads 360

ב-Search Ads 360 Reporting API החדש יש כמה שינויים שיכולים להשפיע על תהליכי העבודה הקיימים של שירות העברת הנתונים ל-BigQuery.

מבנה החשבון

ב-Search Ads 360 Reporting API החדש, החשבונות מאורגנים בהיררכיה של חשבונות ניהול, חשבונות ניהול משניים וחשבונות לקוח. מידע נוסף על ההבדלים בהיררכיית החשבונות ומידע נוסף על חשבונות ניהול.

מרחב מזהים

המיפוי של מרחב המזהים של ישויות בממשק החדש של Search Ads 360 שונה מהמיפוי בגרסאות קודמות של Search Ads 360. במאמר מיפוי מזהים מוסבר איך למפות בין המזהים הקודמים למזהים החדשים.

דיווח מבוסס-משאבים

מודל הנתונים של Search Ads 360 API החדש מבוסס על משאבים, בניגוד למודל הנתונים של Search Ads 360 API הישן שמבוסס על דוחות. המחבר החדש של Search Ads 360 API יוצר טבלאות ב-BigQuery על ידי שליחת שאילתות למשאבים ב-Search Ads 360. מידע נוסף על מבנה המשאבים ב-Search Ads 360 API של הממשק החדש של Search Ads 360 זמין במאמר מבנה Search Ads 360 Reporting API.

העברת הגדרות העברה

אין שיטה אוטומטית להמיר הגדרות העברה קיימות של Search Ads 360 ל-Search Ads 360 Reporting API החדש. צריך ליצור העברת נתונים חדשה של הממשק החדש של Search Ads 360 עם Search Ads 360 Reporting API החדש כמקור הנתונים.

בדיקת פרטי המיפוי

כדי למפות את המשאבים הקיימים של Search Ads 360 ל-Search Ads 360 Reporting API החדש, צריך לעיין במידע הבא על המיפוי.

מיפוי דוחות

הדוחות בממשק החדש של Search Ads 360 מבוססים על משאבים, והמבנה שלהם שונה מהמבנה של הדוחות בממשק הישן של Search Ads 360. כדי לראות מיפוי מלא של הדוחות הישנים והחדשים, עיינו במאמר מיפוי דוחות ל-Search Ads 360 Reporting API.

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

דוח ישן של מודעות לרשת החיפוש	משאב חדש למודעות לרשת החיפוש	שם חדש לטבלה ב-BigQuery
adGroup	ad_group	p_sa_AdGroupStats_customer_id p_sa_AdGroup_customer_id p_sa_AdGroupDeviceStats_customer_id p_sa_AdGroupConversionActionAndDeviceStats_customer_id
ad	ad_group_ad	p_sa_AdConversionActionAndDeviceStats_customer_id p_sa_AdDeviceStats_customer_id p_sa_Ad_customer_id
לא רלוונטי	ad_group_asset	p_sa_AdGroupAssetStats_customer_id p_sa_AdGroupConversionActionAndAssetStats_customer_id
לא רלוונטי	ad_group_asset_set	p_sa_AdGroupAssetSet_customer_id
adGroupTarget	ad_group_audience_view	p_sa_AdGroupAudienceDeviceStats_customer_id p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
adGroupTarget	ad_group_criterion	p_sa_NegativeAdGroupCriterion_customer_id p_sa_NegativeAdGroupKeyword_customer_id p_sa_AdGroupCriterion_customer_id
adGroupTarget	age_range_view	p_sa_AgeRangeDeviceStats_customer_id p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
לא רלוונטי	נכס	p_sa_Asset_customer_id
bidStrategy	bidding_strategy	p_sa_BidStrategy_customer_id p_sa_BidStrategyStats_customer_id
campaign	campaign	p_sa_CampaignConversionActionAndDeviceStats_customer_id p_sa_Campaign_customer_id p_sa_CampaignDeviceStats_customer_id p_sa_CampaignStats_customer_id
לא רלוונטי	campaign_asset	p_sa_CampaignAssetStats_customer_id p_sa_CampaignConversionActionAndAssetStats_customer_id
לא רלוונטי	campaign_asset_set	p_sa_CampaignAssetSet_customer_id
campaignTarget	campaign_audience_view	p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id p_sa_CampaignAudienceDeviceStats_customer_id
campaignTarget	campaign_criterion	p_sa_CampaignCriterion_customer_id p_sa_NegativeCampaignKeyword_customer_id p_sa_NegativeCampaignCriterion_customer_id
productLeadAndCrossSell	cart_data_sales_view	p_sa_CartDataSalesStats_customer_id
המרה	המרה	p_sa_Conversion_customer_id
floodlightActivity	conversion_action	p_sa_ConversionAction_customer_id
חשבון	customer	p_sa_Account_customer_id p_sa_AccountDeviceStats_customer_id p_sa_AccountConversionActionAndDeviceStats_customer_id p_sa_AccountStats_customer_id
לא רלוונטי	customer_asset	p_sa_CustomerAssetStats_customer_id p_sa_CustomerConversionActionAndAssetStats_customer_id
לא רלוונטי	customer_asset_set	p_sa_CustomerAssetSet_customer_id
adGroupTarget	gender_view	p_sa_GenderDeviceStats_customer_id p_sa_GenderConversionActionAndDeviceStats_customer_id
מילת מפתח	keyword_view	p_sa_Keyword_customer_id p_sa_KeywordDeviceStats_customer_id p_sa_KeywordStats_customer_id p_sa_KeywordConversionActionAndDeviceStats_customer_id
adGroupTarget	location_view	p_sa_LocationDeviceStats_customer_id p_sa_LocationConversionActionAndDeviceStats_customer_id
productAdvertised	shopping_performance_view	p_sa_ProductAdvertised_customer_id p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id p_sa_ProductAdvertisedDeviceStats_customer_id
productGroup	product_group_view	p_sa_ProductGroupStats_customer_id p_sa_ProductGroup_customer_id
ביקור	ביקור	p_sa_Visit_customer_id
adGroupTarget	webpage_view	p_sa_WebpageDeviceStats_customer_id p_sa_WebpageConversionActionAndDeviceStats_customer_id

מיפוי שדות

שירות העברת הנתונים ל-BigQuery תומך בקבוצת משנה של שדות בדוחות של Search Ads 360, כמו שמפורט במאמר טרנספורמציה של דוחות Search Ads 360. ב-BigQuery אין תמיכה ב-. בשמות של עמודות, ולכן בכל הדוחות שמועברים, . מוחלף ב-_. לדוגמה, השדה ad_group_ad.ad.text_ad.description1 במשאב של Search Ads 360 מועבר ל-BigQuery בתור ad_group_ad_ad_text_ad_description1.

מיפוי מזהים

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

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

הדוגמאות הבאות ממחישות איך שאילתה ב-BigQuery עשויה להיראות לפני ואחרי שהיא ממופה ל-Reporting API של הממשק החדש של Search Ads 360.

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

SELECT
  c.accountId,
  c.campaign,
  C.status,
  SUM(cs.impr) AS Impressions,
  SUM(cs.clicks) AS Clicks,
  (SUM(cs.cost) / 1000000) AS Cost
FROM
  `previous_dataset.Campaign_advertiser_id` c
LEFT JOIN
  `previous_dataset.CampaignStats_advertiser_id` cs
ON
  (c.campaignId = cs.campaignId
  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

כשממפים את השאילתה כדי שתהיה תואמת ל-Search Ads 360 Reporting API של הממשק החדש של Search Ads 360, היא מומרת לשאילתה הבאה:

SELECT
  c.customer_id,
  c.campaign_name,
  C.campaign_status,
  SUM(cs.metrics_impressions) AS Impressions,
  SUM(cs.metrics_clicks) AS Clicks,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
FROM
  `new_dataset.sa_Campaign_customer_id` c
LEFT JOIN
  `new_dataset.sa_CampaignStats_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

דוגמאות נוספות לשאילתות שתואמות לממשק החדש של Search Ads 360 זמינות במאמר שאילתות לדוגמה.

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

• במאמר העברות של Search Ads 360 מוסבר איך לתזמן ולנהל משימות טעינה חוזרות מ-Search Ads 360.
• במאמר טרנספורמציה של דוחות Search Ads 360 מוסבר איך אפשר לשנות את הדוחות של Search Ads 360.