新しい Search Ads Reporting API の新しいコンセプト

Search Ads 360 Reporting API は最新のプラットフォームを基盤としており、さまざまな新しいコンセプトが導入されています。以降のセクションで詳しく説明します。

リソース

リソース オブジェクトはレポートタイプに代わるものです。事前定義されたレポートタイプをリクエストする代わりに、新しい SQL に似たクエリ言語を使用してすべてのリソースをクエリできるようになりました。詳しくは、Search Ads 360 Reporting API の構造をご覧ください。

検索レポート作成

新しい API では、検索に独自のサービスがあります。検索サービスは、従来のレポート サービスに代わるものです。すべてのクエリは SearchAds360Service を経由します。SearchAds360Service には、レポートデータと指標を検索して取得するための SearchStream メソッドと Search メソッドの 2 つのメソッドが用意されています。どちらの検索方法でも、検索クエリに一致するすべての SearchAds360Row オブジェクトが返されます。詳細については、検索レポートを作成するをご覧ください。

リソース メタデータ

SearchAds360FieldService を使用すると、SearchAds360Service 検索メソッドで使用可能なリソース、リソース フィールド、セグメンテーション キー、指標のカタログを動的にリクエストできます。詳細については、リソース メタデータを取得するをご覧ください。

フィールド名

API では、ドット表記で区切られたネストされたフィールド名が導入されます。たとえば campaign.idad_group.id として指定します。さらに、ad_group.campaign.id のようにネストすることもできます。詳しくは、Search Ads 360 Reporting API の構造をご覧ください。

検索広告 360 従来版の API のレポートは、コンセプトが似ている場合、エンティティごとに個別のフィールドに基づいて作成されます。たとえば、campaign レポートと adgroup レポートの両方に、個別の campaignId フィールドが含まれています。

クエリ言語

この API では、検索広告 360 クエリ言語が導入されています。これは柔軟な SQL ライクな言語で、クエリを定義してビジネスに最適な特定のレポートデータを取得できます。詳しくは、検索広告 360 のクエリ言語をご覧ください。

get リクエスト

新しい API では、検索に独自のサービス(SearchAds360Service)がありますが、GET リクエストは各エンティティの特定のサービスで引き続き使用されています。たとえば、CustomColumnService からカスタム列情報を取得できます。詳しくは、Search Ads 360 Reporting API の形式の変更をご覧ください。

カスタム列

検索広告 360 リニューアル版では、数式列カスタム コンバージョンは「カスタム列」と呼ばれます。詳しくは、カスタム列の詳細をご覧ください。新しい CustomColumnService を使用すると、カスタム列を有効にできます。必要な権限が付与されていれば、アカウント ツリー内の任意のアカウントが所有する CustomColumn リソースをリクエストできます。

アカウント管理

検索広告 360 リニューアル版のアカウントは、マネージャー アカウント、サブマネージャー アカウント、クライアント アカウントという階層構造を取っています。MCC アカウントは代理店アカウントを表し、サブマネージャー アカウントは検索広告 360 従来版の広告主アカウントを表します。詳しくは、検索広告 360 のクライアント センター(MCC)アカウントについてをご覧ください。

アカウント ツリーをクエリして、レポートデータを取得するアカウントごとにリクエストを送信できます。

アカウント階層の変更に伴い、広告主/代理店のコンセプトに関連するフィールドは、可能な限り機能的に同等のフィールドに置き換えられました。影響を受けるフィールドとその代替のリストについては、フィールドのマッピングをご覧ください。

ログイン用お客様 ID ヘッダー

login-customer-id は、MCC アカウントを使用してサブマネージャー アカウントまたはクライアント アカウントにアクセスするときに必要な新しいヘッダーです。詳しくは、ログイン カスタマー ID ヘッダーをご覧ください。

バージョニング

Search Ads 360 Reporting API では、セマンティック バージョニングを使用します。メジャー バージョンとマイナー バージョンがあり、vMAJOR_MINOR の形式で指定します。詳細については、バージョニングをご覧ください。