Nouvelle interface

La nouvelle interface Search Ads 360 attribue de nouveaux ID aux comptes utilisateur, aux campagnes, aux groupes d'annonces des mots clés (critères) et des annonces. Deux changements de comportement supplémentaires s'appliquent à ces identifiants:

  • La nouvelle interface Search Ads 360 attribue un numéro client unique au compte administrateur, administrateur secondaire et les comptes client, officiellement appelés agences, annonceurs et comptes de moteur, respectivement.

  • La nouvelle interface Search Ads 360 n'attribue plus d'ID uniques aux mots clés et aux annonces.

L'API de conversion accepte désormais les nouveaux numéros client Search Ads 360 : ID d'agence, les références annonceur et les ID de compte de moteur sont acceptés. Si vous spécifiez l'API du client, l'API s'attend à ce que l'ID de la campagne, l'ID du groupe d'annonces, l'ID du mot clé et l'ID de l'annonce soient de nouveaux ID Search Ads 360. Lorsque vous utilisez des identifiants de mots clés ou d'annonces dans la nouvelle interface Search Ads 360, vous devez spécifier les de campagne et de groupe d'annonces chaque fois que votre demande utilise un identifiant de mot clé ou d'annonce.

Lorsque vous utilisez un nouvel ID Search Ads 360 dans votre demande, la réponse inclut également les ID de la nouvelle interface Search Ads 360.

Répertorier les conversions

Il existe un nouveau point de terminaison pour la demande de liste avec le nouvel ID Search Ads 360. Toi un numéro client de compte client. Vous pouvez également spécifier l'ID de la campagne. et l'ID du groupe d'annonces à lister dans les paramètres de requête. Enfin, endDate, rowCount, startDate et startRow sont toujours obligatoires.

Requête HTTP

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

Insérer/Mettre à jour la conversion

Nous acceptons la demande suivante qui utilise le nouvel ID Search Ads 360:

  • Attribuer une conversion à un mot clé uniquement
  • Mettre à jour la conversion avec son criterionId (identifiant du mot clé) spécifié

Les points de terminaison restent inchangés. Vous devez fournir la nouvelle interface ID dans chaque ressource de conversion: au lieu de définir agencyId, advertiserId et engineAccountId, vous devez indiquer customerId, et utilisez l'ID de la nouvelle interface Search Ads 360 dans campaignId, adGroupId, criterionId adId si nécessaire.

Voici un exemple de requête montrant comment utiliser l'ID de la nouvelle interface Search Ads 360 pour attribuer une conversion à un mot clé

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"
    }
  ]
}