ローカル サービス キャンペーン

ローカル サービス キャンペーンでは、Google に広告を掲載して見込み顧客から直接セールスリード（見込み顧客からの接触）を獲得できます。このガイドでは、Google Ads API でサポートされているオペレーションと制限事項について説明します。

サポートされているオペレーション

Google Ads API は、ローカル サービス キャンペーンで次のオペレーションをサポートしています。

ローカル サービス キャンペーンと予算を取得する

ローカル サービス キャンペーンと予算を取得するには、GoogleAdsService.Search または GoogleAdsService.SearchStream メソッドを使用して、advertising_channel_type = 'LOCAL_SERVICES' の Campaign リソースをクエリします。以下に例を示します。

SELECT
  campaign.id,
  campaign.status,
  campaign_budget.id,
  campaign_budget.period,
  campaign_budget.amount_micros,
  campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

注: v24 以降、許可リストに登録されているアカウントは、UI で作成された既存のローカル サービス P-MAX キャンペーン（advertising_channel_type = 'PERFORMANCE_MAX' と campaign.pmax_campaign_settings.local_services_enabled = true）を取得して更新できます。v26 以降、API を使用して新しいローカル サービス P-MAX キャンペーンを作成することもできます。詳しくは、ローカル サービスの P-MAX キャンペーンと P-MAX キャンペーン単位のパフォーマンス ガイドをご覧ください。

ローカル サービス キャンペーンを編集する

キャンペーンの status フィールドと、関連するキャンペーン予算の amount_micros フィールドを更新できます。

入札戦略を設定する

ローカル サービス キャンペーンの標準の入札戦略として、次の入札戦略を設定できます。

• ManualCpa を設定するには、フィールド manual_cpa を設定します。

  入札単価は ManualCpa から LocalServicesCampaignSettings.category_bids の範囲で設定できます。Campaign.local_services_campaign_settings を使用して、ローカル サービス キャンペーンの LocalServicesCampaignSettings を取得および設定できます。

• MaximizeConversions: maximize_conversions フィールドを設定します。

広告のスケジュールをキャンペーン条件として設定する

ローカル サービス キャンペーンの広告のスケジュールは、キャンペーン条件として設定できます。

CampaignCriterionService.MutateCampaignCriteria を使用して、AdScheduleInfo を作成し、Google Ads API に送信される CampaignCriterion の ad_schedule に設定します。

地域ターゲティングを設定する

ローカル サービス キャンペーンで地域ターゲティングを有効にするには、LocationInfo を追加し、CampaignCriterionService.MutateCampaignCriteria を使用して Google Ads API に送信される CampaignCriterion の location フィールドに設定します。詳しくは、地域ターゲティングをご覧ください。

特定のサービスタイプをターゲットにする

特定のサービスタイプをターゲットに設定するには、ローカル サービスのカテゴリ ID のいずれかを使用して LocalServiceIdInfo を作成し、CampaignCriterion の local_service_id フィールドに設定して、CampaignCriterionService.MutateCampaignCriteria を使用して送信します。

キャンペーンのターゲティングの地域とカテゴリに一致するサービス ID を使用する必要があります。

リードに関するフィードバックを送信する

LocalServicesLeadService の ProvideLeadFeedback メソッドを使用して、リードの評価とフィードバックを送信します。LocalServicesLead の lead_feedback_submitted フィールドを調べて、見込み顧客が評価され、フィードバックが送信されたかどうかを判断することもできます。

サポートされていない操作

次の表に、スタンドアロンのローカル サービス キャンペーン（advertising_channel_type = 'LOCAL_SERVICES'）でサポートされていないオペレーションを示します。

サポートされていない操作
キャンペーンを作成、削除する	Google Ads API では、スタンドアロンのローカル サービス キャンペーン（advertising_channel_type = 'LOCAL_SERVICES'）の作成と削除がブロックされます。v26 以降、pmax_campaign_settings.local_services_enabled = true を設定することで、新しいローカル サービス P-MAX キャンペーン（advertising_channel_type = 'PERFORMANCE_MAX'）を作成できます。ローカル サービス P-MAX キャンペーンを作成するをご覧ください。
キャンペーン内のサブエンティティに対するオペレーション	スタンドアロンのローカル サービス キャンペーン（advertising_channel_type = 'LOCAL_SERVICES'）の場合、Google Ads API では、サポートされているオペレーションに記載されているキャンペーン条件以外の広告グループ、広告、条件の作成、変更、削除、取得はサポートされていません。ローカル サービス P-MAX キャンペーンでは、アセット グループとキャンペーン条件を使用します。

ローカル サービスのリソース

