«بیشینه‌سازی عملکرد» برای اهداف پرداخت به‌ازای مشتری بالقوه

پویش‌های «عملکرد بیشینه» با هدف‌های پرداخت به‌ازای مشتری بالقوه به کسب‌وکارهای محلی امکان می‌دهد به مشتریان دسترسی پیدا کنند. این کمپین‌ها «آگهی‌های خدمات محلی» را ارائه می‌دهند و بنابراین به‌عنوان کمپین‌های «عملکرد بیشینه» خدمات محلی نیز شناخته می‌شوند و بااستفاده از فیلدها و سرویس‌های local_services_* در Google Ads API پیکربندی می‌شوند. با این راه‌اندازی، هزینه بازاریابی شما بر ارتباط مستقیم با مشتری متمرکز می‌شود. فقط زمانی هزینه از شما کسر می‌شود که مشتری بالقوه مستقیماً ازطریق آگهی‌تان با کسب‌وکارتان تماس بگیرد، نه زمانی که روی آگهی‌تان کلیک کند.

قبل‌از شروع، مطمئن شوید که یک کد توسعه‌دهنده فعال با دسترسی استاندارد دارید. برای اطلاعات بیشتر، راهنمای شروع به کار را ببینید.

گردش کار ایجاد پویش

مراحل ایجاد پویش «عملکرد بیشینه» برای اهداف پرداخت به‌ازای مشتری بالقوه به‌شرح زیر است:

  1. پیش‌نیازهای سطح حساب را تکمیل کنید
  2. بازیابی دارایی مکان و فهرستگان «نمایه کسب‌وکار Google»
  3. ایجاد منابع پویش به‌صورت اتمی (GoogleAdsService.Mutate)
  4. پویش را فعال کنید و درستی‌سنجی کسب‌وکار را تکمیل کنید

پیش‌نیازهای سطح حساب را تکمیل کنید

اگر درحال ایجاد کمپین برای «حساب Google Ads» موجود هستید، پیش‌نیازهای زیر را در حساب تکمیل کنید و سپس کمپین را ایجاد کنید. اگر درحال ایجاد حساب Google Ads جدیدی هستید، این مراحل را قبل‌از اجرای عملیات ایجاد پویش تکمیل کنید:

  1. پذیرفتن شرایط خدمات (فقط واسط کاربری Google Ads): باید «شرایط خدمات» «خدمات محلی» را در صفحه «تنظیمات حساب Google Ads» بپذیرید. این قرارداد را نمی‌توان به‌صورت برنامه‌نویسی‌شده ازطریق API پذیرفت. ایجاد یا فعال کردن پویش بدون پذیرفتن قرارداد، CampaignError.LOCAL_SERVICES_AGREEMENT_REQUIRED را برمی‌گرداند.
  2. پیوند «نمایه کسب‌وکار Google» (میانای کاربر یا میانای برنامه‌سازی کاربردی Google Ads): نمایه کسب‌وکار را به حساب Google Ads پیوند دهید (در میانای کاربر Google Ads در بخش مدیر داده‌ها > حساب‌های پیوندشده، یا به‌صورت برنامه‌نویسی‌شده بااستفاده از LOCATION_SYNC تایپ‌شده AssetSet). توجه داشته باشید که ایجاد LOCATION_SYNC AssetSet به‌تنهایی همگام‌سازی مکان را برای حساب فعال نمی‌کند؛ باید آن را بااستفاده از CustomerAssetSet (CustomerAssetSetService.MutateCustomerAssetSets) به مشتری پیوست کنید و OAuth 2.0 http_authorization_token را با دامنه https://www.googleapis.com/auth/business.manage ارائه دهید. برای اطلاعات بیشتر، ایجاد مجموعه دارایی همگام‌سازی مکان و پیوست کردن آن به مشتری را ببینید. این کار مکان‌های کسب‌وکار را به‌عنوان دارایی‌های حساب LOCATION در حساب Google Ads همگام‌سازی می‌کند.

بازیابی دارایی مکان و فهرستگان «نمایه کسب‌وکار Google»

بااستفاده از GoogleAdsService.Search، منبع asset را پُرسمان کنید، با تکیه بر دارایی‌های LOCATION که پس‌از پیوند دادن «نمایه کسب‌وکار Google» در بخش قبلی پیش‌نیازهای سطح حساب را تکمیل کنید همگام‌سازی شده‌اند.

