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

ローカル サービス キャンペーンを使用すると、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 広告 API の今後のバージョンで変更される可能性があります。

サポートされていない操作
キャンペーンを作成、削除する	Google Ads API で、新しいローカル サービス キャンペーンの作成がブロックされる。
キャンペーンのサブエンティティに対するオペレーション	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