Conversions auflisten

Conversion.get() anrufen um eine Liste der Conversion-Objekte zurückzugeben, die in Search Ads 360 verarbeitet wurden. Ich alle Conversions im Suchmaschinenkonto eines Werbetreibenden anfordern oder den Umfang auf eine Anzeigengruppe, Anzeige oder Keyword

Die Search Ads 360-IDs, die Sie in der Anfrage angeben, bestimmen den Geltungsbereich auf die Antwort. Beispiel:

  • Geben Sie diese IDs an, um alle Conversions in einem Suchmaschinenkonto zu sehen: <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
  • Geben Sie diese IDs an, um die Conversions in einer bestimmten Kampagne zu sehen: <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • Um die Conversions zu sehen, die einer bestimmten Anzeige und einem bestimmten Keyword zugeordnet sind, geben Sie diese IDs: <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (wenn das Keyword auf Anzeigengruppenebene vorhanden ist)
    • adId
    • criterionId

Informationen zum Abrufen von Search Ads 360-IDs für Ihren Werbetreibenden finden Sie unter Search Ads 360-IDs. und Conversions.

Nachdem Sie die Anfrage gesendet haben, validiert Search Ads 360 sie und generiert eine Liste der und gibt die Liste als ConversionList-Ressource im Antworttext.

Beispiel für eine Get-Anfrage

Im folgenden Beispiel wird die Liste der Conversions angefordert, die im November erfolgt sind. 15. bis 31. Dezember 2012 in einer bestimmten Kampagne durchgeführt werden.

JSON

Wenn Sie eine URL zum Abrufen einer Liste von Conversions erstellen, formatieren Sie die ersten drei -agencyId, advertiserId undengineId - als Teil des Pfads zum Conversion-Ressource. Geben Sie die verbleibenden Parameter als URL-Suchparameter an.

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())

Beispiel für eine Get-Antwort

Wenn die Validierung der Anfrage erfolgreich ist, gibt Search Ads 360 eine ConversionList-Ressource im Antworttext. 

{
 "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"
  },
  ...
 ]
}

Wenn die Validierung fehlschlägt

Wenn der Bericht die Validierung nicht besteht, gibt Search Ads 360 die Meldung „Nicht gefunden“ zurück. Fehler. Wenn beispielsweise in der obigen Beispielanfrage Agentur: 

Not Found