การดําเนินการบริการ GetRecommendations - ข้อมูลเชิงลึกของโฆษณา
ค้นหาคําแนะนําของคุณ
ร้องขอองค์ประกอบ
วัตถุ GetRecommendationsRequest กําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
องค์ประกอบส่วนหัวของคําขอ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
สาย อักขระ |
CustomerAccountId | ตัวระบุบัญชีโฆษณาที่เป็นเจ้าของหรือเชื่อมโยงกับเอนทิตีในคําขอ องค์ประกอบส่วนหัวนี้ต้องมีค่าเดียวกันกับองค์ประกอบเนื้อความ AccountId เมื่อต้องการทั้งสองอย่าง องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ |
สาย อักขระ |
CustomerId | ตัวระบุบัญชีผู้จัดการ (ลูกค้า) ที่ผู้ใช้กําลังเข้าถึงหรือดําเนินการ ผู้ใช้สามารถเข้าถึงบัญชีผู้จัดการได้หลายบัญชี องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ |
สาย อักขระ |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
สาย อักขระ |
รหัส ผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
ชื่อ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
องค์ประกอบการตอบสนอง
วัตถุ GetRecommendationsResponse กําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
คำ แนะ นำ | อาร์เรย์ของวัตถุ Recommendation สามารถส่งกลับข้อมูลในรายการได้สูงสุด 2,000 รายการ |
อาร์เรย์คําแนะนํา |
องค์ประกอบส่วนหัวการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
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">GetRecommendations</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>
<GetRecommendationsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
<CampaignId i:nil="false">ValueHere</CampaignId>
<AdGroupId i:nil="false">ValueHere</AdGroupId>
<RecommendationType i:nil="false">ValueHere</RecommendationType>
</GetRecommendationsRequest>
</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>
<GetRecommendationsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
<Recommendations d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<Recommendation d4p1:type="-- derived type specified here with the appropriate prefix --">
<AccountId>ValueHere</AccountId>
<AdGroupId d4p1:nil="false">ValueHere</AdGroupId>
<CampaignId d4p1:nil="false">ValueHere</CampaignId>
<CurrentClicks>ValueHere</CurrentClicks>
<CurrentConversions>ValueHere</CurrentConversions>
<CurrentCost>ValueHere</CurrentCost>
<CurrentImpressions>ValueHere</CurrentImpressions>
<EstimatedIncreaseInClicks>ValueHere</EstimatedIncreaseInClicks>
<EstimatedIncreaseInConversions>ValueHere</EstimatedIncreaseInConversions>
<EstimatedIncreaseInCost>ValueHere</EstimatedIncreaseInCost>
<EstimatedIncreaseInImpressions>ValueHere</EstimatedIncreaseInImpressions>
<RecommendationHash d4p1:nil="false">ValueHere</RecommendationHash>
<RecommendationId d4p1:nil="false">ValueHere</RecommendationId>
<RecommendationType d4p1:nil="false">ValueHere</RecommendationType>
<!--This field is applicable if the derived type attribute is set to ResponsiveSearchAdsRecommendation-->
<SuggestedAd d4p1:nil="false">
<Descriptions d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:string>ValueHere</a1:string>
</Descriptions>
<FinalUrl d4p1:nil="false">ValueHere</FinalUrl>
<Headlines d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:string>ValueHere</a1:string>
</Headlines>
<Path1 d4p1:nil="false">ValueHere</Path1>
<Path2 d4p1:nil="false">ValueHere</Path2>
</SuggestedAd>
</Recommendation>
</Recommendations>
</GetRecommendationsResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<GetRecommendationsResponse> GetRecommendationsAsync(
long? campaignId,
long? adGroupId,
string recommendationType)
{
var request = new GetRecommendationsRequest
{
CampaignId = campaignId,
AdGroupId = adGroupId,
RecommendationType = recommendationType
};
return (await AdInsightService.CallAsync((s, r) => s.GetRecommendationsAsync(r), request));
}
static GetRecommendationsResponse getRecommendations(
java.lang.Long campaignId,
java.lang.Long adGroupId,
java.lang.String recommendationType) throws RemoteException, Exception
{
GetRecommendationsRequest request = new GetRecommendationsRequest();
request.setCampaignId(campaignId);
request.setAdGroupId(adGroupId);
request.setRecommendationType(recommendationType);
return AdInsightService.getService().getRecommendations(request);
}
static function GetRecommendations(
$campaignId,
$adGroupId,
$recommendationType)
{
$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];
$request = new GetRecommendationsRequest();
$request->CampaignId = $campaignId;
$request->AdGroupId = $adGroupId;
$request->RecommendationType = $recommendationType;
return $GLOBALS['AdInsightProxy']->GetService()->GetRecommendations($request);
}
response=adinsight_service.GetRecommendations(
CampaignId=CampaignId,
AdGroupId=AdGroupId,
RecommendationType=RecommendationType)
ข้อกําหนด
บริการ: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13