การดําเนินการรับบริการ GetHistoricalSearchCount - ข้อมูลเชิงลึกของโฆษณา

รับจํานวนครั้งที่มีการใช้คํามาตรฐานในการค้นหาในระหว่างช่วงเวลาที่ระบุ ผลลัพธ์จะรวมตามชนิดอุปกรณ์

ร้องขอองค์ประกอบ

วัตถุ GetHistoricalSearchCountRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP

หมายเหตุ

เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด

ร้องขอองค์ประกอบเนื้อความ

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
อุปกรณ์	รายการชนิดอุปกรณ์ต่อไปนี้อย่างน้อยหนึ่งชนิด: คอมพิวเตอร์, NonSmartphones, สมาร์ทโฟน, แท็บเล็ต ค่าเริ่มต้นคือ คอมพิวเตอร์ การตอบสนองรวมถึงจํานวนการค้นหาสําหรับชนิดอุปกรณ์ที่คุณระบุเท่านั้น ถ้ามี	อาร์เรย์สตริง
วันที่สิ้นสุด	วันที่สิ้นสุดของช่วงวันที่ที่ระบุข้อมูลที่คุณต้องการใช้เพื่อกําหนดจํานวนการค้นหาในอดีต วันที่ต้องไม่ช้ากว่าวันที่ของวันนี้ และต้องอยู่หลังหรือเป็นวันเดียวกับวันที่เริ่มต้นที่ระบุ อาจมีการปรับปรุงวันที่สิ้นสุดที่มีผลบังคับใช้หาก TimePeriodRollup ที่ระบุเป็นรายสัปดาห์หรือรายเดือน	DayMonthAndYear
คำ	อาร์เรย์ของคําสําคัญที่คุณต้องการกําหนดจํานวนครั้งที่คําสําคัญถูกใช้ในคิวรีการค้นหา อาร์เรย์สามารถมีคําสําคัญได้สูงสุด 1,000 คํา และคําสําคัญแต่ละคําสามารถมีได้สูงสุด 100 อักขระ	อาร์เรย์สตริง
ภาษา	ภาษาที่ใช้เขียนคําสําคัญ ประเทศ/ภูมิภาคที่คุณระบุในองค์ประกอบ PublisherCountries ต้องสนับสนุนภาษาที่ระบุ สําหรับค่าที่เป็นไปได้ ดูภาษาที่รองรับ	สาย อักขระ
PublisherCountries	รหัสประเทศของประเทศ/ภูมิภาคที่จะใช้เป็นแหล่งข้อมูลในอดีต คุณสามารถระบุรหัสประเทศได้หนึ่งหรือหลายรหัส แต่ละประเทศ/ภูมิภาคที่คุณระบุต้องสนับสนุนภาษาที่ระบุในองค์ประกอบภาษา สําหรับค่าที่เป็นไปได้ ดูภาษาโฆษณา ถ้า Null ค่าเริ่มต้นคือประเทศ/ภูมิภาคทั้งหมดที่สนับสนุนภาษาที่ระบุ	อาร์เรย์สตริง
วันที่เริ่มต้น	วันที่เริ่มต้นของช่วงวันที่ที่ระบุข้อมูลที่คุณต้องการใช้เพื่อกําหนดจํานวนการค้นหาในอดีต วันที่นี้ต้องอยู่ก่อนหรือเหมือนกับวันที่สิ้นสุดที่ระบุ วันที่ควรช้ากว่าช่วงข้อมูลอดีตที่พร้อมใช้งานสูงสุดซึ่งสอดคล้องกับองค์ประกอบ TimePeriodRollup ที่ระบุ อาจมีการปรับปรุงวันที่เริ่มต้นที่มีผลถ้า TimePeriodRollup ที่ระบุเป็นรายสัปดาห์หรือรายเดือน	DayMonthAndYear
TimePeriodRollup	คุณสามารถระบุว่าจะส่งกลับข้อมูลแบบรวมรายวัน รายสัปดาห์ หรือรายเดือน สําหรับรายการของค่าที่สนับสนุน ดูส่วน หมายเหตุ ด้านล่าง	สาย อักขระ

องค์ประกอบส่วนหัวของคําขอ

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AuthenticationToken	โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth	สาย อักขระ
CustomerAccountId	ตัวระบุบัญชีโฆษณาที่เป็นเจ้าของหรือเชื่อมโยงกับเอนทิตีในคําขอ องค์ประกอบส่วนหัวนี้ต้องมีค่าเดียวกันกับองค์ประกอบเนื้อความ AccountId เมื่อต้องการทั้งสองอย่าง องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ	สาย อักขระ
CustomerId	ตัวระบุบัญชีผู้จัดการ (ลูกค้า) ที่ผู้ใช้กําลังเข้าถึงหรือดําเนินการ ผู้ใช้สามารถเข้าถึงบัญชีผู้จัดการได้หลายบัญชี องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ	สาย อักขระ
DeveloperToken	โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา	สาย อักขระ
รหัส ผ่าน	องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้	สาย อักขระ
ชื่อ	องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้	สาย อักขระ

องค์ประกอบการตอบสนอง

วัตถุ GetHistoricalSearchCountResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP

องค์ประกอบเนื้อความการตอบสนอง

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
คําสําคัญคําสําคัญจํานวน	อาร์เรย์ของวัตถุข้อมูล KeywordSearchCount อาร์เรย์ ประกอบด้วยรายการสําหรับคําสําคัญแต่ละรายการที่ระบุในคําขอ ถ้าคําสําคัญไม่ถูกต้อง หน่วยข้อมูลที่สอดคล้องกันในอาร์เรย์จะเป็น Null แต่ละ KeywordSearchCount ประกอบด้วยอาร์เรย์ของ SearchCountsByAttributes อาร์เรย์ ประกอบด้วยรายการสําหรับอุปกรณ์เฉพาะแต่ละตัวที่ระบุในคําขอ	อาร์เรย์ KeywordSearchCount

องค์ประกอบส่วนหัวการตอบสนอง

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
TrackingId	ตัวระบุของรายการบันทึกที่ประกอบด้วยรายละเอียดของการเรียกใช้ API	สาย อักขระ

ร้องขอ SOAP

เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดง ลําดับ ขององค์ประกอบ เนื้อความ และ ส่วนหัว สําหรับคําขอ SOAP สําหรับชนิดที่สนับสนุนที่คุณสามารถใช้กับการดําเนินการบริการนี้ โปรดดูการอ้างอิง องค์ประกอบเนื้อความคําขอ ด้านบน

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <Action mustUnderstand="1">GetHistoricalSearchCount</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <GetHistoricalSearchCountRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <Keywords i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </Keywords>
      <Language i:nil="false">ValueHere</Language>
      <PublisherCountries i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </PublisherCountries>
      <StartDate i:nil="false">
        <Day>ValueHere</Day>
        <Month>ValueHere</Month>
        <Year>ValueHere</Year>
      </StartDate>
      <EndDate i:nil="false">
        <Day>ValueHere</Day>
        <Month>ValueHere</Month>
        <Year>ValueHere</Year>
      </EndDate>
      <TimePeriodRollup i:nil="false">ValueHere</TimePeriodRollup>
      <Devices i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </Devices>
    </GetHistoricalSearchCountRequest>
  </s:Body>
</s:Envelope>

Response SOAP

เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงลําดับขององค์ประกอบ เนื้อ ความและ ส่วนหัว สําหรับการตอบสนอง SOAP

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <GetHistoricalSearchCountResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordSearchCounts d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordSearchCount>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <SearchCountsByAttributes d4p1:nil="false">
            <SearchCountsByAttributes>
              <Device d4p1:nil="false">ValueHere</Device>
              <HistoricalSearchCounts d4p1:nil="false">
                <HistoricalSearchCountPeriodic>
                  <SearchCount>ValueHere</SearchCount>
                  <DayMonthAndYear d4p1:nil="false">
                    <Day>ValueHere</Day>
                    <Month>ValueHere</Month>
                    <Year>ValueHere</Year>
                  </DayMonthAndYear>
                </HistoricalSearchCountPeriodic>
              </HistoricalSearchCounts>
            </SearchCountsByAttributes>
          </SearchCountsByAttributes>
        </KeywordSearchCount>
      </KeywordSearchCounts>
    </GetHistoricalSearchCountResponse>
  </s:Body>
