Operação do Serviço GetAudienceFullEstimation – Ad Insight

Artigo
07/16/2024

Obtém a estimativa completa do público.

Elementos do Pedido

O objeto GetAudienceFullEstimationRequest define os elementos do corpo e do cabeçalho do pedido de operação do serviço. Os elementos têm de estar na mesma ordem mostrada no Pedido SOAP.

Nota

Salvo indicação em contrário abaixo, todos os elementos do pedido são necessários.

Elementos do Corpo do Pedido

Elemento	Descrição	Tipo de Dados
Idade	A seleção de alvos etários. Os valores possíveis são: EighteenToTwentyFour, TwentyFiveToThirtyFour, ThirtyFiveToFourtyNine, FiftyToSixtyFour, SixtyFiveAndAbove, Unknown. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	SelectionOfAgeEnum
Audiência	A seleção da segmentação de audiências. Os tipos de audiência suportados são: Audiências personalizadas, Listas combinadas, Listas de correspondência de clientes, Listas de remarketing dinâmicos, audiências no mercado, Listas de remarketing e Audiências semelhantes. Os valores armazenados na seleção referem-se a IDs de segmento. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	SelectionOflong
Licitação	O valor de definição da oferta pretendido. Se definida como nula, a oferta sugerida é utilizada para efetuar estimativas. Adicionar: Opcional Atualização: Opcional	decimal
CampaignBiddingStrategy	Indica a estratégia de licitação pretendida para a resposta de estimativa. Os valores suportados são: 5: EnhancedCPC, 12: ManualCP. Adicionar: Opcional. O valor predefinido é Manual. Atualização: Opcional	int
CampaignSubType	Indique o tipo de anúncio pretendido para a resposta de estimativa. Os valores suportados são: 0: StaticAds, 1: FeedBasedAds, 2: DynamicFeedBasedAds. Adicionar:* Opcional. O valor predefinido é StaticAds. Atualização: Opcional	int
Empresa	A empresa de filtragem de perfis do LinkedIn. Os valores armazenados na seleção referem-se a IDs de segmento. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	SelectionOflong
Moeda	A moeda de DailyBudget e Bid. Se for nulo, será utilizada a moeda da definição de conta. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	Moeda
DailyBudget	O valor do orçamento da campanha diária. Se definido como nulo, o orçamento sugerido é utilizado para efetuar estimativas. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	decimal
Feed	Respeite este parâmetro apenas quando CampaignSubType for FeedBasedAds ou DynamicFeedBasedAds. Especifica o tráfego de feed pretendido para contar como estimativa. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	Feed
Género	O sexo a atingir. Os valores possíveis são: Masculino, Feminino, Desconhecido. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	SelectionOfGenderEnum
Indústria	A indústria da segmentação de perfis do LinkedIn. Os valores armazenados na seleção referem-se a IDs de segmento. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	SelectionOflong
JobFunction	A função job (Função de trabalho) A indústria de filtragem de perfis do LinkedIn. Os valores armazenados na seleção referem-se a IDs de segmento. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	SelectionOflong
Localização	A seleção de destino de localização. Os valores armazenados na seleção referem-se aos IDs de localização. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	SelectionOflong
RadiusTargets	Representa a área geográfica pretendida em termos de quilómetros/quilómetros. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	Matriz RadiusTarget

Elementos do Cabeçalho do Pedido

