Conversion.get()
に電話
を呼び出して、検索広告 360 で処理されたコンバージョン オブジェクトのリストを返します。マイページ
広告主のエンジン アカウントのすべてのコンバージョンをリクエストするか、範囲を
特定のキャンペーン、広告グループ、広告、
このリクエストで指定した検索広告 360 ID によって 返されます。次に例を示します。
- エンジン アカウントのすべてのコンバージョンを表示するには、次の ID を指定します。
<ph type="x-smartling-placeholder">
- </ph>
agencyId
advertiserId
engineAccountId
- 特定のキャンペーンのコンバージョンを確認するには、次の ID を指定します。
<ph type="x-smartling-placeholder">
- </ph>
agencyId
advertiserId
engineAccountId
campaignId
- 特定の広告とキーワードに結び付けられたコンバージョンを表示するには、
使用します。
<ph type="x-smartling-placeholder">
- </ph>
agencyId
advertiserId
engineAccountId
campaignId
adGroupId
(キーワードが広告グループ単位で存在する場合)adId
criterionId
広告主の検索広告 360 ID を取得する方法については、検索広告 360 ID をご覧ください。 およびコンバージョンをご覧ください。
リクエストを送信すると、検索広告 360 でリクエストが検証され、
オブジェクトの ConversionList
リソースとしてリストを返します。
レスポンスの本文です
Get リクエストの例
次の例では、11 月に発生したコンバージョンのリストをリクエストします 2012 年 12 月 15 日から 12 月 31 日までの特定のキャンペーン。
JSON
コンバージョンのリストを取得する URL を作成する際は、最初の 3 つの 各パラメータ(agencyId、advertiserId、engineId)を 指定します。残りのパラメータは URL クエリ パラメータとして指定します。
GET https://www.googleapis.com/doubleclicksearch/v2/agency/12300000000000456/advertiser/45600000000010291/engine/700000000042441/conversion?campaign=71700000001899732&startDate=20121115&endDate=20121231&startRow=0&rowCount=10
Java
/** * Instantiate the Doubleclicksearch service, request a list of conversions in a specific campaign, * and print the list to standard out. */ public static void main(String[] args) throws Exception { Doubleclicksearch service = getService(); // See Set Up Your Application. ConversionList conversionList = listConversions(service); outputList(conversionList); } /** * Request a list of the first 10 conversions in a specific campaign. */ private static ConversionList listConversions(Doubleclicksearch service) throws IOException { try { Get getRequest = service.conversion().get( new Long(12300000000000456L), // Replace with your agency ID new Long(45600000000010291L), // Replace with your advertiser ID new Long(700000000042441L), // Replace with your engine account ID new Integer(20121231), // End date new Integer(10), // Number of rows new Integer(20121115), // Start date new Long(0L)); // Starting row getRequest.setCampaignId(71700000002044839L); // Optional parameter return getRequest.execute(); } catch (GoogleJsonResponseException e) { System.err.println("Get request was rejected."); for (ErrorInfo error : e.getDetails().getErrors()) { System.err.println(error.getMessage()); } System.exit(e.getStatusCode()); return null; // Unreachable code. } } /** * Print to standard out. */ privte static void outputList(ConversionList conversionList) { for (Conversion conversion : conversionList.getConversion()) { if (null != conversion) { System.out.println(conversion.toString()); } } }
Python
def get_conversion(service): """Request the first 10 conversions in a specific campaign and print the list. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().get( agencyId='12300000000000456', // Replace with your ID advertiserId='45600000000010291', // Replace with your ID engineAccountId='700000000042441', // Replace with your ID campaignId='71700000002044839', // Replace with your ID startDate=20131115, endDate=20131231, startRow=0, rowCount=10 ) pprint.pprint(request.execute())
GET レスポンスの例
リクエストの検証に成功すると、検索広告 360 はConversionList
レスポンスの本文です
{ "kind": "doubleclicksearch#conversionList", "conversion": [ { "agencyId": "12300000000000456", "advertiserId": "45600000000010291", "engineAccountId": "700000000042441", "campaignId": "71700000002044839", "adGroupId": "58700000032026064", "criterionId": "43700003491981017", "adId": "0", "dsConversionId": "48752623802180029", "conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA", "state": "ACTIVE", "type": "TRANSACTION", "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue "currencyCode": "USD", "quantityMillis": "0", "segmentationType": "FLOODLIGHT", "segmentationId": "25700000001081555", "segmentationName": "Customer Call", "conversionTimestamp": "1355776573000", "conversionModifiedTimestamp": "1355776580813" }, { "agencyId": "12300000000000456", "advertiserId": "45600000000010291", "engineAccountId": "700000000042441", "campaignId": "71700000002044839", "adGroupId": "58700000032026064", "criterionId": "43700003491981017", "adId": "44700000155906860", "dsConversionId": "48752623802180029", "conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA", "state": "ACTIVE", "type": "TRANSACTION", "revenueMicros": "20000000", "currencyCode": "USD", "quantityMillis": "0", "segmentationType": "FLOODLIGHT", "segmentationId": "25700000001081555", "segmentationName": "Customer Call", "conversionTimestamp": "1355776573000", "conversionModifiedTimestamp": "1355776580813" }, ... ] }
検証で不合格だった場合
レポートが検証に合格しなかった場合、検索広告 360 は「Not found」を返します。エラーが発生します。 たとえば、上記のリクエスト例で実際の ID が指定されていない場合、 代理店:
Not Found