Mappage des ID pour la nouvelle interface Search Ads 360

La nouvelle API Search Ads 360 Reporting est désormais disponible. La nouvelle API vous offre davantage de flexibilité pour créer des rapports personnalisés et intégrer les données dans vos applications et processus de reporting. En savoir plus sur la migration vers et l'utilisation de la nouvelle API Search Ads 360 Reporting

Les entités de la nouvelle interface Search Ads 360 possèdent un espace d'ID différent de celui de l'ancienne interface. 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 des mappages d'ID pour toutes les entités d'un annonceur spécifié.

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 l'ancienne interface 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 une liste d'entités compatibles et des exemples de mappage d'ID:

Type d'entité Description Anciens ID Nouveaux ID
CLIENT Mappage des ID pour : 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CAMPAGNE Mappage des 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"
}
CRITÈRE DE CRITÈRE Mappage des ID pour : 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD Mappage des ID pour ad 
{
  "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 : 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Mappage des 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 des ID pour la table de flux. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Mappage des ID pour feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

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

Unicité de l'ID d'objet

Dans la nouvelle interface Search Ads 360, chaque objet est identifié par son propre ID. Certains de ces ID sont uniques au niveau mondial dans tous les comptes de la nouvelle interface Search Ads 360, tandis que d'autres ne sont uniques que dans un champ d'application restreint. Par exemple, vous devez utiliser à la fois les identifiants du groupe d'annonces et les identifiants pour identifier les annonces de manière unique. En effet, les identifiants sont attribués de façon unique à chaque groupe d'annonces, mais pas à plusieurs groupes d'annonces. Vous trouverez ci-dessous les spécificités de chaque ID d'objet dans la nouvelle interface Search Ads 360. Ces règles d'identifiant peuvent s'avérer 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 Global Oui
ID de campagne Global Oui
ID du groupe d'annonces Global Oui
Identifiant d'annonce Groupe d'annonces Non. La paire (AdGroupId, AdId) est unique.
ID du critère de groupe d'annonces Groupe d'annonces Non. La paire (AdGroupId, CriterionId) est unique.
ID du critère de campagne Campagne Non. La paire (CampaignId, CriterionId) est unique.
Extensions d'annonce Campagne Non. La paire (CampaignId, AdExtensionId) est unique.
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é Global Oui
ID UserList Global Oui