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

ローカル サービス キャンペーンでは、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 フィールドを更新できます。

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

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

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

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

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 で直接公開されます。

これらのリソースがデータを返すには、リクエストを行うクライアント アカウントにローカル サービス キャンペーンが必要です。クライアント アカウントごとにローカル サービス キャンペーンは 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 で新しい検証アーティファクト インスタンスが作成されます。各検証アーティファクトは、単一の検証リクエストを表します。各検証アーティファクトには、検証リクエストのタイプに応じて、次の情報の一部が含まれている場合があります。

  • 各検証アーティファクトのステータス
  • バックグラウンド チェックの確認に使用されるバックグラウンド チェックの 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