פידים של נתוני נסיעות במודעות לרשת החיפוש

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

איך הגדרות הלקוח והגדרות הקמפיין משפיעות זו על זו

כברירת מחדל, קמפיינים מקבלים בירושה קישורים לפידים של נסיעות (TRAVEL_FEED קבוצות נכסים) מרמת הלקוח דרך שיוכים של CustomerAssetSet. כדי לשנות את ההגדרות ברמת הלקוח בקמפיין ספציפי, צריך להוסיף את הערך TRAVEL_FEED לשדה excluded_parent_asset_set_types של הקמפיין ולנהל את הקישורים הספציפיים לקמפיין באמצעות CampaignAssetSet.

• העברת פידים של לקוחות (ברירת מחדל): הפיד ברמת הלקוח CustomerAssetSet יישאר מקושר, ויוודא שפיד Campaign.excluded_parent_asset_set_types לא יכיל TRAVEL_FEED.
• ביטול ההסכמה ברמת הלקוח: מסירים את השיוך של CustomerAssetSet ברמת הלקוח, ולא מקשרים CampaignAssetSet ברמת הקמפיין.
• ביטול ההסכמה לקמפיין ספציפי: מוסיפים TRAVEL_FEED ל-Campaign.excluded_parent_asset_set_types ומסירים את כל השיוכים ברמת הקמפיין CampaignAssetSet.
• הבעת הסכמה בקמפיין ספציפי בלבד: מסירים את השיוך של CustomerAssetSet ברמת הלקוח, ואז יוצרים קישור של CampaignAssetSet ברמת הקמפיין בשביל הקמפיין הזה.
• שימוש בפידים ספציפיים לקמפיין בזמן שקמפיינים אחרים ממשיכים לרשת: מוסיפים את התג TRAVEL_FEED ל-Campaign.excluded_parent_asset_set_types של הקמפיין ויוצרים קישור CampaignAssetSet ברמת הקמפיין.

ביטול ההסכמה לשימוש בפידים של נתוני נסיעות במודעות לרשת החיפוש

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

סירוב ברמת הלקוח

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

1. כדי לאחזר את הערכים של customer_asset_set.resource_name ושל asset_set.resource_name עבור כל הקישורים מסוג TRAVEL_FEED של CustomerAssetSet, משתמשים בדוח customer_asset_set:

   SELECT
     customer_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM customer_asset_set
   WHERE asset_set.type = 'TRAVEL_FEED'
   

2. לכל customer_asset_set.resource_name, יוצרים CustomerAssetSetOperation ומגדירים את remove לערך customer_asset_set.resource_name שאוחזר בשלב הקודם.

3. שולחים בקשה אל CustomerAssetSetService.MutateCustomerAssetSets באמצעות אובייקטים מסוג CustomerAssetSetOperation שנוצרו.

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

1. לכל AssetSet (asset_set.resource_name) בסיסי שרוצים לקשר, יוצרים CustomerAssetSet חדש, מגדירים את asset_set בתור asset_set.resource_name ומגדירים את customer בתור שם המשאב של הלקוח.
2. לכל CustomerAssetSet שנוצר בשלב הקודם, יוצרים CustomerAssetSetOperation עם create שמוגדר ל-CustomerAssetSet.
3. שולחים בקשה אל CustomerAssetSetService.MutateCustomerAssetSets באמצעות האובייקטים של CustomerAssetSetOperation שנוצרו.

סירוב ברמת הקמפיין

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

1. אחזור של excluded_parent_asset_set_types באמצעות הדוח campaign:

   SELECT
     campaign.excluded_parent_asset_set_types
   FROM campaign
   WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
   

2. יוצרים אובייקט Campaign חדש, מגדירים את excluded_parent_asset_set_types לערכים הקודמים בתוספת TRAVEL_FEED, ומגדירים את resource_name לשם המשאב של הקמפיין.

3. יוצרים CampaignOperation ומגדירים את update ל-Campaign ול-update_mask שנוצרו קודם, בהתאמה.

4. שולחים בקשה אל CampaignService.MutateCampaigns באמצעות CampaignOperation שנוצר בשלב הקודם.

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

1. בקמפיין שרוצים לבטל את ההסכמה לגביו, מאחזרים את הערכים campaign_asset_set.resource_name ו-asset_set.resource_name לכל הקישורים מסוג CampaignAssetSet שהסוג שלהם הוא TRAVEL_FEED באמצעות הדוח campaign_asset_set:

   SELECT
     campaign_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM campaign_asset_set
   WHERE campaign_asset_set.campaign =
       'INSERT_YOUR_CAMPAIGN_RESOURCE_NAME'
     AND asset_set.type = 'TRAVEL_FEED'
   

2. לכל campaign_asset_set.resource_name, יוצרים CampaignAssetSetOperation ומגדירים את remove ל-campaign_asset_set.resource_name שאוחזר בשלב הקודם.

