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

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

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

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