การดําเนินการบริการ GetKeywordDemographics - ข้อมูลเชิงลึกของโฆษณา
รับอายุและเพศของผู้ใช้ที่ค้นหาคีย์เวิร์ดที่ระบุ
หมายเหตุ
การดําเนินการบริการ GetKeywordDemographics ไม่ได้รับการสนับสนุน ณ วันที่ 21 สิงหาคม ค.ศ. 2023 เรียนรู้เพิ่มเติม
ร้องขอองค์ประกอบ
วัตถุ GetKeywordDemographicsRequest กําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
อุปกรณ์ | อาร์เรย์ของอุปกรณ์ที่คุณต้องการรับข้อมูลประชากร ประเภทอุปกรณ์ที่รองรับได้แก่: คอมพิวเตอร์, NonSmartphones, สมาร์ทโฟน, แท็บเล็ต ค่าเริ่มต้นคือ คอมพิวเตอร์ หากการตอบกลับมีเฉพาะข้อมูลประชากรของคําหลักสําหรับประเภทอุปกรณ์ที่คุณระบุ |
อาร์เรย์สตริง |
คำ | อาร์เรย์ของคําสําคัญที่คุณต้องการรับข้อมูลประชากร ข้อมูลยังถูกแบ่งออกตามประเภทอุปกรณ์ อาร์เรย์สามารถมีคําสําคัญได้สูงสุด 1,000 คํา และคําสําคัญแต่ละคําสามารถมีได้สูงสุด 100 อักขระ |
อาร์เรย์สตริง |
ภาษา | ภาษาที่ใช้เขียนคําสําคัญ สําหรับค่าที่เป็นไปได้ ดูภาษาโฆษณา |
สาย อักขระ |
PublisherCountry | รหัสประเทศของประเทศ/ภูมิภาคที่จะใช้เป็นแหล่งข้อมูลประชากร ประเทศ/ภูมิภาคที่คุณระบุต้องสนับสนุนภาษาที่ระบุในองค์ประกอบภาษา สําหรับค่าที่เป็นไปได้ ดูภาษาโฆษณา |
สาย อักขระ |
องค์ประกอบส่วนหัวของคําขอ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
สาย อักขระ |
CustomerAccountId | ตัวระบุบัญชีโฆษณาที่เป็นเจ้าของหรือเชื่อมโยงกับเอนทิตีในคําขอ องค์ประกอบส่วนหัวนี้ต้องมีค่าเดียวกันกับองค์ประกอบเนื้อความ AccountId เมื่อต้องการทั้งสองอย่าง องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ |
สาย อักขระ |
CustomerId | ตัวระบุบัญชีผู้จัดการ (ลูกค้า) ที่ผู้ใช้กําลังเข้าถึงหรือดําเนินการ ผู้ใช้สามารถเข้าถึงบัญชีผู้จัดการได้หลายบัญชี องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ |
สาย อักขระ |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
สาย อักขระ |
รหัส ผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
ชื่อ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
องค์ประกอบการตอบสนอง
วัตถุ GetKeywordDemographicsResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
KeywordDemographicResult | อาร์เรย์ของวัตถุข้อมูล KeywordDemographicResult ลําดับของรายการจะสอดคล้องกับคําสําคัญที่ระบุไว้ในคําขอโดยตรง ถ้าไม่มีข้อมูลประชากรที่พร้อมใช้งานสําหรับคําสําคัญ คําสําคัญจะรวมอยู่ในรายการ แต่องค์ประกอบ KeywordDemographics ของ KeywordDemographicResult ที่สอดคล้องกันจะเป็น Null KeywordDemographicResult แต่ละตัวประกอบด้วยอาร์เรย์ของวัตถุข้อมูล KeywordDemographic อาร์เรย์ ประกอบด้วยรายการสําหรับอุปกรณ์แต่ละเครื่องที่ระบุในคําขอ KeywordDemographic แต่ละรายการประกอบด้วยเปอร์เซ็นต์ของเวลาที่ผู้ใช้อายุและเพศที่ค้นหาคีย์เวิร์ดที่ระบุ |
อาร์เรย์ KeywordDemographicResult |
องค์ประกอบส่วนหัวการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
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">GetKeywordDemographics</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>
<GetKeywordDemographicsRequest 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>
<PublisherCountry i:nil="false">ValueHere</PublisherCountry>
<Device i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:string>ValueHere</a1:string>
</Device>
</GetKeywordDemographicsRequest>
</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>
<GetKeywordDemographicsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
<KeywordDemographicResult d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<KeywordDemographicResult>
<Keyword d4p1:nil="false">ValueHere</Keyword>
<KeywordDemographics d4p1:nil="false">
<KeywordDemographic>
<Device d4p1:nil="false">ValueHere</Device>
<EighteenToTwentyFour>ValueHere</EighteenToTwentyFour>
<TwentyFiveToThirtyFour>ValueHere</TwentyFiveToThirtyFour>
<ThirtyFiveToFourtyNine>ValueHere</ThirtyFiveToFourtyNine>
<FiftyToSixtyFour>ValueHere</FiftyToSixtyFour>
<SixtyFiveAndAbove>ValueHere</SixtyFiveAndAbove>
<AgeUnknown>ValueHere</AgeUnknown>
<Female>ValueHere</Female>
<Male>ValueHere</Male>
<GenderUnknown>ValueHere</GenderUnknown>
</KeywordDemographic>
</KeywordDemographics>
</KeywordDemographicResult>
</KeywordDemographicResult>
</GetKeywordDemographicsResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<GetKeywordDemographicsResponse> GetKeywordDemographicsAsync(
IList<string> keywords,
string language,
string publisherCountry,
IList<string> device)
{
var request = new GetKeywordDemographicsRequest
{
Keywords = keywords,
Language = language,
PublisherCountry = publisherCountry,
Device = device
};
return (await AdInsightService.CallAsync((s, r) => s.GetKeywordDemographicsAsync(r), request));
}
static GetKeywordDemographicsResponse getKeywordDemographics(
ArrayOfstring keywords,
java.lang.String language,
java.lang.String publisherCountry,
ArrayOfstring device) throws RemoteException, Exception
{
GetKeywordDemographicsRequest request = new GetKeywordDemographicsRequest();
request.setKeywords(keywords);
request.setLanguage(language);
request.setPublisherCountry(publisherCountry);
request.setDevice(device);
return AdInsightService.getService().getKeywordDemographics(request);
}
static function GetKeywordDemographics(
$keywords,
$language,
$publisherCountry,
$device)
{
$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];
$request = new GetKeywordDemographicsRequest();
$request->Keywords = $keywords;
$request->Language = $language;
$request->PublisherCountry = $publisherCountry;
$request->Device = $device;
return $GLOBALS['AdInsightProxy']->GetService()->GetKeywordDemographics($request);
}
response=adinsight_service.GetKeywordDemographics(
Keywords=Keywords,
Language=Language,
PublisherCountry=PublisherCountry,
Device=Device)
ข้อกําหนด
บริการ: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13