ローカル サービス キャンペーンでは、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'
ローカル サービス キャンペーンを編集する
キャンペーンの status フィールドと、関連付けられたキャンペーンの予算の amount_micros フィールドを更新できます。
入札戦略を設定する
ローカル サービス キャンペーンの標準の入札戦略として、次の入札戦略を設定できます。
ManualCpa。manual_cpaフィールドを設定します。ManualCpaの入札単価はLocalServicesCampaignSettings.category_bidsで設定できます。Campaign.local_services_campaign_settingsを使用して、ローカル サービス キャンペーンのLocalServicesCampaignSettingsを取得および設定できます。MaximizeConversionsフィールドmaximize_conversionsを設定する
広告のスケジュールをキャンペーン条件として設定する
ローカル サービス キャンペーンの広告のスケジュールをキャンペーン条件として設定できます。
AdScheduleInfo を作成し、CampaignCriterionService.MutateCampaignCriteria を使用して、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 フィールドを調べて、見込み顧客が評価され、フィードバックが送信されたかどうかを判断することもできます。
サポートされていない操作
次の表に記載されている制限は、Google Ads API の今後のバージョンで変更される可能性があります。
| サポートされていない操作 | |
|---|---|
| キャンペーンを作成、削除する | Google Ads API で新しいローカル サービス キャンペーンを作成できなくなります。 |
| キャンペーン内のサブエンティティに対するオペレーション | Google Ads API では、ローカル サービス キャンペーンの広告グループ、広告、条件の作成、変更、削除、取得はサポートされていません。 |
ローカル サービスのリソース
ローカル サービス広告の一部のデータは、次の読み取り専用レポート リソースを通じて Google Ads API で直接公開されます。
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_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 よりローカル サービス関連の設定がサポートされます。これらの設定を使用すると、ローカル サービス広告を配信する P-MAX キャンペーン（GLS P-MAX）を構成して識別できます。
v26 以降、pmax_campaign_settings（作成後は変更不可）で local_services_enabled = true を設定することで、API を介して新しいローカル サービス P-MAX キャンペーンを作成できます。ローカル サービスの P-MAX キャンペーンを作成する場合、local_services_pmax_campaign_settings に country_code と listing_id の両方が必要です。v25 以前では、API は、許可リストに登録されているユーザーが UI で作成した既存のキャンペーンの更新のみをサポートしていました。
ローカル サービスの 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 アカウントの宛先番号。