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

عند ربط خلاصات منتجات الفنادق أو أماكن الاستئجار أو النشاطات المقترحة بحسابك على "إعلانات 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 الذي تم إنشاؤه في الخطوة السابقة.

عروض أسعار النقرة اليدوية لكل جهة

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

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

لإنشاء معايير 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