การแมปรหัสสำหรับ Search Ads 360 เวอร์ชันใหม่

Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว โดย API ใหม่นี้จะช่วยเพิ่มความยืดหยุ่นในการสร้างรายงานที่กำหนดเองและผสานรวมข้อมูลเข้ากับแอปพลิเคชันและกระบวนการรายงาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลรวมถึงการใช้ Search Ads 360 Reporting API เวอร์ชันใหม่

เอนทิตีใน Search Ads 360 เวอร์ชันใหม่มีพื้นที่รหัสต่างจาก Search Ads 360 เวอร์ชันเก่า หากต้องการรับการแมปรหัสระหว่าง Search Ads 360 เวอร์ชันเก่าและเวอร์ชันใหม่ ให้ส่งคำขอ Reports.getIdMappingFile() การตอบกลับนี้มีการแมปรหัสของเอนทิตีทั้งหมดของผู้ลงโฆษณาที่ระบุ

ต่อไปนี้คือตัวอย่างของไฟล์ที่แสดงผล (รูปแบบ CSV ที่เข้ารหัสเป็น UTF-8)

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

ไฟล์ CSV มี 3 คอลัมน์ดังนี้

  • Entity Type: ประเภทเอนทิตีของแถวนี้

  • Legacy IDs: สตริง JSON ของเส้นทางเอนทิตีแบบเต็มใน Search Ads 360 เวอร์ชันเก่า

  • New IDs: สตริง JSON ของเส้นทางเอนทิตีแบบเต็มใน Search Ads 360 เวอร์ชันใหม่

ตารางด้านล่างแสดงรายการเอนทิตีที่รองรับและตัวอย่างการแมปรหัส

ประเภทรายการ คำอธิบาย รหัสเดิม รหัสใหม่
ลูกค้า การแมปรหัสสําหรับรายการต่อไปนี้ 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
แคมเปญ การแมปรหัสสำหรับแคมเปญ 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP การแมปรหัสสำหรับ adGroup 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
ตัวแปร การแมปรหัสสําหรับรายการต่อไปนี้ 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD การแมปรหัสสำหรับโฆษณา 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION การแมปรหัสสําหรับรายการต่อไปนี้ 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP การแมปรหัสสำหรับกลุ่มแคมเปญ 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET การแมปรหัสสำหรับเป้าหมายด้านประสิทธิภาพของกลุ่มแคมเปญ 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE การแมปรหัสสำหรับตารางฟีด 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM การแมปรหัสสำหรับ feedItem 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

ดาวน์โหลดรายงาน

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

ความไม่ซ้ำกันของรหัสออบเจ็กต์

ระบบจะระบุออบเจ็กต์ทุกรายการใน Search Ads 360 เวอร์ชันใหม่ด้วยรหัสของตัวเอง รหัสบางรหัสไม่ซ้ำกันในระดับสากลสำหรับบัญชีทั้งหมดใน Search Ads 360 เวอร์ชันใหม่ ในขณะที่รหัสอื่นๆ จะไม่ซ้ำกันภายในขอบเขตที่จำกัด เช่น คุณต้องใช้ทั้งกลุ่มโฆษณาและรหัสโฆษณาเพื่อระบุโฆษณาโดยไม่ซ้ำกัน เนื่องจากรหัสโฆษณาจะกำหนดแบบไม่ซ้ำกันต่อกลุ่มโฆษณา แต่ไม่ใช่ข้ามกลุ่มโฆษณา ความไม่ซ้ำกันของรหัสออบเจ็กต์แต่ละรหัสภายใน Search Ads 360 เวอร์ชันใหม่จะแสดงอยู่ด้านล่าง กฎรหัสเหล่านี้จะมีประโยชน์เมื่อออกแบบพื้นที่เก็บข้อมูลในเครื่องสำหรับออบเจ็กต์ Search Ads 360 เวอร์ชันใหม่

รหัสออบเจ็กต์ ขอบเขตของความเป็นเอกลักษณ์ มีเอกลักษณ์เฉพาะตัวทั่วโลก
รหัสงบประมาณ ประเทศทั่วโลก มี
รหัสแคมเปญ ประเทศทั่วโลก มี
รหัส AdGroup ประเทศทั่วโลก มี
รหัสโฆษณา กลุ่มโฆษณา คู่ของ (AdGroupId, AdId) ไม่ซ้ำกันทั่วโลก
รหัสเกณฑ์ของกลุ่มโฆษณา กลุ่มโฆษณา คู่ของ (AdGroupId, CriterionId) ไม่ซ้ำกันทั่วโลก
รหัสเกณฑ์แคมเปญ แคมเปญ คู่ของ (CampaignId, CriterionId) ไม่ซ้ำกันทั่วโลก
ส่วนขยายโฆษณา แคมเปญ คู่ของ (CampaignId, AdExtensionId) ไม่ซ้ำกันทั่วโลก
รหัสฟีด ประเทศทั่วโลก มี
รหัสรายการฟีด ประเทศทั่วโลก มี
รหัสแอตทริบิวต์ฟีด ฟีด ไม่ได้
รหัสการแมปฟีด ประเทศทั่วโลก มี
รหัสป้ายกำกับ ประเทศทั่วโลก มี
รหัสรายชื่อผู้ใช้ ประเทศทั่วโลก มี