Elemento	Descrição	Tipo de Dados
AuthenticationToken	O token de acesso OAuth que representa as credenciais de um utilizador que tem permissões para contas do Microsoft Advertising. Para obter mais informações, veja Authentication with OAuth (Autenticação com OAuth).	cadeia
CustomerAccountId	O identificador da conta de anúncio que detém ou está associada às entidades no pedido. Este elemento de cabeçalho tem de ter o mesmo valor que o elemento do corpo AccountId quando ambos são necessários. Este elemento é necessário para a maioria das operações de serviço e, como melhor prática, deve sempre defini-lo. Para obter mais informações, veja Obter a Sua Conta e IDs de Cliente.	cadeia
CustomerId	O identificador da conta de gestor (cliente) a partir da qual o utilizador está a aceder ou a operar. Um utilizador pode ter acesso a várias contas de gestor. Este elemento é necessário para a maioria das operações de serviço e, como melhor prática, deve sempre defini-lo. Para obter mais informações, veja Obter a Sua Conta e IDs de Cliente.	cadeia
DeveloperToken	O token de programador utilizado para aceder à API de Anúncios do Bing. Para obter mais informações, veja Obter um Token de Programador.	cadeia
Palavra-passe	Este elemento está reservado para utilização interna e será removido de uma versão futura da API. Tem de utilizar o elemento AuthenticationToken para definir credenciais de utilizador.	cadeia
Nome de Utilizador	Este elemento está reservado para utilização interna e será removido de uma versão futura da API. Tem de utilizar o elemento AuthenticationToken para definir credenciais de utilizador.	cadeia

Elementos de Resposta

O objeto GetAudienceFullEstimationResponse define os elementos do corpo e do cabeçalho da resposta da operação do serviço. Os elementos são devolvidos pela mesma ordem mostrada no SOAP de Resposta.

Elementos do Corpo da Resposta

Elemento	Descrição	Tipo de Dados
Moeda	A moeda de DailyBudget e Bid. Se for nulo, será utilizada a moeda da definição de conta. Adicionar: Opcional. O valor predefinido é nulo. Atualização: Opcional	Moeda
EstAudienceSize	A estimativa mensal atinge a contagem de utilizadores com resultados arredondados. Apenas saída.	RangeResultOfDecimalRoundedResult
Esclique	Contagem de utilizadores estimada mensalmente com o resultado do intervalo. Apenas saída.	RangeResultOfDecimalRoundedResult
EstCostPerEvent	Indica o custo estimado por evento. O campo que significa varia com o campo de pedido CampaignBiddingStrategy . Apenas saída. EnhancedCPC: CPC ManualCPM: CPM	RangeResultOfDecimalRoundedResult
EstCTR	Taxa de cliques (CTR) estimada com o resultado do intervalo. Apenas saída.	RangeResultOfdouble
EstImpression	Impressão estimada mensal com o resultado do intervalo. Apenas saída.	RangeResultOfDecimalRoundedResult
EstReachAudienceSize	Contagem de utilizadores estimada mensalmente com o resultado do intervalo. Apenas saída.	DecimalRoundedResult
EstReachImpression	Impressão estimada mensal com o resultado do intervalo. Apenas saída.	DecimalRoundedResult
EstSpend	Gastos estimados mensais com o resultado do intervalo. Apenas saída.	RangeResultOfDecimalRoundedResult
EventsLostToBid	Indica a contagem de perdas de eventos devido a uma oferta de entrada insuficiente. O tipo perdido do evento varia com o campo de pedido CampaignBiddingStrategy . Apenas saída. EnhancedCPC: clique em ManualCPM: Impressão	int
EventsLostToBudget	Indica a contagem de perdas de eventos devido a orçamento de entrada insuficiente. O tipo perdido do evento varia com o campo de pedido CampaignBiddingStrategy . Apenas saída. EnhancedCPC: clique em ManualCPM: Impressão	int
SuggestedBid	Valor de licitação sugerido sob a segmentação atual. Apenas saída.	decimal
SugestãoBudget	Valor orçamental diário sugerido sob a segmentação e oferta atuais. Apenas saída.	decimal

Elementos do Cabeçalho de Resposta

Elemento	Descrição	Tipo de Dados
TrackingId	O identificador da entrada de registo que contém os detalhes da chamada à API.	cadeia

Pedir SOAP

Este modelo foi gerado por uma ferramenta para mostrar a ordem dos elementos do corpo e do cabeçalho do pedido SOAP. Para tipos suportados que pode utilizar com esta operação de serviço, veja a referência Request Body Elements (Elementos do Corpo do Pedido ) acima.