</s:Envelope>

ไวยากรณ์โค้ด

ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม

public async Task<GetHistoricalSearchCountResponse> GetHistoricalSearchCountAsync(
	IList<string> keywords,
	string language,
	IList<string> publisherCountries,
	DayMonthAndYear startDate,
	DayMonthAndYear endDate,
	string timePeriodRollup,
	IList<string> devices)
{
	var request = new GetHistoricalSearchCountRequest
	{
		Keywords = keywords,
		Language = language,
		PublisherCountries = publisherCountries,
		StartDate = startDate,
		EndDate = endDate,
		TimePeriodRollup = timePeriodRollup,
		Devices = devices
	};

	return (await AdInsightService.CallAsync((s, r) => s.GetHistoricalSearchCountAsync(r), request));
}

static GetHistoricalSearchCountResponse getHistoricalSearchCount(
	ArrayOfstring keywords,
	java.lang.String language,
	ArrayOfstring publisherCountries,
	DayMonthAndYear startDate,
	DayMonthAndYear endDate,
	java.lang.String timePeriodRollup,
	ArrayOfstring devices) throws RemoteException, Exception
{
	GetHistoricalSearchCountRequest request = new GetHistoricalSearchCountRequest();

	request.setKeywords(keywords);
	request.setLanguage(language);
	request.setPublisherCountries(publisherCountries);
	request.setStartDate(startDate);
	request.setEndDate(endDate);
	request.setTimePeriodRollup(timePeriodRollup);
	request.setDevices(devices);

	return AdInsightService.getService().getHistoricalSearchCount(request);
}

static function GetHistoricalSearchCount(
	$keywords,
	$language,
	$publisherCountries,
	$startDate,
	$endDate,
	$timePeriodRollup,
	$devices)
{

	$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];

	$request = new GetHistoricalSearchCountRequest();

	$request->Keywords = $keywords;
	$request->Language = $language;
	$request->PublisherCountries = $publisherCountries;
	$request->StartDate = $startDate;
	$request->EndDate = $endDate;
	$request->TimePeriodRollup = $timePeriodRollup;
	$request->Devices = $devices;

	return $GLOBALS['AdInsightProxy']->GetService()->GetHistoricalSearchCount($request);
}

response=adinsight_service.GetHistoricalSearchCount(
	Keywords=Keywords,
	Language=Language,
	PublisherCountries=PublisherCountries,
	StartDate=StartDate,
	EndDate=EndDate,
	TimePeriodRollup=TimePeriodRollup,
	Devices=Devices)

หมาย เหตุ

อาจมีการระบุค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กต่อไปนี้ และข้อมูลจะถูกส่งกลับมาตราบเท่าที่ช่วงข้อมูลในอดีตสูงสุดที่สอดคล้องกันพร้อมใช้งาน

TimePeriodRollup	ข้อมูลในอดีตที่พร้อมใช้งาน
ประจำ วัน	จนถึง 45 วันก่อนวันที่เสร็จสมบูรณ์ล่าสุด
ประจำ สัปดาห์	นานถึง 15 สัปดาห์ก่อนสัปดาห์ที่เสร็จสมบูรณ์ล่าสุด StartDate ที่ระบุถูกปรับกลับไปเป็นวันอาทิตย์ที่ใกล้ที่สุด และวันที่สิ้นสุดถูกปรับไปข้างหน้าเป็นวันเสาร์ที่ใกล้ที่สุด
ประจำ เดือน	นานถึง 24 เดือนก่อนเดือนที่เสร็จสมบูรณ์ล่าสุด StartDate ที่ระบุถูกปรับกลับไปยังจุดเริ่มต้นของเดือน และวันที่สิ้นสุดถูกปรับไปข้างหน้าจนถึงสิ้นเดือน

