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

ローカル サービス キャンペーンを使用すると、Google でビジネスを宣伝して、見込み顧客から直接見込み顧客を獲得できます。このガイドでは、現行バージョンの Google Ads API でサポートされているオペレーションと制限事項についてまとめています。

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

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

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

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 フィールドは更新できます。

ローカル サービス キャンペーンの入札戦略を設定する

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

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

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

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

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

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

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

特定のサービスタイプのターゲティングを有効にするには、LocalServiceIdInfo を追加し、それをサービスのタイプに設定します。

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

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

次の表に示す制限は、Google Ads API の今後のバージョンで変更される可能性があります。

サポートされていないオペレーション
キャンペーンを作成、削除する Google Ads API により、新しいローカル サービス キャンペーンの作成がブロックされます。
キャンペーンのサブエンティティに対するオペレーション Google Ads API は、ローカル サービス キャンペーンの広告グループ、広告、条件の作成、変更、削除、取得をサポートしていません。

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

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

これらのリソースがデータを返すには、リクエストを行うクライアント アカウントにローカル サービス キャンペーンが含まれている必要があります。また、ローカル サービス キャンペーンはクライアント アカウントごとに 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'

Google Ads API バージョン 17 以降では、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 リソースの新しいフィールド（LocalServicesSetting）を使用します。

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

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