<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">GetAudienceFullEstimation</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>
    <GetAudienceFullEstimationRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <Age i:nil="false">
        <Includes i:nil="false">
          <AgeEnum>ValueHere</AgeEnum>
        </Includes>
        <Excludes i:nil="false">
          <AgeEnum>ValueHere</AgeEnum>
        </Excludes>
      </Age>
      <Gender i:nil="false">
        <Includes i:nil="false">
          <GenderEnum>ValueHere</GenderEnum>
        </Includes>
        <Excludes i:nil="false">
          <GenderEnum>ValueHere</GenderEnum>
        </Excludes>
      </Gender>
      <Audience i:nil="false">
        <Includes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Includes>
        <Excludes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Excludes>
      </Audience>
      <Company i:nil="false">
        <Includes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Includes>
        <Excludes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Excludes>
      </Company>
      <Industry i:nil="false">
        <Includes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Includes>
        <Excludes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Excludes>
      </Industry>
      <JobFunction i:nil="false">
        <Includes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Includes>
        <Excludes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Excludes>
      </JobFunction>
      <Location i:nil="false">
        <Includes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Includes>
        <Excludes i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </Excludes>
      </Location>
      <RadiusTargets i:nil="false">
        <RadiusTarget>
          <Radius>ValueHere</Radius>
          <RadiusUnit>ValueHere</RadiusUnit>
          <CenterLatitude>ValueHere</CenterLatitude>
          <CenterLongitude>ValueHere</CenterLongitude>
        </RadiusTarget>
      </RadiusTargets>
      <CampaignBiddingStrategy i:nil="false">ValueHere</CampaignBiddingStrategy>
      <CampaignSubType i:nil="false">ValueHere</CampaignSubType>
      <Feed i:nil="false">
        <StoreId i:nil="false">ValueHere</StoreId>
        <FeedId i:nil="false">ValueHere</FeedId>
        <FeedType i:nil="false">ValueHere</FeedType>
      </Feed>
      <DailyBudget i:nil="false">ValueHere</DailyBudget>
      <Bid i:nil="false">ValueHere</Bid>
      <Currency i:nil="false">ValueHere</Currency>
    </GetAudienceFullEstimationRequest>
  </s:Body>
</s:Envelope>

Soap de Resposta

Este modelo foi gerado por uma ferramenta para mostrar a ordem dos elementos do corpo e do cabeçalho para a resposta 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>
    <GetAudienceFullEstimationResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <EstImpression d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <High d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </High>
        <Low d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </Low>
      </EstImpression>
      <EstAudienceSize d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <High d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </High>
        <Low d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </Low>
      </EstAudienceSize>
      <EstClick d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <High d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </High>
        <Low d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </Low>
      </EstClick>
      <EstSpend d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <High d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </High>
        <Low d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </Low>
      </EstSpend>
      <EstCostPerEvent d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <High d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </High>
        <Low d4p1:nil="false">
          <Value d4p1:nil="false">ValueHere</Value>
          <Unit d4p1:nil="false">ValueHere</Unit>
        </Low>
      </EstCostPerEvent>
      <EstCTR d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <High>ValueHere</High>
        <Low>ValueHere</Low>
      </EstCTR>
      <SuggestedBid d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</SuggestedBid>
      <SuggestedBudget d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</SuggestedBudget>
      <EventsLostToBid d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</EventsLostToBid>
      <EventsLostToBudget d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</EventsLostToBudget>
      <EstReachAudienceSize d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <Value d4p1:nil="false">ValueHere</Value>
        <Unit d4p1:nil="false">ValueHere</Unit>
      </EstReachAudienceSize>
      <EstReachImpression d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <Value d4p1:nil="false">ValueHere</Value>
        <Unit d4p1:nil="false">ValueHere</Unit>
      </EstReachImpression>
      <Currency d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</Currency>
    </GetAudienceFullEstimationResponse>
  </s:Body>
</s:Envelope>

Sintaxe de Código

