Répertorier les conversions

Appeler le Conversion.get() pour renvoyer une liste des objets de conversion traités dans Search Ads 360. Toi peut demander toutes les conversions dans le compte de moteur d'un annonceur ou limiter la portée à un une campagne, un groupe d'annonces, une annonce ou un mot clé spécifique.

Les ID Search Ads 360 que vous spécifiez dans la demande déterminent le champ d'application la réponse. Exemple :

  • Pour afficher toutes les conversions d'un compte associé à un moteur, indiquez ces ID: <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
  • Pour afficher les conversions d'une campagne spécifique, indiquez ces ID: <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • Pour voir les conversions attribuées à une annonce et à un mot clé spécifiques, spécifiez ces identifiants: <ph type="x-smartling-placeholder">
      </ph>
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (si le mot clé existe au niveau du groupe d'annonces)
    • adId
    • criterionId

Pour savoir comment obtenir des ID Search Ads 360 pour votre annonceur, consultez la section ID Search Ads 360 et "Conversions".

Une fois la demande envoyée, Search Ads 360 la valide et génère la liste des et renvoie la liste en tant que ressource ConversionList dans le corps de la réponse.

Exemple de requête Get

L'exemple suivant demande la liste des conversions survenues depuis novembre du 15 au 31 décembre 2012 dans une campagne spécifique.

JSON

Lorsque vous créez une URL pour récupérer une liste de conversions, mettez en forme les trois premières "agencyId", "advertiserId" et "engineId" dans le chemin d'accès ressource de conversion. Spécifiez les autres paramètres en tant que paramètres de requête d'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())

Exemple de réponse "Get"

Si la validation de la requête aboutit, Search Ads 360 renvoie une ressource ConversionList dans le corps de la réponse. 

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

En cas d'échec de la validation

Si le rapport échoue, Search Ads 360 affiche la mention "Introuvable". . Par exemple, si l'exemple de requête ci-dessus ne spécifie pas de valeur réelle agence: 

Not Found