این پُرسمان listing_id «نمایه کسب‌وکار Google» موردنیاز برای تنظیمات پویش و asset.resource_name موردنیاز برای پیوند دادن به STATIC_LOCATION_GROUP پویش AssetSet را بااستفاده از AssetSetAsset بازیابی می‌کند:

SELECT
  asset.id,
  asset.name,
  asset.location_asset.place_id,
  asset.location_asset.business_profile_locations
FROM asset
WHERE asset.type = 'LOCATION'

ایجاد منابع پویش به‌صورت اتمی (GoogleAdsService.Mutate)

پویش‌های دارای هدف «پرداخت به‌ازای مشتری بالقوه» از مجموعه منابع زیر استفاده می‌کنند:

با توجه به الزامات راه‌اندازی خاص برای پویش‌های دارای اهداف پرداخت به‌ازای مشتری بالقوه، همه عملیات را در یک درخواست اتمی واحد GoogleAdsService.Mutate بسته‌بندی کنید تا از پیکربندی‌های ناقص جلوگیری شود و از یکپارچگی تراکنشی اطمینان حاصل شود.

CampaignBudget (ایجاد)

بودجه روزانه پویش را تعیین کنید:

  • amount_micros: مبلغ بودجه روزانه به میکرو.
  • delivery_method: STANDARD.
  • explicitly_shared: باید روی false تنظیم شود. پویش‌های «عملکرد بیشینه» نمی‌توانند از بودجه‌های مشترک استفاده کنند.

Campaign (ایجاد)

فقط یک پویش «عملکرد بیشینه» «خدمات محلی» حذف‌نشده برای هر حساب مشتری مجاز است؛ ایجاد پویش دوم CampaignError.LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED را برمی‌گرداند.

  • name: نام الزامی برای پویش.
  • campaign_budget: نام منبع موقت CampaignBudget ایجادشده در همان درخواست.
  • advertising_channel_type: باید روی PERFORMANCE_MAX تنظیم شود.
  • brand_guidelines_enabled: باید روی false تنظیم شود. برخلاف پویش‌های استاندارد «عملکرد بیشینه» (که به‌طور پیش‌فرض روی brand_guidelines_enabled = true تنظیم شده‌اند و نیاز به پیوند دادن منابع BUSINESS_NAME و LOGO CampaignAsset دارند)، پویش‌های «عملکرد بیشینه» «خدمات محلی» روی brand_guidelines_enabled = false تنظیم شده‌اند.
  • pmax_campaign_settings.local_services_enabled: باید روی true تنظیم شود (بولی تغییرناپذیر؛ پس‌از ایجاد نمی‌توان آن را تغییر داد).
  • pmax_campaign_settings.local_services_pmax_campaign_settings:
    • country_code: کد کشور ISO-3166 دوحرفی الزامی ('US'). در زمان ایجاد اعتبارسنجی می‌شود.
    • listing_id: شناسه عددی الزامی فهرست «نمایه کسب‌وکار Google» که نشان‌دهنده مکان ارائه‌دهنده است. در زمان ایجاد پویش اعتبارسنجی می‌شود؛ شناسه نامعتبر CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID را برمی‌گرداند.
    • اختیاری: phone_numbers: پیام LocalServicesPhoneNumber تکراری که شماره تلفن‌های اختصاصی کسب‌وکار یا ردیابی را مشخص می‌کند (phone_number، country_code، و GlsPhoneNumberType phone_number_type). اگر حذف شود، شماره تماس به‌طور پیش‌فرض به شماره تلفن موجود در فهرستگان پیوندشده «نمایه کسب‌وکار Google» تبدیل می‌شود و اگر فهرستگان «نمایه کسب‌وکار» شماره تلفن نداشته باشد، الزامی است. مقادیر phone_number_type پشتیبانی‌شده عبارت‌اند از DESTINATION_PHONE_NUMBER_FOR_ADS (برای مشتریان بالقوه تماس) و DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY (اختیاری، برای اعلان‌های پیامکی مشتریان بالقوه پیام).
    • اختیاری: founding_year: سال تأسیس کسب‌وکار (مثلاً 1998).
    • اختیاری: navigational_query_leads_enabled: بولی که نشان می‌دهد آیا مشتریان بالقوه از پُرسمان‌های نمانام ناوبری دریافت شوند یا نه.
  • maximize_conversions: پیام راهبرد پیشنهاد قیمت الزامی درحال پیکربندی پیشنهاد قیمت MAXIMIZE_CONVERSIONS (با target_cpa_micros اختیاری). «برگشت هزینه‌های تبلیغات» هدف و پیشنهاد قیمت غیرخودکار پشتیبانی نمی‌شود.
  • status: هنگام ایجاد روی PAUSED تنظیم شده است تا گروه‌های دارایی، سیگنال‌ها، و درستی‌سنجی‌های کسب‌وکار نهایی شوند.