3. שולחים בקשה אל CampaignAssetSetService.MutateCampaignAssetSets באמצעות האובייקטים של CampaignAssetSetOperation שנוצרו.

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

1. לכל AssetSet (asset_set.resource_name) בסיסי שרוצים להפעיל, יוצרים CampaignAssetSet חדש עם asset_set שמוגדר ל-asset_set.resource_name ועם campaign שמוגדר לשם המשאב של הקמפיין.
2. לכל CampaignAssetSet שנוצר בשלב הקודם, יוצרים CampaignAssetSetOperation עם create שמוגדר ל-CampaignAssetSet.
3. שולחים בקשה אל CampaignAssetSetService.MutateCampaignAssetSets באמצעות אובייקטים מסוג CampaignAssetSetOperation שנוצרו.

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

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

1. יוצרים אובייקט חדש מסוג Campaign עם excluded_parent_asset_set_types ללא TRAVEL_FEED ברשימה, ומגדירים את resource_name לשם המשאב של הקמפיין.
2. יוצרים CampaignOperation ומגדירים את update ל-Campaign שנוצר קודם ואת update_mask בהתאם.
3. שולחים בקשה אל CampaignService.MutateCampaigns באמצעות ה-CampaignOperation שנוצר בשלב הקודם.

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

החל מגרסה v25 של Google Ads API, אפשר להגדיר שינויים של הצעות מחיר ידניות לפי עלות לקליק לכל ישות של מלון בקמפיינים לרשת החיפוש ל-Google נסיעות. כדי לעשות את זה, משתמשים במשאב AdGroupCriterion עם סוג הקריטריון CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid).

דרישות מוקדמות ודרישות תאימות

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

• סוג הקמפיין: קמפיינים לרשת החיפוש בענף התיירות (קמפיינים לרשת החיפוש, AdvertisingChannelType.SEARCH, עם AI למיקסום ביצועים של קמפיינים לרשת החיפוש Campaign.ai_max_setting.enable_ai_max ופיד מלונות משויך [TRAVEL_FEED קבוצת נכסים]; רק פידים של מלונות נתמכים).
• שיטת בידינג: עלות ידנית לקליק (BiddingStrategyType.MANUAL_CPC) בלבד.
  • לא נתמך בשיטות בידינג אוטומטיות או שיטות בידינג חכמות (כמו 'מקסימום המרות', 'מקסימום ערך המרות', 'יעד עלות להמרה' או 'יעד החזר על הוצאות פרסום').
• קריטריונים חיוביים בלבד: צריך להגדיר את negative לערך false. אין תמיכה בהצעות מחיר שליליות לישויות.
• מזהה הישות והצעת המחיר הנדרשים: entity_bid.item_code ו- cpc_bid_micros נדרשים כשיוצרים קריטריון של הצעת מחיר לישות.

הגדרות של סכימות ושדות

• משאב: AdGroupCriterion (ad_group_criterion)
• הפורמט של שם המשאב: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• סוג הקריטריון (ערך enum): CriterionType.VERTICAL_ADS_ITEM_BID
• הודעה: EntityBid (ad_group_criterion.entity_bid)

שירותים ופעולות נתמכים

דוגמאות לקוד ולמטען ייעודי (payload)

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

קריאת הצעות מחיר לישויות באמצעות GAQL

משתמשים ב-GoogleAdsService.Search או ב-GoogleAdsService.SearchStream כדי לשלוח שאילתה לגבי קריטריונים של VERTICAL_ADS_ITEM_BID:

SELECT
  ad_group_criterion.resource_name,
  ad_group_criterion.ad_group,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.cpc_bid_micros,
  ad_group_criterion.entity_bid.item_code
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'VERTICAL_ADS_ITEM_BID'

יצירת הצעת מחיר לישות

שולחים פעולת create אל AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

עדכון של סכום הצעת מחיר קיים לישות

שולחים פעולת update עם updateMask אל AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

הסרת הצעת מחיר לישות

שולחים פעולת remove אל AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

כללי אימות וטיפול בשגיאות

דוחות ביצועים

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

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

פלחי מאפיינים של מסלול הנסיעה

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

• ‫segments.advance_booking_window: חלון ההזמנה מראש של מסלול הנסיעה בימים.
• ‫segments.length_of_booking: משך ההזמנה של מסלול הנסיעה בימים.
• segments.start_date: תאריך ההתחלה של ההזמנה בפורמט yyyy-MM-dd.
• ‫segments.start_day_of_week: היום בשבוע שבו ההזמנה מתחילה.
• ‫segments.user_set_dates: מציין אם נבחרו תאריכים שצוינו על ידי המשתמש (USER_SELECTED או DEFAULT_SELECTION).

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

SELECT
  campaign.name,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  segments.start_day_of_week,
  segments.user_set_dates,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS