מדריך להעברה ב-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.

מבנה החשבון

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

מרחב מזהים

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

דיווח על סמך משאבים

מודל הנתונים של הממשק החדש של Search Ads 360 מבוסס על משאבים, בניגוד ל-Search Ads 360 API הישן שמבוסס על דוחות. מחבר ה-Search Ads 360 API החדש יוצר טבלאות BigQuery על ידי שליחת שאילתות למשאבים ב-Search Ads 360. מידע נוסף על מבנה המשאבים בממשק החדש של Search Ads 360 API זמין במאמר מבנה 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, לצד המשאבים שנשלחות לגביהם שאילתות כדי ליצור את הטבלאות.

הדוח הישן של מודעות לרשת החיפוש	משאב חדש של Search Ads 360	שם חדש של טבלה ב-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
קמפיין	קמפיין	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
חשבון	לקוח	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	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 עשויה להיראות לפני ואחרי המיפוי שלה ל-API של דוחות הממשק החדש של Search Ads 360.

כדאי לעיין בשאילתה לדוגמה הבאה שמנתחת את ביצועי הקמפיין ב-Search Ads מ-30 הימים האחרונים באמצעות ה-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

כשממפים את השאילתה כך שתהיה תואמת ל-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.