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

Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมใช้งานแล้ว โดย API ใหม่จะมี ความยืดหยุ่นที่เพิ่มขึ้นในการสร้างรายงานที่กำหนดเองและผสานรวมข้อมูลไว้ในแอปพลิเคชันการรายงานของคุณ และกระบวนการต่างๆ ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลไปยังและการใช้การรายงาน Search Ads 360 เวอร์ชันใหม่ 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"
}
          
แคมเปญ การแมปรหัสสำหรับ campaign
{
 "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"
}
          
เกณฑ์ การแมปรหัสสำหรับ:
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 การแมปรหัสสำหรับ 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) ไม่ซ้ำกันทั่วโลก
รหัสฟีด ทั่วโลก ใช่
รหัสรายการฟีด ทั่วโลก ใช่
รหัสแอตทริบิวต์ฟีด ฟีด ไม่ได้
รหัสการแมปฟีด ทั่วโลก ใช่
รหัสป้ายกำกับ ทั่วโลก ใช่
รหัสรายการผู้ใช้ ทั่วโลก ใช่