CampaignCriterion (ایجاد)

پارامترهای هدف‌یابی را برای پویش با دسته‌بندی یک عملیات برای هر معیار تعریف کنید و به نام منبع موقت پویش پیوند دهید:

  • هدف‌یابی زبانی (language): برای پویش‌های ایالات متحده، به‌طور دقیق به‌عنوان انگلیسی (languageConstants/1000) اعمال می‌شود. زبان‌های دیگر در زمان جهش رد می‌شوند.
  • هدف‌یابی مکان منطقه خدماتی (location): کمپین‌های «عملکرد بیشینه» خدمات محلی باید حداقل یک معیار مکان مثبت داشته باشند که منطقه خدماتی را تعریف کند (برداشتن همه مکان‌ها CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN را برمی‌گرداند). هم گنجاندن‌های مثبت و هم مستثنی کردن‌ها در سطح شهر، شهرستان، کد پستی، یا ایالت در country_code اعلام‌شده کمپین (US) پشتیبانی می‌شوند. هدف‌یابی در سطح کشور مجاز نیست و با CampaignCriterionError.CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN رد می‌شود. شناسه‌های معیار را بااستفاده از GeoTargetConstantService.SuggestGeoTargetConstants، پرس‌وجوی Google Ads Query Language geo_target_constant، یا جدول مرجع هدف‌یابی جغرافیایی Google Ads حل‌وفصل کنید.
  • اختیاری: زمان‌بندی سفارشی آگهی (ad_schedule): اگر حذف شود، به‌طور پیش‌فرض روی تحویل ۲۴/۷ تنظیم می‌شود. محدود کردن تحویل بااستفاده از معیارهای مثبت ad_schedule.

گروه هدف‌یابی مکانی (AssetSet و AssetSetAsset) (ایجاد)

AssetSet تایپ‌شده STATIC_LOCATION_GROUP ایجاد کنید و location_group_parent_asset_set_id را روی شناسه حساب فعال LOCATION_SYNC AssetSet تنظیم کنید، و دارایی همگام‌سازی‌شده خاص LOCATION را بااستفاده از AssetSetAsset پیوند دهید.

برای جزئیات بیشتر، راهنمای دارایی‌های مکان را ببینید.

CampaignAssetSet (ایجاد)

پیوند دادن پویش به مجموعه دارایی STATIC_LOCATION_GROUP. پس‌از پیوند شدن، این ارتباط تغییرناپذیر است و نمی‌توان آن را برداشت (AssetSetLinkError.ASSET_SET_LINK_CANNOT_BE_REMOVED).

وقتی partial_failure = false (پیش‌فرض برای GoogleAdsService.Mutate)، هرگونه شکست اعتبارسنجی در عملیات بسته‌بندی‌شده، کل تراکنش را به‌صورت اتمی بازمی‌گرداند. سه قانون درستی‌سنجی CampaignAssetSet زیر اجرا می‌شود:

  1. فقط یک STATIC_LOCATION_GROUP AssetSet می‌تواند به پویش پیوند داده شود (AssetSetLinkError.DUPLICATE_ASSET_SET_LINK).
  2. STATIC_LOCATION_GROUP می‌تواند حداکثر یک دارایی LOCATION فعال داشته باشد.
  3. شناسه فهرستگان دارایی LOCATION پیوندشده باید با campaign.pmax_campaign_settings.local_services_pmax_campaign_settings.listing_id (AssetSetLinkError.LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID) مطابقت داشته باشد.

AssetGroup (ایجاد)

گروه دارایی «خدمات محلی» را پیکربندی کنید. برخلاف پویش‌های «عملکرد بیشینه» استاندارد، گروه‌های دارایی «عملکرد بیشینه» خدمات محلی به منابع AssetGroupAsset (عنوان‌ها، شرح‌ها، یا تصاویر) یا final_urls نیاز ندارند.

  • ‫name: نام الزامی برای گروه دارایی.
  • ‫campaign: نام منبع موقت Campaign ایجادشده در همان درخواست.
  • ‫status: باید هنگام ایجاد روی ENABLED تنظیم شود.
  • google_local_services_info.category_id: شناسه دسته استانداردشده (مانند xcat:service_area_business_plumber). مشخص کردن دسته پشتیبانی‌نشده AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY را برمی‌گرداند.
  • اختیاری: google_local_services_info.callouts: پیام تکراری LocalServicesCallout (حداکثر ۶ عبارت توضیحی برای هر گروه دارایی مجاز است) با callout_id.

