ローカル サービス キャンペーンでは、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を設定する
広告のスケジュールをキャンペーン条件として設定する
ローカル サービス キャンペーンの広告スケジュールは、キャンペーン条件として設定できます。
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 フィールドを調べると、セールスリードが評価され、フィードバックが送信されたかどうかを確認できます。
サポートされていない操作
次の表に記載されている制限は、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 よりローカル サービス関連の設定がサポートされます。これらの設定を使用すると、ローカル サービス広告（GLS P-MAX）を配信する P-MAX キャンペーンを構成して識別できます。
ローカル サービス P-MAX キャンペーンを特定する
P-MAX キャンペーンがローカル サービス キャンペーンかどうかを確認するには、キャンペーンの pmax_campaign_settings で読み取り専用の local_services_enabled フィールドを確認します。
構成の設定
local_services_enabled が true のキャンペーンでは、local_services_pmax_campaign_settings フィールドで設定を構成します。
navigational_query_leads_enabled: ナビゲーション クエリ フィルタを使用するかどうか。founding_year: ビジネスの設立年。country_code: ローカル サービス広告の国コード。このフィールドは不変であり、広告の作成時に一度設定されます。大文字の 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 アカウントの宛先番号。