プロフィール フィード

プロフィール フィードのセマンティクス

フィード カテゴリの定義で説明したように、スナップショット フィードのセマンティクスは次のアクションです。

  • スナップショット フィード内のプロバイダが LSA プロバイダ データベースに現在存在しない場合、新しいプロファイルが作成されます。
  • スナップショット フィード内のプロバイダが LSA プロバイダ データベースに現在存在する場合、プロフィール情報が更新されます。
  • スナップショット フィードに含まれていないプロバイダの場合、そのプロバイダが現在 LSA プロバイダ データベースに存在していれば、プロフィールは削除されます。

増分フィードのセマンティクスにより、次のアクションが実行されます。

  • 増分フィード内のプロバイダが LSA プロバイダ データベースに存在しない場合、そのプロバイダは no-op になります。
  • 増分フィード内のプロバイダが LSA プロバイダ データベースにすでに存在する場合、そのプロバイダのプロフィール情報が更新されます。
  • 増分フィードに含まれていないプロバイダの場合、これは no-op です。

プロファイルのエラー処理

個々のプロファイル フィード アイテムが無効な場合、LSA データベースでそのフィード アイテムは更新されません。同時に、古いデータが配信されないように、そのアイテムは一時停止されます。

プロフィール フィードが無効な場合（スキーマに準拠していないなど）、フィード全体の処理を停止します。フィード処理結果の概要（エラー、各アイテムの処理ステータスなど）を含むレポートが共有されます。

プロトコルと制約

  1. 制約。フィード内の各ビジネス（フィード アイテム）には一意の ID が必要です。

  2. 上限。LSA は、個々のデータ フィールドにサイズ上限を適用します。これは、次の表で指定されています。

  3. ビジネス名の制約

    1. 最大文字数: スペースを含めて 100 文字
    2. 数字または文字を 1 つ以上含めることを必須とする
    3. サポートされている文字エンコードは UTF-8、UTF-16、UTF-32 です（UTF-8 を推奨）。
    4. 使用可能な特殊文字:
      1. ハイフン -、アンパサンド &、ピリオド .、カンマ ,、アポストロフィ '、かっこ ( )
    5. 大文字の使用を禁止する
    6. 不適切な語句を禁止する
    7. 絵文字を禁止する

プロファイル フィールド

以下では、特定のプロバイダのセットフィールドについて説明します。省略可能なフィールドには、その旨のマークが付いています。