AssetGroupSignal (ایجاد)

برخلاف پویش‌های «عملکرد بیشینه» استاندارد که در آن‌ها سیگنال‌ها اختیاری هستند، پویش‌های «عملکرد بیشینه» «خدمات محلی» به حداقل یک local_services_id AssetGroupSignal برای هر گروه دارایی نیاز دارند (برداشتن همه سیگنال‌ها AssetGroupSignalError.CANNOT_REMOVE_ALL_SIGNALS را برمی‌گرداند).

local_services_id یک پیام LocalServiceIdInfo است که در آن local_services_id.service_id را با شناسه نوع کار معتبر (برای مثال، {"local_services_id": {"service_id": "install_faucet"}}) پر می‌کنید. منابع AssetGroupSignal تغییرناپذیر هستند (فقط CREATE و REMOVE؛ بدون UPDATE).

نمونه درخواست تغییر اتمی

نمونه REST JSON زیر نشان می‌دهد که چگونه می‌توان همه عملیات را در یک درخواست POST /v26/customers/{customer_id}/googleAds:mutate بااستفاده از نام‌های موقت منابع دسته‌بندی کرد:

{
  "mutateOperations": [
    {
      "campaignBudgetOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/campaignBudgets/-1",
          "name": "Local Services PMax Budget",
          "amountMicros": "50000000",
          "deliveryMethod": "STANDARD",
          "explicitlyShared": false
        }
      }
    },
    {
      "campaignOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/campaigns/-2",
          "name": "Local Services PMax Campaign",
          "advertisingChannelType": "PERFORMANCE_MAX",
          "status": "PAUSED",
          "campaignBudget": "customers/{customer_id}/campaignBudgets/-1",
          "brandGuidelinesEnabled": false,
          "maximizeConversions": {},
          "pmaxCampaignSettings": {
            "localServicesEnabled": true,
            "localServicesPmaxCampaignSettings": {
              "countryCode": "US",
              "listingId": "123456789",
              "phoneNumbers": [
                {
                  "phoneNumber": "+18005550100",
                  "countryCode": "US",
                  "phoneNumberType": "DESTINATION_PHONE_NUMBER_FOR_ADS"
                }
              ],
              "foundingYear": "1998",
              "navigationalQueryLeadsEnabled": true
            }
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "language": {
            "languageConstant": "languageConstants/1000"
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "location": {
            "geoTargetConstant": "geoTargetConstants/1014221"
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "adSchedule": {
            "dayOfWeek": "MONDAY",
            "startHour": 9,
            "startMinute": "ZERO",
            "endHour": 17,
            "endMinute": "ZERO"
          }
        }
      }
    },
    {
      "assetSetOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/assetSets/-3",
          "name": "Local Services Location Group",
          "type": "STATIC_LOCATION_GROUP",
          "locationGroupParentAssetSetId": "LOCATION_SYNC_ASSET_SET_ID"
        }
      }
    },
    {
      "assetSetAssetOperation": {
        "create": {
          "assetSet": "customers/{customer_id}/assetSets/-3",
          "asset": "customers/{customer_id}/assets/LOCATION_ASSET_ID"
        }
      }
    },
    {
      "campaignAssetSetOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "assetSet": "customers/{customer_id}/assetSets/-3"
        }
      }
    },
    {
      "assetGroupOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/assetGroups/-4",
          "campaign": "customers/{customer_id}/campaigns/-2",
          "name": "Local Services Plumbing Asset Group",
          "status": "ENABLED",
          "googleLocalServicesInfo": {
            "categoryId": "xcat:service_area_business_plumber",
            "callouts": [
              {
                "calloutId": "family_owned"
              }
            ]
          }
        }
      }
    },
    {
      "assetGroupSignalOperation": {
        "create": {
          "assetGroup": "customers/{customer_id}/assetGroups/-4",
          "localServicesId": {
            "serviceId": "install_faucet"
          }
        }
      }
    }
  ]
}

تأمین هدف تبدیل خودکار

