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 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 du 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"
}
CRITÈRE 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 des 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 ne soient pas présentes. 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é, il est probable qu'elle ne figure 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 d'ID dans ce cas.

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 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 l'ID du groupe d'annonces et l'ID de l'annonce pour identifier de manière unique les annonces, car les ID des annonces 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 relatives aux identifiants peuvent être utiles lorsque vous concevez un espace de stockage local pour vos objets dans la nouvelle interface 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
Identifiant d'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.
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