خلاصات السفر في "الإعلانات على شبكة البحث"

عند ربط خلاصات منتجات الفنادق أو أماكن الاستئجار أو نشاطات مقترحة بحساب "إعلانات Google"، تُزوِّد "إعلانات Google" تلقائيًا الحملات على شبكة البحث الحالية بالأسعار والصور المستمدة من خلاصاتك. تُعرَف هذه الميزة باسم خلاصات السفر في الإعلانات على شبكة البحث.

تفاعل إعدادات العميل وإعدادات الحملة

تلقائيًا، تكتسب الحملات روابط خلاصات السفر (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 الذي تم إنشاؤه في الخطوة السابقة.

عروض أسعار النقرة اليدوية لكلّ عنصر

بدءًا من Google Ads API v25، يمكنك ضبط عمليات إلغاء عروض أسعار النقرة اليدوية لكلّ عنصر للفنادق في "الحملات على شبكة البحث للسفر" باستخدام المورِد AdGroupCriterion مع نوع المعيار CriterionType.VERTICAL_ADS_ITEM_BID(ad_group_criterion.entity_bid).

المتطلبات الأساسية ومتطلبات التوافق

لإنشاء معايير VERTICAL_ADS_ITEM_BID وإدارتها، يجب استيفاء الشروط التالية:

• نوع الحملة: حملات على شبكة البحث للسفر (حملات على شبكة البحث، AdvertisingChannelType.SEARCH، مع تفعيل ميزة AI Max في الحملات على شبكة بحث Google 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}
• تعداد نوع المعيار: CriterionType.VERTICAL_ADS_ITEM_BID
• الرسالة: EntityBid (ad_group_criterion.entity_bid)

الخدمات والعمليات المتوافقة

أمثلة على الرموز والحِملات

توضّح الأمثلة التالية كيفية قراءة معايير 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