検索広告 360 リニューアル版の階層には、次の 3 種類のアカウントがあります。
マネージャー アカウント - 従来は「代理店アカウント」と呼ばれていました。これは、検索広告 360 アカウント階層の最上位で、下位レベルのサブマネージャー アカウントとクライアント アカウントの管理とレポート作成に使用されます。
サブマネージャー アカウント - 以前の「広告主アカウント」。サブマネージャー アカウントは、管理するクライアント アカウント全体の管理とレポート作成の単一ポイントとして機能します。
クライアント アカウント - 旧称「エンジン アカウント」。クライアント アカウントには、キャンペーン、広告グループなどの項目が含まれます。
詳しくは、検索広告 360 のアカウント階層をご覧ください。
検索広告 360 の各リソースは、MCC アカウント、サブマネージャー アカウント、クライアント アカウントのいずれかのレベルで所有されます。
リソースをクエリするには、所有者のアカウント レベル以上の認証が必要です。適切な所有者アカウント レベルで認証されたら、リクエストされたデータを所有するアカウントの特定の ID をクエリに含める必要があります。
たとえば、CustomColumn リソースはマネージャー アカウントまたはサブマネージャー アカウント単位で所有されますが、Campaign リソースはクライアント アカウント単位で所有されます。つまり、CustomColumn をクエリするには、MCC アカウントまたはサブマネージャー アカウント レベルで認証されている必要があります。また、リクエストされた CustomColumn を所有する MCC アカウントまたはサブマネージャー アカウントの ID をクエリで指定する必要があります。Campaign データをクエリするには、MCC アカウントまたはサブマネージャー アカウントの階層で認証を受けることができます。また、リクエストされたキャンペーン データを所有するクライアント アカウントの ID をクエリで指定する必要があります。
アカウントの階層構造について
Search Ads 360 Reporting API を使用してレポートを作成するには、まず、クエリする MCC アカウント、サブマネージャー アカウント、クライアント アカウント間の親子関係を特定して、アカウント階層を把握する必要があります。
マネージャー アカウントまたはサブマネージャー アカウントの下で管理されているお子様を特定する
MCC アカウントまたはサブマネージャー アカウントの子アカウントの構造を確認するには、検索広告 360 クエリ言語ステートメントを作成して、CustomerClient リソースのすべての直接子アカウントをクエリします。次に、直接の子アカウントごとに CustomerClient リソースに対して反復的にクエリを実行し、マネージャー アカウントまたはサブマネージャー アカウントに間接的にリンクされている子アカウントを返します。
アカウントのマネージャー（親）を特定する
お客様のアカウントの親を特定するには、CustomerManagerLink リソースをクエリします。
複数のアカウントレベルのデータを使用してレポートを作成する
複数のアカウント単位のデータを使ってレポートを作成しなければならない場合もあります。たとえば、データのほとんどをクライアント アカウント レベルの Campaign リソースから取得する場合でも、サブマネージャー アカウント レベルの CustomColumn リソースから補足データを取得する必要がある場合があります。
アカウントの異なるレベルで所有するリソース
BiddingStrategy などのリソースは、マネージャー アカウント、サブマネージャー アカウント、クライアント アカウントのレベルで所有できます。通常、これらのインスタンスでは、クライアント アカウントがリソースデータのさまざまなサブセットにアクセスできます。
Search Ads 360 Reporting API は、ほとんどのリソースの指標をクライアント アカウント レベルでのみ提供しますが、BiddingStrategy などの一部のリソースでは、マネージャー レベルとサブマネージャー レベルで指標を取得できます。
リソースの所有権
次の表に、検索広告 360 の各リソースのアカウント単位の所有権を示します。
| 検索広告 360 リソース | アカウント単位の所有権 |
|---|---|
| お客様 | マネージャー、サブマネージャー、クライアント |
| AdGroup | クライアント |
| AdGroupAd | クライアント |
| AdGroupCriterion | クライアント |
| BiddingStrategy | サブマネージャーとクライアント |
| キャンペーン | クライアント |
| CampaignCriterion | クライアント |
| ExtensionFeedItem | クライアント |
| ConversionAction | サブマネージャー（指標を除く）とクライアント |
| CustomerManagerLink | サブマネージャーとクライアント |
| CustomColumn | マネージャーとサブマネージャー |