ภาษาที่รองรับ

ต่อไปนี้เป็นภาษาที่ได้รับการสนับสนุนสําหรับองค์ประกอบเนื้อความของการร้องขอ ภาษา :

ภาษาที่รองรับ
Danish
Dutch
English
Finnish
French
German
Italian
นอร์เวย์
โปรตุเกส
SimplifiedChinese
Spanish
Swedish
แบบดั้งเดิมจีน

การแมปภาษาและการแมปประเทศ/ภูมิภาค

นี่คือตารางภาษาและการแมปประเทศ/ภูมิภาค:

ภาษา	CountryCode	ประเทศ/ภูมิภาค	Language@Country
Danish	Dk	เดนมาร์ก	Danish@Denmark
Dutch	Nl	เนเธอร์แลนด์	Dutch@Netherlands
English	Th	ออสเตรเลีย	English@Australia
English	Ca	แคนาดา	English@Canada
English	Fr	ฝรั่งเศส	English@France
English	เด	เยอรมนี	English@Germany
English	นิ้ว	อินเดีย	English@India
English	Id	อินโดนีเซีย	English@Indonesia
English	Ie	ไอร์แลนด์	English@Ireland
English	IT	อิตาลี	English@Italy
English	ของฉัน	มาเลเซีย	English@Malaysia
English	Nl	เนเธอร์แลนด์	English@Netherlands
English	Th	NewZealand	English@NewZealand
English	Ph	ฟิลิปปินส์	English@Philippines
English	Sg	สิงคโปร์	English@Singapore
English	Es	สเปน	English@Spain
English	SE	สวีเดน	English@Sweden
English	Ch	สวิตเซอร์แลนด์	English@Switzerland
English	TH	ไทย	English@Thailand
English	Gb	สหราชอาณาจักร	English@UK
English	เรา	สหรัฐอเมริกา	English@US
English	VN	เวียดนาม	English@Vietnam
Finnish	FI	ฟินแลนด์	Finnish@Finland
French	Ca	แคนาดา	French@Canada
French	Fr	ฝรั่งเศส	French@France
French	Ch	สวิตเซอร์แลนด์	French@Switzerland
French	Gb	สหราชอาณาจักร	French@UK
French	เรา	สหรัฐอเมริกา	French@US
German	Th	ออสเตรเลีย	German@Australia
German	ที่	ออสเตรีย	German@Austria
German	Ca	แคนาดา	German@Canada
German	Fr	ฝรั่งเศส	German@France
German	เด	เยอรมนี	German@Germany
German	Ch	สวิตเซอร์แลนด์	German@Switzerland
German	Gb	สหราชอาณาจักร	German@UK
German	เรา	สหรัฐอเมริกา	German@US
Italian	IT	อิตาลี	Italian@Italy
นอร์เวย์	ไม่ใช่	นอร์เวย์	Norwegian@Norway
โปรตุเกส	Br	บราซิล	Portuguese@Brazil
SimplifiedChinese	Cn	จีน	SimplifiedChinese@China
Spanish	Ar	อาร์เจนติน่า	Spanish@Argentina
Spanish	Cl	ชิลี	Spanish@Chile
Spanish	Co	โคลัมเบีย	Spanish@Colombia
Spanish	Mx	เม็กซิโก	Spanish@Mexico
Spanish	Pe	เปรู	Spanish@Peru
Spanish	Es	สเปน	Spanish@Spain
Spanish	เรา	เรา	Spanish@US
Spanish	VE	เวเนซุเอลา	Spanish@Venezuela
Swedish	SE	สวีเดน	Swedish@Sweden
แบบดั้งเดิมจีน	Hk	ฮ่องกงซาร์	TraditionalChinese@HongKongSAR
แบบดั้งเดิมจีน	Tw	ไต้หวัน	TraditionalChinese@Taiwan

ข้อกําหนด

บริการ: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13