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

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

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

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

• ManualCpa（フィールド manual_cpa を設定）

  ManualCpa の入札単価は LocalServicesCampaignSettings.category_bids で設定できます。ローカル サービス キャンペーンの LocalServicesCampaignSettings は、Campaign.local_services_campaign_settings で取得および設定できます。

• MaximizeConversions（フィールド maximize_conversions を設定）

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

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

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

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

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

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

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

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

サポートされていない操作

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

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

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

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_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'

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 広告 API で新しい検証アーティファクト インスタンスが作成されます。各検証アーティファクトは 1 件の検証リクエストを表します。各検証アーティファクトには、そのアーティファクトが表す検証リクエストの種類に応じて、次のような情報が含まれます。

• 各検証アーティファクトのステータス
• バックグラウンド チェックの確認に使用するバックグラウンド チェックの URL
• バックグラウンド チェックの審査時間（該当する場合）
• すでに送信された保険情報を表示するための保険証券の URL
• 保険が不承認となった理由（該当する場合）
• ライセンスの詳細（種類、番号、氏名）
• ライセンス不承認の理由（該当する場合）
• 提出済みのライセンス画像を表示するためのライセンス書類の URL（該当する場合）
• ビジネス登録の詳細（身分証明書、登録番号）
• 事業登録を不承認とする理由（該当する場合）
• すでに提出済みの登録画像を表示するための事業登録書類の 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