ローカル サービス キャンペーンを利用すると、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
で設定できます。Campaign.local_services_campaign_settings
を使用して、ローカル サービス キャンペーンのLocalServicesCampaignSettings
を取得して設定できます。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 により、新しいローカル サービス キャンペーンの作成がブロックされます。 |
キャンペーンのサブエンティティに対するオペレーション | 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 つのクライアント アカウントにつき 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'
制限事項
- 通話の録音の 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