In Market Audience Record – Bulk

Artikel
12/21/2023

Definiert eine marktinterne Zielgruppe, die in einer Massendatei heruntergeladen werden kann.

Hinweis

Dieses Feature ist in AD, AR, verfügbar. AT, AU, AW, BD, BE, BG, BN, BO, BR, BS, CA, CH, CL, CO, CR, CY, CZ, DE, DK, DM, DO, EC, EE, ES, FI, FJ, FR, GF, GR, GT, GU, GY, HN, HR, HT, HU, ID, IE, IN, IT, KY, LI, LK, LT, LU, LV, MC, MN, MQ, MS, MT, MV, MX, MY, NC, NL, NO, NP, NZ, PA, PE, PF, PG, PH, PL, PR, PT, PY, RO, SE, SG, SI, SK, SM, SV, TH, TT, UK, US, UY, VA, VE und VN.

Hinweis

Massenuploads werden nicht unterstützt. Sie können eine marktinterne Zielgruppe nicht mithilfe der Bing Ads-API hinzufügen, aktualisieren oder löschen. Abgesehen davon können Sie marktinterne Zielgruppenzuordnungen und -ausschlüsse hinzufügen und löschen. Bing Ads-API gibt immer alle derzeit aktiven Zielgruppen im Markt zurück. Der Dienst gibt weder gelöschte Zielgruppen im Markt noch Deltadownloads zurück, um zu sehen, was sich geändert hat. Die über Bing Ads API zurückgegebenen Zielgruppen im Markt sind eine Vereinigung aller verfügbaren Zielgruppen im Markt in allen Märkten, z. B. AU, CA, DE, FR, UK und USA. Die Größe des Zielgruppennetzwerks und die Größe der Zielgruppensuche sind eine Summe von Listengrößen in allen unterstützten Märkten für eine bestimmte Marktzielgruppe im entsprechenden Netzwerk. Die Bing Ads-API stellt keine Details der Listengrößen pro Markt bereit. Beispielsweise kann die marktinterne Zielgruppengröße "Werbung und Marketing" im Suchnetzwerk über die Bing Ads-API als 17070879 (17,1 Millionen) zurückgegeben werden. Die In der Microsoft Advertising-Webanwendung angezeigte Aufschlüsselung nach Markt kann wie folgt sein: 2,88 Millionen in den USA; 474K in AU; 13,7 Millionen in Großbritannien.
Sie sollten keine Abhängigkeiten von den Sandbox-Zielgruppen im Markt nehmen. Einige Zielgruppen im Markt sind in der Sandbox verfügbar, aber nicht in der Produktion. Die Eigenschaftswerte der Marktzielgruppe können sich auch zwischen Sandbox und Produktion unterscheiden, z. B. der Name und die Größe der Zielgruppe.

Tipp

Eine Übersicht und weitere Informationen zu Zielgruppen finden Sie im technischen Leitfaden zu Zielgruppen-APIs .

Sie können alle In Market Audience-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von InMarketAudiences in die Serviceanforderung DownloadCampaignsByAccountIds oder DownloadCampaignsByCampaignIds einschließen. Darüber hinaus muss die Downloadanforderung den EntityData-Bereich enthalten. Weitere Informationen zum Massendienst, einschließlich bewährter Methoden, finden Sie unter Massendownload und -upload.

Im Folgenden wird ein Massen-CSV-Beispieldownload für die Zielgruppe im Markt gezeigt.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
In Market Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,In Market Audience Description,30,Account,In Market Audience,Search;DynamicSearchAds;Shopping;Audience

Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager zum Herunterladen des BulkInMarketAudience-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zum Analysieren der einzelnen Felder in der Massendatei zu schreiben.

// Map properties in the Bulk file to the BulkInMarketAudience
var bulkInMarketAudience = new BulkInMarketAudience
{
    // Map properties in the Bulk file to the 
    // InMarketAudience object of the Campaign Management service.
    InMarketAudience = new InMarketAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "In Market Audience Description",
        // 'Id' column header in the Bulk file
        Id = InMarketAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "In Market Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

Für einen In Market Audience-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.

Zielgruppe
Größe des Zielgruppennetzwerks
Größe der Zielgruppensuche
Beschreibung
Id
Mitgliedschaftsdauer
Änderungszeit
Übergeordnete ID
Scope
Status
Unterstützte Kampagnentypen