ローカル サービス キャンペーンを使用すると、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
フィールドは更新できます。
ローカル サービス キャンペーンの入札戦略を設定する
ローカル サービス キャンペーンの標準入札戦略として、次の入札戦略を設定できます。
フィールド
manual_cpa
を設定してManualCpa
ManualCpa
~LocalServicesCampaignSettings.category_bids
の入札単価を設定できます。ローカル サービス キャンペーンのLocalServicesCampaignSettings
は、Campaign.local_services_campaign_settings
で取得および設定できます。MaximizeConversions
(maximize_conversions
フィールドを設定する)
広告のスケジュールをキャンペーンの条件として設定する
ローカル サービス キャンペーンの広告のスケジュールは、キャンペーンの条件として設定できます。
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 で次の読み取り専用のレポート リソースを介して直接公開されます。
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 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