レポート

レポート機能を使用すると、リンクされたアカウントの広告のパフォーマンスと見込み顧客に関する情報を取得できます。

アカウント レポート

アカウント レポートには、MCC アカウントのリンクされたローカル サービス アカウントに関連付けられているパフォーマンスと指標が表示されます。このデータは、指定した期間で確認できます。データが最大で 30 分ほど古い可能性があります。

レポートを取得するには、次の構成可能な URL パラメータを指定して、https://localservices.googleapis.com/v1/accountReports:search に HTTP GET リクエストを送信します。

URL パラメータ
query

必須

1 つ以上の ID 値が含まれます。そのうちの 1 つは、クエリのクライアント センター（MCC）アカウントの ID である必要があります。query は、セミコロンで区切られた複数の値を受け入れることができます。

  • 必須: manager_customer_id:<manager_cid>
  • 省略可: customer_id:<linked_cid>

例: query=manager_customer_id:123;customer_id:456
startDate.day

省略可

レポート期間の開始日。1～31 の範囲の値を取ることができます。デフォルトは 1 です。
startDate.month

省略可

レポート期間の開始月。1～12 の値をとることができます。デフォルトは当月です。
startDate.year

省略可

レポート期間の開始年。YYYY 形式で指定します。デフォルトは現在の年です。
endDate.day

省略可

レポート期間の終了日。1～31 の値をとることができます。デフォルトは当日です。
endDate.month

省略可

レポート期間の終了月。1～12 の値をとることができます。デフォルトは当月です。
endDate.year

省略可

レポート期間が終了する年（YYYY 形式）。デフォルトは現在の年です。
pageSize

省略可

返されるエントリの数を示す正の整数。デフォルトは 1000 で、最大値は 10000 です。
pageToken

省略可

文字列。このフィールドに、前のレスポンスの next_page_token を入力します。

前の表のフィールドは、SearchAccountReportsRequest の作成に使用されます。リクエスト内の各お客様 ID について、対応する AccountReports が SearchAccountReportsResponse に含まれます。各アカウント レポートは、ローカル サービス広告を表示するリンクされたお客様アカウントと 1 対 1 でマッピングされます。

次の表に、AccountReports のフィールドを示します。

フィールド
accountId ローカル サービス アカウントにリンクされたお客様 ID。
businessName お客様の会社名。
averageWeeklyBudget お客様の現在の 1 週間の平均予算。
averageFiveStarRating 平均 5 つ星評価。お客様の利用可能なすべてのレビューから計算されます。
totalReview お客様が利用できるレビューの合計数。
impressionsLastTwoDays 過去 2 日間にアカウントで発生したインプレッションの合計数。
phoneLeadResponsiveness 過去 90 日間のアカウントの電話リードの応答性。この値を計算するには、有料の電話リードからの接続された通話の合計数を、受信した通話の合計数で割ります。
currentPeriodChargedLeads 指定した期間内の有料見込み顧客の数。
previousPeriodChargedLeads 前の期間に課金された見込み顧客の数。たとえば、期間が 1 月 21 日から 1 月 30 日に設定されている場合、前の期間は 1 月 11 日から 1 月 20 日になります。
currentPeriodTotalCost 指定した期間の有料見込み顧客の費用の合計。
previousPeriodTotalCost 前回の期間に請求された見込み顧客の費用の合計。たとえば、期間が 1 月 21 日から 1 月 30 日に設定されている場合、前の期間は 1 月 11 日から 1 月 20 日になります。
currencyCode お客様のアカウントの通貨コード。
currentPeriodPhoneCalls 指定した期間内の通話の数（接続された通話と接続されなかった通話の両方）。
previousPeriodPhoneCalls 前の期間の通話数（接続された通話と接続されなかった通話の両方）。
currentPeriodConnectedPhoneCalls 指定した期間内に 30 秒を超えて接続された通話の数。
previousPeriodConnectedPhoneCalls 前回の期間に 30 秒を超えて接続された通話の数。

例

HTTP リクエスト URL

https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:{manager_customer_id}

完全な HTTP リクエストのサンプル

GET /v1/accountReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]

詳細な見込み顧客レポート

