Mappage des ID pour la nouvelle interface Search Ads 360

La nouvelle API Search Ads 360 Reporting est désormais disponible. Cette nouvelle API vous offre plus de flexibilité pour créer des rapports personnalisés et intégrer les données dans vos applications et processus de reporting. Découvrez comment passer à la nouvelle API Search Ads 360 Reporting et l'utiliser.

Les entités de la nouvelle interface Search Ads 360 disposent d'un espace d'ID différent de celui de l'ancienne interface Search Ads 360. Pour obtenir le mappage des ID entre l'ancienne et la nouvelle interface Search Ads 360, envoyez une requête Reports.getIdMappingFile(). La réponse inclut les mappages d'ID pour la plupart des entités d'un annonceur spécifié. Consultez la section Raisons courantes d'absence d'entités pour en savoir plus sur les raisons pour lesquelles une entité peut être omise du fichier de mappage.

Voici un exemple de fichier renvoyé (format CSV encodé en UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

Le fichier CSV comporte trois colonnes:

  • Entity Type: type d'entité de cette ligne.

  • Legacy IDs: chaîne JSON du chemin d'accès complet de l'entité dans la version précédente de Search Ads 360

  • New IDs: chaîne JSON du chemin d'accès complet de l'entité dans la nouvelle interface Search Ads 360

Le tableau ci-dessous présente la liste des entités compatibles et des exemples de mappages d'ID:

Type d'entité Description Anciens ID Nouveaux ID
CLIENT Mappage d'ID pour : Les mappages pour les administrateurs et les agences ne sont pas disponibles. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CAMPAGNE Mappage d'ID pour la campagne. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Mappage des ID pour adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
CRITERION Mappage des ID pour les critères au niveau du groupe d'annonces : 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD Mappage d'ID pour l'annonce. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Mappage des ID pour les critères au niveau de la campagne : 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Mappage d'ID pour le groupe de campagnes. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Mappage des ID pour l'objectif de performances du groupe de campagnes. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Mappage d'ID pour la table de flux 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Mappage d'ID pour feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Causes courantes d'entités manquantes

Bien que le fichier de mappage d'un annonceur contienne la plupart de ses entités, il arrive que certaines d'entre elles soient manquantes. Voici les raisons les plus fréquentes pouvant l'expliquer :

  • Chaque fichier de mappage est mis à jour tous les trois jours. Si un fichier de mappage est téléchargé immédiatement après la création d'une entité, celle-ci ne figurera probablement pas dans le fichier de mappage. Il sera probablement inclus au bout de trois jours.
  • Le compte auquel l'entité appartient est supprimé. Nous n'acceptons pas la mise en correspondance des ID dans ce cas.
  • La mise à jour d'une entité (par exemple, une campagne) côté moteur n'est pas prise en charge dans la nouvelle interface Search Ads 360. Les mises à jour ont été gérées en créant une nouvelle entité Search Ads 360, avec la mise à jour et la suppression ultérieure de l'ancienne entité Search Ads 360.
  • Il est possible que les mappages précédents aient été supprimés lors de la synchronisation entre l'ancienne et la nouvelle interface Search Ads 360, dans laquelle seul le dernier mappage est conservé. Plusieurs mappages entre un ancien ID et plusieurs nouveaux ID Search Ads 360 sont résolus, en conservant celui avec le dernier code temporel.
  • Le compte de moteur n'est pas synchronisé en raison d'erreurs de synchronisation entre l'ancienne et la nouvelle interface Search Ads 360.
  • Le compte est supprimé ou désactivé.

Télécharger le rapport

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

Uniqueté de l'ID de l'objet

Chaque objet de la nouvelle interface Search Ads 360 est identifié par son propre ID. Certains de ces ID sont uniques au niveau mondial pour tous les comptes de la nouvelle interface Search Ads 360, tandis que d'autres ne le sont que dans un champ d'application limité. Par exemple, vous devez utiliser à la fois le groupe d'annonces et les ID d'annonce pour identifier de manière unique les annonces, car les ID d'annonce sont attribués de manière unique à chaque groupe d'annonces, mais pas entre les groupes d'annonces. L'unicité de chaque ID d'objet dans la nouvelle interface Search Ads 360 est indiquée ci-dessous. Ces règles d'ID peuvent être utiles lorsque vous concevez un stockage local pour vos nouveaux objets Search Ads 360.

ID d'objet Périmètre de l'unicité Unique au niveau global ?
ID du budget Monde Oui
ID de la campagne Global Oui
ID du groupe d'annonces Global Oui
ID de l'annonce Groupe d'annonces Non. La paire (AdGroupId, AdId) est unique dans le monde entier.
ID du critère de groupe d'annonces Groupe d'annonces Non. La paire (AdGroupId, CriterionId) est unique dans le monde entier.
ID du critère de campagne Campagne Non. La paire (CampaignId, CriterionId) est unique dans le monde entier.
Extensions d'annonce Campagne Non. La paire (CampaignId, AdExtensionId) est unique dans le monde entier.
ID du flux Global Oui
ID de l'élément de flux Global Oui
ID de l'attribut du flux Flux Non
ID de correspondance de flux Global Oui
ID du libellé Monde Oui
ID de la liste d'utilisateurs Monde Oui