ローカル サービス広告の一部のデータは、次の読み取り専用レポート リソースを介して Google Ads API に直接公開されます。

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

これらのリソースからデータが返されるようにするには、リクエストを行うクライアント アカウントにローカル サービス キャンペーンが存在する必要があります。クライアント アカウントごとに設定できるローカル サービス キャンペーンは 1 つのみであるため、これらのリソースではキャンペーンを指定しません。これらのリソースが関連付けられているキャンペーンを特定するには、次のクエリを使用します。

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

ローカル サービスのリード

LocalServicesLead は、消費者が広告主のサービスに電話、メッセージ、予約を行ったときに生成される見込み顧客の詳細を公開します。

ローカル サービスのリードデータは、local_services_lead リソースから取得できます。クエリの例を以下に示します。

SELECT
  local_services_lead.lead_type,
  local_services_lead.category_id,
  local_services_lead.service_id,
  local_services_lead.contact_details,
  local_services_lead.lead_status,
  local_services_lead.creation_date_time,
  local_services_lead.locale,
  local_services_lead.lead_charged,
  local_services_lead.credit_details.credit_state,
  local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead

制限事項

• lead_status が WIPED_OUT と等しい場合、contact_details フィールドは null です。
• v25 以降、ContactDetails.email は削除され、local_services_lead.contact_details から返される ContactDetails メッセージで ContactDetails.phone_number_extension を使用できるようになります。
• category_id が医療カテゴリの一部である見込み顧客のデータは利用できません。

ローカル サービスの見込み顧客との会話

LocalServicesLeadConversation は、LocalServicesLead の一部として行われた会話の詳細を公開します。LocalServicesLead とは 1 対多の関係があり、1 つの見込み顧客が複数の会話を持つことができます。関連する見込み顧客のリソース名は、lead フィールドで確認できます。

会話データは local_services_lead_conversation リソースから取得できます。通話の結果をフィルタするクエリの例を次に示します。

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.conversation_channel,
  local_services_lead_conversation.participant_type,
  local_services_lead_conversation.lead,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.phone_call_details.call_duration_millis,
  local_services_lead_conversation.phone_call_details.call_recording_url,
  local_services_lead_conversation.message_details.text,
  local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

LocalServicesLeadService.AppendLeadConversation メソッドを使用して、LocalServicesLeadConversation リソースを LocalServicesLead に追加できます。

制限事項

• 通話録音の URL にアクセスするには、見込み顧客が関連付けられているキャンペーンを所有する Google 広告クライアント アカウントへの読み取り専用権限以上の権限を持つメールアドレスでログインする必要があります。

• すべての会話を一度にリクエストすると、時間がかかる可能性があるため、会話をリードでフィルタする必要があります。

  SELECT
    local_services_lead_conversation.id,
    local_services_lead_conversation.event_date_time,
    local_services_lead_conversation.message_details.text
  FROM local_services_lead_conversation
  WHERE local_services_lead_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'
  

検証アーティファクト

LocalServicesVerificationArtifact は、広告主のビジネスの認証データを公開します。これらの確認はビジネスレベルで行われ、従業員の確認は含まれません。データには次のものが含まれます。

• ライセンスの確認
• 保険の確認
• バックグラウンド チェックの確認
• 事業登録の確認

ローカル サービス広告に確認リクエストが送信されるたびに、Google Ads API で新しい確認アーティファクト インスタンスが作成されます。各確認アーティファクトは、1 つの確認リクエストを表します。各検証アーティファクトには、検証リクエストのタイプに応じて、次の情報の一部が含まれる場合があります。

• 各検証アーティファクトのステータス
• バックグラウンド チェックの確認に使用されるバックグラウンド チェック URL
• バックグラウンド チェックの審査時間（該当する場合）
• すでに送信済みの保険情報を表示するための保険証券の URL
• 保険の不承認の理由（該当する場合）
• ライセンスの詳細（種類、番号、名前、苗字）
• ライセンスが不承認となった理由（該当する場合）
• すでに提出されているライセンス画像を表示するためのライセンス ドキュメントの URL（該当する場合）
• 事業登録の詳細（ID、登録番号を確認）
• 事業登録が不承認となった理由（該当する場合）
• すでに提出されている登録画像を表示するためのビジネス登録書類の URL（該当する場合）

検証アーティファクト データは、local_services_verification_artifact リソースから取得できます。特定のクライアント アカウントのライセンス関連の検証アーティファクトのデータをすべて取得するクエリの例を次に示します。