フィールド名 説明 フィールド タイプ 例 必須 制約
serviceProviderId ビジネス リスティング（サービス プロバイダ）の一意の識別子 数値 12345 ○ これは、各サービス プロバイダの一意の ID です。これは int64 に変換されます。プロバイダの更新時は ID を同じにする
serviceProviderName ビジネスの名前 文字列 "King David Garage Doors, Inc." ○ 半角 100 文字（全角 50 文字）以内。名前制約ポリシーの対象。
serviceProviderWebsiteUrl ビジネスのウェブサイトの URL 文字列 https://abc.xyz いいえ http または https で始まる
住所 ビジネスの住所 オブジェクト "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" ○ addressLine1 には、番地が利用可能な場合は番地を入力する必要があります。ビジネスの初期設定後に国コードを変更することはできません。
aggregatorProfileUrl パートナーのサイトのプロフィール ページにリンクするプロフィール URL。 文字列 http://aggregator.com/joes-plumbing/ いいえ http または https で始まる
yearBusinessStarted ビジネスの設立年 integer 2015 いいえ YYYY 形式
businessHours ビジネスの営業時間 オブジェクトの配列 「プロフィール フィードの例」をご覧ください。 ○ 制約については、オブジェクトの定義をご覧ください
businessPhoneNumber e164 形式のビジネスの個々の電話番号。コールセンターの番号やパートナーが割り当てた追跡番号ではなく、空欄にするか、ビジネスが所有している必要があります。 文字列 「+16501112222」 ○ 電話番号は E.164 形式にする必要があります
contact さまざまな連絡方法で使用される連絡先情報 オブジェクトの配列 "{ “type”: “PHONE”, “address”: “+16501112222” }" ○ タイプは「PHONE」または「MESSAGE」で構成されます。タイプが「PHONE」の場合、アドレスには E.164 形式の電話番号が含まれている必要があります。「MESSAGE」アドレスは入力しないでください。PHONE タイプの要素は必須ですが、MESSAGE タイプの要素は省略可能です。
targetingLanguages 広告が配信される言語のリスト。言語は ISO 639-1 言語コード（小文字、2 文字）で定義されます。 文字列の配列 「en」、「fr」 ○ 指定しない場合、デフォルトは「en」です。
geoCovered ビジネス拠点の地域。 オブジェクト いいえ
geoCovered ->criteriaIds サービス提供地域（地域、郡、市区町村、郵便番号）に対応する条件 ID のリスト。 整数の配列 いいえ 地域条件 ID は、Google 広告の地域ターゲット リストで有効である必要があります。
categories ビジネスが提供するカテゴリのリスト。 オブジェクトの配列 「プロフィール フィードの例」をご覧ください。 ○ Google が提供するカテゴリのリストから選択します。カテゴリは 1 つだけ含める必要があります。
categories->tasks 特定のカテゴリで提供されたタスクのリスト。 オブジェクトの配列 ○ Google が提供するタスクのリストから選択する
tasks ->geoCovered タスクによって提供される地域 オブジェクト ○
tasks ->geoCovered->postalCodeCriteriaIds サービス対象の郵便番号に対応する条件 ID のリスト。 文字列の配列 配信された郵便番号のリストの地域条件 ID。条件 ID は、ターゲット タイプが PostalCode の Google 広告の地域ターゲット リストで有効である必要があります
tasks ->geoCovered->cityCriteriaIds サービス対象の都市に対応する条件 ID のリスト。 文字列の配列 配信対象の都市のリストの地域条件 ID。条件 ID は、Google 広告の地域ターゲット リスト（ターゲット タイプが都市）で有効である必要があります。
アクティブ このビジネスを有効にするか一時停止するかを示すフラグ ブール値 true / false ○
monthlyBudget monthlyBudgetCurrency で指定されたこのプロバイダの 1 か月の予算 integer 100 ○ 入札額または見込み顧客の予約価格の最大値以上にする必要があります。
monthlyBudgetCurrency 1 か月の予算と入札単価の通貨。通貨コードをご覧ください。 文字列 “USD” ○ 最初のビジネス設定後に変更することはできません。
コールアウト表示オプション 各カテゴリの吹き出しの配列 オブジェクトの配列 ○ Google が提供するコールアウトのリストから選択する
biddingStrategy オークションでのこのビジネスの入札戦略。リード単価に影響します。 文字列 「MANUAL_CPA」 / 「MAX_CONVERSION」 いいえ Google が提供するリストから選択します。設定しない場合、この戦略はデフォルトで MANUAL_CPA になります。
biddingConfiguration カテゴリごとの入札設定のリスト。MANUAL_CPA 入札戦略にのみ適用されます。 オブジェクトの配列 プロフィール フィードの例を参照してください N 構成が指定されておらず、biddingStrategy が MANUAL_CPA の場合は、すべてのカテゴリのデフォルトを入札単価の最小値に設定します。
biddingConfiguration->categoryId LSA 分類のカテゴリ ID。これらのカテゴリは、上記のカテゴリと一致している必要があります。入札構成が宣言されている場合は必須。 文字列 いいえ Google が提供するリストから選択します。
biddingConfiguration->manualCostPerLead リード単価の手動設定。biddingStrategy が「MANUAL_CPA」の場合は指定する必要があります。 オブジェクト いいえ
manualCostPerLead->bid リード単価の手動入札。見込み顧客単価がこの入札額を超えることはありません。manualCostPerLead が宣言されている場合は必須です。 数値 いいえ 落札価格以上の値を指定してください。