A sintaxe de exemplo pode ser utilizada com os SDKs de Anúncios do Bing. Veja Exemplos de Código da API de Anúncios do Bing para obter mais exemplos.

public async Task<GetAudienceFullEstimationResponse> GetAudienceFullEstimationAsync(
	SelectionOfAgeEnum age,
	SelectionOfGenderEnum gender,
	SelectionOflong audience,
	SelectionOflong company,
	SelectionOflong industry,
	SelectionOflong jobFunction,
	SelectionOflong location,
	IList<RadiusTarget> radiusTargets,
	int? campaignBiddingStrategy,
	int? campaignSubType,
	Feed feed,
	decimal? dailyBudget,
	decimal? bid,
	Currency? currency)
{
	var request = new GetAudienceFullEstimationRequest
	{
		Age = age,
		Gender = gender,
		Audience = audience,
		Company = company,
		Industry = industry,
		JobFunction = jobFunction,
		Location = location,
		RadiusTargets = radiusTargets,
		CampaignBiddingStrategy = campaignBiddingStrategy,
		CampaignSubType = campaignSubType,
		Feed = feed,
		DailyBudget = dailyBudget,
		Bid = bid,
		Currency = currency
	};

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

static GetAudienceFullEstimationResponse getAudienceFullEstimation(
	SelectionOfAgeEnum age,
	SelectionOfGenderEnum gender,
	SelectionOflong audience,
	SelectionOflong company,
	SelectionOflong industry,
	SelectionOflong jobFunction,
	SelectionOflong location,
	ArrayOfRadiusTarget radiusTargets,
	int campaignBiddingStrategy,
	int campaignSubType,
	Feed feed,
	decimal dailyBudget,
	decimal bid,
	Currency currency) throws RemoteException, Exception
{
	GetAudienceFullEstimationRequest request = new GetAudienceFullEstimationRequest();

	request.setAge(age);
	request.setGender(gender);
	request.setAudience(audience);
	request.setCompany(company);
	request.setIndustry(industry);
	request.setJobFunction(jobFunction);
	request.setLocation(location);
	request.setRadiusTargets(radiusTargets);
	request.setCampaignBiddingStrategy(campaignBiddingStrategy);
	request.setCampaignSubType(campaignSubType);
	request.setFeed(feed);
	request.setDailyBudget(dailyBudget);
	request.setBid(bid);
	request.setCurrency(currency);

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

static function GetAudienceFullEstimation(
	$age,
	$gender,
	$audience,
	$company,
	$industry,
	$jobFunction,
	$location,
	$radiusTargets,
	$campaignBiddingStrategy,
	$campaignSubType,
	$feed,
	$dailyBudget,
	$bid,
	$currency)
{

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

	$request = new GetAudienceFullEstimationRequest();

	$request->Age = $age;
	$request->Gender = $gender;
	$request->Audience = $audience;
	$request->Company = $company;
	$request->Industry = $industry;
	$request->JobFunction = $jobFunction;
	$request->Location = $location;
	$request->RadiusTargets = $radiusTargets;
	$request->CampaignBiddingStrategy = $campaignBiddingStrategy;
	$request->CampaignSubType = $campaignSubType;
	$request->Feed = $feed;
	$request->DailyBudget = $dailyBudget;
	$request->Bid = $bid;
	$request->Currency = $currency;

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

response=adinsight_service.GetAudienceFullEstimation(
	Age=Age,
	Gender=Gender,
	Audience=Audience,
	Company=Company,
	Industry=Industry,
	JobFunction=JobFunction,
	Location=Location,
	RadiusTargets=RadiusTargets,
	CampaignBiddingStrategy=CampaignBiddingStrategy,
	CampaignSubType=CampaignSubType,
	Feed=Feed,
	DailyBudget=DailyBudget,
	Bid=Bid,
	Currency=Currency)

Requisitos

Serviço: AdInsightService.svc v13
Espaço de nomes: https://bingads.microsoft.com/AdInsight/v13

Partilhar via