SELECT
  local_services_verification_artifact.id,
  local_services_verification_artifact.creation_date_time,
  local_services_verification_artifact.status,
  local_services_verification_artifact.artifact_type,
  local_services_verification_artifact.license_verification_artifact.license_type,
  local_services_verification_artifact.license_verification_artifact.license_number,
  local_services_verification_artifact.license_verification_artifact.licensee_first_name,
  local_services_verification_artifact.license_verification_artifact.licensee_last_name,
  local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'

地域とカテゴリの確認データ

地域（具体的には地域ターゲット コード）とローカル サービス カテゴリ ID で適格性確認リクエストのステータスをプログラムで確認するには、customer リソースの local_services_settings フィールド（型は LocalServicesSettings）を使用します。

このフィールドには、地域とカテゴリ別のライセンスと保険の確認リクエストのステータスの概要が表示されます。このようなデータをすべて取得するクエリの例を次に示します。

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

ローカル サービスの従業員

LocalServicesEmployee は、広告主が広告プロファイルを Google のシステムにアップロードしたローカル サービス従業員に関するデータを公開します。

特定のクライアント アカウントのすべてのローカル サービス従業員のデータを取得するクエリの例を次に示します。

SELECT
  local_services_employee.status,
  local_services_employee.type,
  local_services_employee.university_degrees,
  local_services_employee.residencies,
  local_services_employee.fellowships,
  local_services_employee.job_title,
  local_services_employee.year_started_practicing,
  local_services_employee.languages_spoken,
  local_services_employee.first_name,
  local_services_employee.middle_name,
  local_services_employee.last_name
FROM local_services_employee

ローカル サービス P-MAX キャンペーン

P-MAX キャンペーンでは、v24 以降、ローカル サービス関連の設定がサポートされます。これらの設定を使用すると、ローカル サービス広告（GLS P-MAX）を配信する P-MAX キャンペーンを構成して識別できます。

ローカル サービス P-MAX キャンペーンを作成する

v26 以降、API を介して新しいローカル サービス P-MAX キャンペーンを作成するには、P-MAX キャンペーン（advertising_channel_type = 'PERFORMANCE_MAX'）を作成し、pmax_campaign_settings で local_services_enabled = true を設定します（作成後は変更できません）。ローカル サービスの P-MAX キャンペーンを作成する場合は、local_services_pmax_campaign_settings に country_code と listing_id の両方が必要です。

v24 と v25 では、API は、許可リストに登録されているアカウントによって UI で作成された既存のローカル サービス P-MAX キャンペーンの更新のみをサポートしています。

ローカル サービス P-MAX キャンペーンを特定する

P-MAX キャンペーンがローカル サービス キャンペーンかどうかを識別するには、キャンペーンの pmax_campaign_settings の local_services_enabled フィールドを確認します。

構成の設定

local_services_enabled が true のキャンペーンでは、local_services_pmax_campaign_settings フィールドで設定を構成します。

• listing_id: キャンペーンにリンクされている Google ビジネス プロフィールのリスティング ID。v26 以降、このフィールドは、ローカル サービス P-MAX キャンペーンの作成時に必須となり、変更できなくなります。リスティング ID は、有効な LOCATION アセットとしてアカウントにリンクする必要があります。そうしないと、API は CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID エラーを返します。listing_id は IMMUTABLE とマークされているため、キャンペーンの作成後にこのフィールドを更新しようとすると、RequestError.IMMUTABLE_FIELD で失敗します。デベロッパーは、有効な LOCATION アセットの Asset リソースをクエリすることで、リンクされたリスティング ID を検出または確認できます（location_asset.business_profile_locations を検査します）。詳しくは、住所アセットをご覧ください。
• navigational_query_leads_enabled: ナビゲーション クエリ フィルタを使用するかどうか。
• founding_year: ビジネスの設立年。
• country_code: ローカル サービス広告の国コード。このフィールドは不変であり、広告の作成時に 1 回設定されます。これは、大文字の 2 文字の国コードです。確認要件の決定と、地域条件の選択の検証に使用されます。
• phone_numbers: プロバイダに関連付けられた電話番号のリスト。LocalServicesPhoneNumber メッセージで表されます。

電話番号

phone_numbers 繰り返しフィールドの各エントリは、次のフィールドを含む LocalServicesPhoneNumber メッセージ タイプを使用します。

• phone_number: 電話番号。
• country_code: 大文字の 2 文字の国コード。
• phone_number_type: 電話番号のタイプ。GlsPhoneNumberTypeEnum.GlsPhoneNumberType で定義されます。サポートされているタイプは次のとおりです。
  • DESTINATION_PHONE_NUMBER_FOR_ADS: ローカル サービス広告ユニットからの通話に使用する転送先番号（デフォルト）。
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: SMS をサポートする宛先番号。
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: プロバイダの WhatsApp アカウントの宛先番号。