اهداف تبدیل به‌طور خودکار توسط باطن براساس واجدشرایط بودن حساب و شریک تأمین و مدیریت می‌شوند؛ لازم نیست درطول ایجاد اولیه کمپین اتمی، عملیات هدف تبدیل را ارسال کنید.

کمپین‌های «خدمات محلی» اکیداً به دسته‌های تبدیل به مشتری بالقوه «خدمات محلی» پشتیبانی‌شده محدود می‌شوند. تلاش برای پیکربندی اهداف دیگر CampaignConversionGoalError.GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN را برمی‌گرداند. علاوه‌براین، پویش‌های «خدمات محلی» به اهداف لغو در سطح پویش نیاز دارند؛ غیرفعال کردن اهداف لغو، ConversionGoalCampaignConfigError.CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN را برمی‌گرداند.

  • پویش‌های بدون کوپن:
    • PHONE_CALL_LEAD (LOCAL_SERVICES_ADS): به‌طور خودکار به‌عنوان هدف قابل پیشنهاد دادن فعال پیش‌فرض (biddable = true) در زمان ایجاد پویش پیوند داده شده است. این هدف الزامی است و نمی‌تواند روی biddable = false تنظیم شود (انجام این کار CampaignConversionGoalError.CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN را برمی‌گرداند).
    • MESSAGE_LEAD (LOCAL_SERVICES_ADS): به‌طور خودکار در سطح حساب ازپیش ایجاد شده است تا کنش تبدیل وجود داشته باشد، اما به‌طور پیش‌فرض در سطح کمپین روی biddable = false تنظیم شده است (به‌طور پیش‌فرض غیرفعال است). برای موافقت کردن با ارسال پیام به مشتریان بالقوه (در زمان ایجاد یا بعداز آن)، هدف تبدیل پویش customers/{customer_id}/campaignConversionGoals/{campaign_id}~MESSAGE_LEAD~LOCAL_SERVICES_ADS را بااستفاده از CampaignConversionGoalOperation به biddable = true به‌روز کنید.
    • BOOK_APPOINTMENT (LOCAL_SERVICES_ADS): پس‌از شناسایی شریک تأییدشده «رزرو با Google» در مکان پیوندشده، به‌صورت ناهمگام در پایین‌دست (biddable = true) تأمین و پیوند داده می‌شود.
  • پویش‌های شریک کوپن POS (‏Clover،‏ Lightspeed،‏ Express Oil):
    • CONVERTED_LEAD (LOCAL_SERVICES_ADS): به‌طور خودکار به‌عنوان هدف قابل‌قیمت‌گذاری فعال هنگام ایجاد پیوند داده شد (تبدیل به احسن کردن تبلیغ آفلاین). پویش‌های شریک کوپن منحصراً برای CONVERTED_LEAD بهینه‌سازی می‌شوند و نمی‌توانند از اهداف مشتریان بالقوه تلفنی یا پیامی استفاده کنند.

پویش را فعال کنید و درستی‌سنجی کسب‌وکار را تکمیل کنید

  1. فعال کردن پویش: وضعیت پویش را از PAUSED به ENABLED به‌روز کنید بااستفاده از CampaignService.MutateCampaigns.
  2. تکمیل درستی‌سنجی «اعتماد و ایمنی»: ثبت کسب‌وکار، درستی‌سنجی هویت، پروانه‌ها، و ارسال اسناد را ازطریق واسط کاربری Google Ads (سرپرست > خط‌مشی) تکمیل کنید. پس‌از تأیید درستی‌سنجی، ارائه آگهی‌ها شروع خواهد شد.

مدیریت و گزارش‌دهی پویش‌های «عملکرد بیشینه» با اهداف پرداخت به‌ازای مشتری بالقوه

نمای کلی دردسترس بودن ویژگی API

درحالی‌که API به شرکا امکان می‌دهد تا پویش‌ها را در مقیاس بزرگ مدیریت کنند، از آن به‌عنوان مکمل واسط کاربر Google Ads برای انجام مدیریت کامل حساب و پویش استفاده می‌شود. پشتیبانی کامل از میانای برنامه‌سازی کاربردی برای سفرهای منتخب ارائه می‌شود، درحالی‌که مدیریت واسط کاربر برای دیگران الزامی است:

ویژگی سطح و دردسترس بودن جزئیات
ایجاد حساب و پویش پشتیبانی کامل از میانای برنامه‌سازی کاربردی تا GoogleAdsService.Mutate پشتیبانی می‌شود.
تنظیمات پویش پشتیبانی کامل از میانای برنامه‌سازی کاربردی تا CampaignService.MutateCampaigns پشتیبانی می‌شود.
مدیریت دارایی‌ها پشتیبانی جزئی از میانای برنامه‌سازی کاربردی تصاویر بارگذاری‌شده توسط تبلیغ‌کننده ویژگی‌ای است که فقط در واسط کاربر دردسترس است.
گزارش‌دهی خط‌مشی دارایی پشتیبانی کامل از میانای برنامه‌سازی کاربردی وضعیت‌های خط‌مشی را ازطریق asset_group_asset پُرسمان کنید.
مدیریت و گزارش‌دهی مشتریان بالقوه پشتیبانی کامل از میانای برنامه‌سازی کاربردی پرس‌وجو از مشتریان بالقوه ازطریق local_services_lead و مکالمه‌ها ازطریق local_services_lead_conversation. local_services_lead.campaign سوابق مشتریان بالقوه را به پویش «عملکرد بیشینه» در «خدمات محلی» پیوند می‌دهد.
تأییدیه‌ها فقط واسط کاربر تکمیل تکالیف درستی‌سنجی و مشاهده وضعیت‌های درستی‌سنجی فقط ازطریق واسط کاربر (سرپرست > خط‌مشی) امکان‌پذیر است.
بودجه و پیشنهاد قیمت پشتیبانی کامل از میانای برنامه‌سازی کاربردی از MAXIMIZE_CONVERSIONS با target_cpa_micros اختیاری پشتیبانی می‌کند.
مدیریت مکان پشتیبانی کامل از میانای برنامه‌سازی کاربردی ازطریق مجموعه‌های دارایی STATIC_LOCATION_GROUP پشتیبانی می‌شود.
صورت‌حساب و شرایط فقط واسط کاربر تنظیمات صورت‌حساب و «شرایط محصول خدمات محلی» باید در میانای کاربری Google Ads (تنظیمات حساب) تکمیل شود.

جزئیات فیلد داده

جدول زیر منابع، فیلدها، و قابلیت‌های دردسترس برای پویش‌های «بیشینه‌سازی عملکرد خدمات محلی» را نشان می‌دهد:

منبع فیلد یا مؤلفه تغییرپذیر است؟ قوانین دسترس‌پذیری و «خدمات محلی»
Campaign name بله نام الزامی برای پویش.
Campaign campaign_budget بله نام منبع CampaignBudget مرتبط با پویش.
Campaign advertising_channel_type فقط ایجاد کردن باید روی PERFORMANCE_MAX تنظیم شود. بعداز ایجاد نمی‌توان آن را تغییر داد.
Campaign pmax_campaign_settings.local_services_enabled فقط ایجاد کردن بولی تغییرناپذیر. باید هنگام ایجاد روی true تنظیم شود تا رفتار و ویژگی‌های «خدمات محلی» فعال شود. پویش‌های «عملکرد بیشینه» استاندارد موجود را نمی‌توان تبدیل کرد.
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.country_code فقط ایجاد کردن کد کشور دوحرفی ISO الزامی است. به‌طور دقیق به‌عنوان 'US' اجرا شد. مقادیر خارج از کشور رد می‌شود.
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.listing_id فقط ایجاد کردن شناسه عددی الزامی فهرستگان «نمایه کسب‌وکار Google» که نشان‌دهنده مکان فیزیکی ارائه‌دهنده است. در زمان ایجاد پویش درمقابل دارایی‌های مکان پیوندشده اعتبارسنجی می‌شود.
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.phone_numbers بله شماره تلفن‌های کسب‌وکار یا ردگیری تماس مرتبط با پویش بااستفاده از LocalServicesPhoneNumber. اگر حذف شود، شماره تماس به‌طور پیش‌فرض شماره تلفن فهرست «نمایه کسب‌وکار Google» پیوندشده خواهد بود و اگر فهرست «نمایه کسب‌وکار» شماره تلفن نداشته باشد، الزامی است. مقادیر GlsPhoneNumberType پشتیبانی‌شده عبارت‌اند از DESTINATION_PHONE_NUMBER_FOR_ADS (برای مشتریان بالقوه تماس) و DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY (اختیاری، برای اعلان‌های پیامکی مشتریان بالقوه پیام).
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.founding_year بله سال تأسیس کسب‌وکار (اختیاری) (مثلاً 1998). نشان اعتماد «از … در کسب‌وکار» را نمایش می‌دهد.
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.navigational_query_leads_enabled بله بولی اختیاری که نشان می‌دهد آیا مشتریان بالقوه از پُرسمان‌های ناوبری که به‌طور خاص نام نمانام کسب‌وکارتان را جستجو می‌کنند دریافت شود یا نه.
Campaign brand_guidelines_enabled فقط ایجاد کردن باید روی false تنظیم شود. برخلاف پویش‌های «بیشینه‌سازی عملکرد» استاندارد، پویش‌های «بیشینه‌سازی عملکرد» «خدمات محلی» از رهنمودهای نمانام یا دارایی‌های نمانام در سطح پویش استفاده نمی‌کنند.
Campaign maximize_conversions بله پیام راهبرد پیشنهاد قیمت الزامی. MAXIMIZE_CONVERSIONS را پیکربندی می‌کند (با target_cpa_micros اختیاری). «برگشت هزینه‌های تبلیغات هدف» و پیشنهاد قیمت دستی پشتیبانی نمی‌شود.
Campaign bidding_strategy_type فقط خواندنی فیلد فقط خروجی در Campaign به‌طور خودکار به‌عنوان MAXIMIZE_CONVERSIONS درج شد.
Campaign status بله وضعیت پویش (PAUSED، ENABLED، REMOVED). توصیه می‌شود تا زمان تکمیل پیکربندی، به‌عنوان PAUSED ایجاد شود.
CampaignBudget amount_micros بله بودجه روزانه پویش در CampaignBudget تعریف شده است.
CampaignBudget delivery_method بله باید روی STANDARD تنظیم شود.
CampaignBudget explicitly_shared فقط ایجاد کردن باید روی false تنظیم شود. پویش‌های «عملکرد بیشینه» نمی‌توانند از بودجه‌های مشترک استفاده کنند.
CampaignConversionGoal biddable بله Guardrailed strictly to Local Services lead conversion categories (PHONE_CALL_LEAD, MESSAGE_LEAD, BOOK_APPOINTMENT, and CONVERTED_LEAD for POS coupon partners; other goals return CampaignConversionGoalError.GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN). For non-coupon campaigns, PHONE_CALL_LEAD is required and cannot be set to biddable = false (CampaignConversionGoalError.CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN). Disabling campaign override goals returns ConversionGoalCampaignConfigError.CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN.
CampaignCriterion هدف‌یابی زبانی (language / LANGUAGE) بله معیار زبان مقصد. برای پویش‌های ایالات متحده، به‌طور دقیق به‌عنوان انگلیسی (languageConstants/1000) اجرا می‌شود. زبان‌های دیگر در زمان تغییر رد می‌شوند.
CampaignCriterion هدف‌یابی مکانی (location / LOCATION) بله هدف‌یابی جغرافیایی زیرملی (شهرها، شهرستان‌ها، مناطق بازاریابی تعیین‌شده، کدهای پستی). معیارها باید داخل کشور اصلی پویش (US) باشد. هدف‌یابی در سطح کشور (هدف‌یابی کل ایالات متحده) رد شده است (CampaignCriterionError.CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN). پویش‌های «عملکرد بیشینه» خدمات محلی باید حداقل یک معیار مکان مثبت داشته باشند (CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN).
CampaignCriterion زمان‌بندی آگهی (ad_schedule / AD_SCHEDULE) بله برنامه زمانی سفارشی شخصی برای ارائه آگهی (day_of_week، زمان شروع/پایان). اگر حذف شود، به‌طور پیش‌فرض ارسال ۲۴/۷ خواهد بود.
AssetSet type = LOCATION_SYNC فقط ایجاد کردن مجموعه دارایی سطح حساب که مکان‌های «نمایه کسب‌وکار Google» را با دارایی‌های LOCATION Google Ads همگام‌سازی می‌کند. type پس‌از ایجاد تغییرناپذیر است.
AssetSet type = STATIC_LOCATION_GROUP فقط ایجاد کردن مجموعه دارایی که دارایی LOCATION همگام‌سازی‌شده خاص را برای هدف‌یابی توسط پویش گروه‌بندی می‌کند. Requires location_group_parent_asset_set_id set to the LOCATION_SYNC asset set ID (type and location_group_parent_asset_set_id are immutable after creation; AssetSetAsset links are CREATE / REMOVE ONLY).
CampaignAssetSet پیوند مجموعه دارایی مکان فقط ایجاد کردن STATIC_LOCATION_GROUP را به پویش پیوند می‌دهد. بازگردانی تراکنشی را اعمال می‌کند: حداکثر یک پیوند گروه مکان (AssetSetLinkError.DUPLICATE_ASSET_SET_LINK)، حداکثر یک دارایی مکان فعال، و شناسه فهرستگان دارایی مکان پیوندشده باید با listing_id پویش (AssetSetLinkError.LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID) مطابقت داشته باشد. پس‌از ایجاد، این پیوند را نمی‌توان برداشت (AssetSetLinkError.ASSET_SET_LINK_CANNOT_BE_REMOVED).
AssetGroup name بله نام الزامی برای گروه دارایی.
AssetGroup campaign فقط ایجاد کردن نام منبع Campaign مرتبط با گروه دارایی.
AssetGroup status بله وضعیت گروه دارایی. باید هنگام ایجاد روی ENABLED تنظیم شود.
AssetGroup google_local_services_info.category_id فقط ایجاد کردن شناسه دسته استانداردشده (برای مثال، xcat:service_area_business_plumber). پس‌از ایجاد تغییرناپذیر است. دربرابر فهرست مجازهای عمودی پشتیبانی‌شده (AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY) اعتبارسنجی شد.
AssetGroup google_local_services_info.callouts بله برچسب‌های استانداردشده برای اعلامیه‌های کسب‌وکار بااستفاده از LocalServicesCallout تکراری با callout_id. حداکثر ۶ عبارت توضیحی برای هر گروه دارایی مجاز است. باید با نوشته‌های راهنمای عمودی مجاز مطابقت داشته باشد.
AssetGroupSignal local_services_id.service_id فقط ایجاد / برداشتن بااستفاده از LocalServiceIdInfo، نشان‌های موضوع جستجو را که نشان‌دهنده خدمات ارائه‌شده جزئی در دسته است جستجو کنید. حداقل یک سیگنال برای هر گروه دارایی لازم است (AssetGroupSignalError.CANNOT_REMOVE_ALL_SIGNALS).
LocalServicesLead فراداده‌ها و سوابق مشتریان بالقوه فقط خواندنی داده‌های مشتری بالقوه قابل‌پرسمان که ارائه‌دهنده دریافت کرده است، ازجمله نوع مشتری بالقوه، وضعیت هزینه، وضعیت اعتبار، مُهر زمان ایجاد، و local_services_lead.campaign پیوند دادن مشتریان بالقوه به پویش.
LocalServicesLeadConversation جزئیات و صداهای ضبط‌شده مکالمه فقط خواندنی سوابق ارتباطی قابل‌جستجو مرتبط با مشتریان بالقوه (مدت تماس، نشانی‌های وب ضبط، نوشتار پیام).

