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

כשמקשרים את פיד המוצרים של מלונות, יחידות אירוח או דברים שאפשר לעשות לחשבון 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 לכל הקישורים מסוג CustomerAssetSet שהסוג שלהם הוא TRAVEL_FEED באמצעות הדוח 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, אפשר להגדיר בידינג ידני לפי עלות לקליק לכל ישות במלונות בקמפיינים לרשת החיפוש בענף התיירות. כדי לעשות את זה, משתמשים במשאב AdGroupCriterion עם סוג הקריטריון CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid). כדי להגדיר התאמות של הצעות מחיר לקבוצת מודעות במכפלה במאפיינים של מסלול הנסיעה באמצעות AdGroupBidModifier, אפשר לעיין במאמר התאמת הצעות מחיר באמצעות התאמות של הצעות מחיר.

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

כדי ליצור ולנהל קריטריונים של 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