詳細な見込み顧客レポートには、クライアント センター（MCC）アカウントのリンクされたローカル サービス アカウントに関連付けられている見込み顧客の詳細が表示されます。このデータは、指定した期間で確認できます。レポートには、指定した期間内に作成された見込み顧客、または異議申し立てステータスが更新された見込み顧客が含まれます。データが最大 30 分ほど古い可能性があります。

レポートを取得するには、次の構成可能な URL パラメータを指定して、https://localservices.googleapis.com/v1/detailedLeadReports:search に HTTP GET リクエストを送信します。

URL パラメータ
query

必須

1 つ以上の ID 値が含まれます。そのうちの 1 つは、クエリのクライアント センター（MCC）アカウントの ID である必要があります。query は、セミコロンで区切られた複数の値を受け入れることができます。

  • 必須: manager_customer_id:<manager_cid>
  • 省略可: customer_id:<linked_cid>

例: query=manager_customer_id:123;customer_id:456
startDate.day

省略可

レポート期間の開始日。1～31 の範囲の値を取ることができます。デフォルトは 1 です。
startDate.month

省略可

レポート期間の開始月。1～12 の値をとることができます。デフォルトは当月です。
startDate.year

省略可

レポート期間の開始年。YYYY 形式で指定します。デフォルトは現在の年です。
endDate.day

省略可

レポート期間の終了日。1～31 の値をとることができます。デフォルトは当日です。
endDate.month

省略可

レポート期間の終了月。1～12 の値をとることができます。デフォルトは当月です。
endDate.year

省略可

レポート期間が終了する年（YYYY 形式）。デフォルトは現在の年です。
pageSize

省略可

返されるエントリの数を示す正の整数。デフォルトは 1000 で、最大値は 10000 です。
pageToken

省略可

文字列。このフィールドに、前のレスポンスの next_page_token を入力します。

上記のフィールドは、SearchDetailedLeadReportsRequest の作成に使用されます。リクエスト内の各顧客 ID に対応する DetailedLeadReports が SearchDetailedLeadReportsResponse に含まれます。各詳細なセールスリード レポートは、ローカル サービス広告を表示するリンクされた顧客アカウントに関連付けられている特定のセールスリードと 1 対 1 で対応しています。

次の表に、DetailedLeadReports のフィールドを示します。

フィールド
leadId 見込み顧客の一意の識別子。
accountId リードを受け取ったアカウントを識別します。
businessName アカウントに関連付けられているビジネス名。
leadCreationTimestamp

見込み顧客が作成されたときのタイムスタンプ。M/D/YYYY 形式の日付と HH:MM:SS 形式の時刻が含まれます。

例: 11/1/2019 12:13:20
leadType リードのタイプ: MESSAGE または PHONE_CALL。
leadCategory

見込み顧客に関連付けられているサービス カテゴリ。

例: housecleaner
geo

関連付けられたアカウントの自宅の都市の場所。

例: San Francisco, California, United States
messageLead メッセージ リードのみに関連付けられている情報: customerName、jobType、postalCode、consumerPhoneNumber。
phoneLead 電話のリードのみに関連付けられている情報: chargedCallTimestamp、chargedConnectedCallDurationSeconds、consumerPhoneNumber。
bookingLead 予約見込み顧客のみに関連付けられている情報: customerName、consumerPhoneNumber、jobType、consumerEmail、bookingAppointmentTimestamp。
chargeStatus セールスリードが請求対象になっているかどうか。true または false のいずれかです。
currencyCode 見込み顧客が作成されたアカウントの通貨コード。
disputeStatus 見込み顧客の異議申し立てのステータス。
aggregatorInfo

サードパーティのアグリゲータ パートナーに固有の情報。このフィールドには、サードパーティのアグリゲータ パートナーに関連付けられている API クライアントに対してのみデータが入力されます。
timezone 見込み顧客に関連付けられたアカウントのタイムゾーン。IANA タイムゾーン データベース形式で指定します。

例

HTTP リクエスト URL

https://localservices.googleapis.com/v1/detailedLeadReports:search?query=manager_customer_id:{manager_customer_id}

完全な HTTP リクエストのサンプル

GET /v1/detailedReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]