پرسشگان

پویش‌های «بیشینه‌سازی عملکرد» برای پرداخت به‌ازای مشتری بالقوه در چه کشورهایی دردسترس است؟

فقط ایالات متحده (US) پشتیبانی می‌شود.

چگونه شناسه فهرستگان «نمایه کسب‌وکار Google» را پیدا کنم؟

می‌توانید شناسه فهرستگان خود را در میانای «نمایه کسب‌وکار Google» یا به‌صورت برنامه‌نویسی‌شده با پرسمان دارایی‌های LOCATION بااستفاده از «زبان پرسمان Google Ads» پیدا کنید. برای دستورالعمل‌های دقیق و نمونه‌های پُرسمان، به بازیابی دارایی مکان و فهرستگان «نمایه کسب‌وکار Google» مراجعه کنید.

چگونه مشتریان بالقوه کوپن را فعال کنم؟

مشتریان بالقوه کوپن فقط برای شرکای منتخب پایانه فروش آزمایشی (Clover،‏ Lightspeed،‏ Express Oil) دردسترس است. اگر مایلید اطلاعات بیشتری کسب کنید، با نماینده Google تماس بگیرید.

آیا مشتریان بالقوه پیام به‌طور پیش‌فرض فعال یا غیرفعال هستند؟

PHONE_CALL_LEAD (LOCAL_SERVICES_ADS) به‌طور پیش‌فرض فعال است. ‫MESSAGE_LEAD (LOCAL_SERVICES_ADS) با biddable = false ایجاد شده است (به‌طور پیش‌فرض انصراف داده شده است). برای موافقت با مشتریان بالقوه پیام، هدف تبدیل پویش را به biddable = true به‌روز کنید. برای جزئیات بیشتر، تأمین هدف تبدیل خودکارسازی‌شده را ببینید.