ローカル サービス キャンペーンでは、Google に広告を掲載して見込み顧客から直接セールスリードを獲得できます。このガイドでは、現在のバージョンの 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 フィールドを更新できます。
ローカル サービス キャンペーンの入札戦略を設定する
ローカル サービス キャンペーンの標準の入札戦略として、次の入札戦略を設定できます。
manual_cpaフィールドを設定してManualCpaManualCpaの入札単価は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 に設定します。詳しくは、地域ターゲティングをご覧ください。
特定のサービスタイプをターゲットにする
特定のサービスタイプのターゲティングを有効にするには、LocalServiceIdInfo を追加して、サービスタイプに設定します。
キャンペーンのターゲティングの地域とカテゴリに一致するサービス 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 です。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.id = 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 リソースの新しいフィールド（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.2 以降、ローカル サービス関連の設定がサポートされます。これらの設定を使用すると、ローカル サービス広告（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 アカウントの宛先番号。