検索広告 360 リニューアル版では、ユーザー アカウント、キャンペーン、広告グループ、キーワード（条件）、広告に新しい ID が割り当てられます。これらの ID の動作が変更されています。
-
検索広告 360 リニューアル版では、マネージャー アカウント、サブマネージャー アカウント、クライアント アカウント（正式名称は代理店アカウント、広告主アカウント、エンジン アカウント）にそれぞれグローバルに一意のお客様 ID が割り当てられます。
-
検索広告 360 リニューアル版では、キーワードと広告に固有の ID は割り当てられなくなります。
代理店 ID、広告主 ID、エンジン アカウント ID が使用可能な場所であれば、コンバージョン API で検索広告 360 リニューアル版のお客様 ID も使用できるようになりました。カスタマー API を指定した場合、API ではキャンペーン ID、広告グループ ID、キーワード ID、広告 ID が検索広告 360 リニューアル版の ID であると想定されます。検索広告 360 リニューアル版のキーワード ID または広告 ID を使用する場合、リクエストでキーワードや広告 ID を使用する場合は常に、関連するキャンペーン ID と広告グループ ID を指定する必要があります。
リクエストで検索広告 360 リニューアル版 ID を使用すると、レスポンスでも検索広告 360 リニューアル版 ID が使用されます。
コンバージョンを一覧表示する
検索広告 360 リニューアル版 ID を持つリスト リクエスト用の新しいエンドポイントがあります。クライアント アカウントのお客様 ID を指定する必要があります。また、キャンペーン ID と広告グループ ID をクエリ パラメータで指定することもできます。また、endDate、rowCount、startDate、startRow も引き続き必要です。
HTTP リクエスト
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
コンバージョンを挿入/更新
検索広告 360 リニューアル版の ID を使用した次のリクエストがサポートされています。
- コンバージョンをキーワードと広告に関連付ける
- コンバージョンをキーワードにのみ関連付ける
- 指定したコンバージョンの
criterionId（キーワード ID）でコンバージョンを更新します。
エンドポイントは同じままです。各コンバージョン リソースには、検索広告 360 リニューアル版 ID を指定する必要があります。agencyId、advertiserId、engineAccountId を設定する代わりに、customerId を指定し、必要に応じて campaignId、adGroupId、criterionId、adId で検索広告 360 リニューアル版 ID を使用します。
以下は、検索広告 360 リニューアル版の ID を使用してコンバージョンをキーワードに関連付けるリクエストの例です。
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
{
"conversion" : [
{
"customerId": "123-123-1234"
"campaignId": "10000001",
"adGroupId": "20000001",
"criterionId": "30000001",
"conversionId": "floodlight conversion ID 1",
"conversionTimestamp": "1660799917714",
"type": "ACTION",
"quantityMillis": "1000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test"
}
]
}
在庫状況を指定する
また、
Conversion.updateAvailability()
メソッドで検索広告 360 リニューアル版 ID を使用することもできます。サブマネージャーのお客様 ID を使用する必要があります。次に例を示します。
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
"availabilities": [
{
"customerId": "123-123-1234"
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test",
"availabilityTimestamp": "1389348800000"
}
]
}